Quickstart

Before you start

Choose one job with a clear expected answer. Use a small, authoritative knowledge set and avoid adding a fleet until one agent works reliably.

Five steps

1. 1

   Choose a provider and model

   Add the provider key in Environment, then select a model suited to your privacy, latency, and quality needs.
2. 2

   Create knowledge

   Create a knowledge base, select an embedding model, and upload PDF, text, or Markdown files. Wait until each document is Indexed.
3. 3

   Create the agent

   Give it one job, precise boundaries, the knowledge and tools it may use, and a response format that matches its consumer.
4. 4

   Test in Playground

   Ask a normal question, an ambiguous question, and one it must refuse or escalate. Inspect sources and tool activity.
5. 5

   Deploy deliberately

   Enable deployment in the agent's settings only after tests pass. Create a scoped integration key when another application needs access.

Definition of done

• The agent answers the representative task from approved evidence.
• It says when evidence is missing or conflicting.
• Tool permissions match the job and no more.
• A run trace explains what happened.
• Structured output validates when another system consumes the response.