Your first agent

From an empty draft to an agent that answers a search, in about ten minutes with one LLM key.

1. Create a draft

Sign in as a developer, open Agents › Drafts and create a new draft. Give it a name and a title. The name identifies the agent in the account; users see the title.

2. Draft it with AI

Select your LLM profile under Used profiles. Describe the agent to Draft with AI, for example:

• Write a simple agent that forwards the user's query to the LLM.
• A tool-calling agent that fetches a customer's orders from our orders API.
• An agent that asks for a city, then answers questions about it.

Comments in the draft mark what is left for you to fill in. An llm command names a prompt; the prompt's text is written under Prompts, next to the definition. See Draft with AI.

3. Validate it

Enter a validation query such as What is the capital of France, in one word? and validate. The draft is checked and then run against that query. The trace shows each command, what it was called with, and what it returned. A draft must validate before it can be published.

4. Publish and describe it

Publish the draft. Describing the agent is a separate step: open the published agent and write its description, for example Answers general knowledge questions in a sentence or two. Submitting the description indexes the agent; wait for indexing to finish.

5. Search

Switch to the search box and type a question. The agent matches, runs and streams its answer. Ask a follow-up; the conversation continues with the context of the first answer.

Next steps

• Agent definition explains the structure Draft with AI wrote.
• Agent editor and Draft with AI explain the editor and what the AI knows.