Skip to main content
The agent drafter writes an agent file with you. You describe the job, it drafts the file in the workbench’s pane, and you save it when it’s right.

​
Draft the agent

1

Open the workbench in agent mode

2

Describe the job

Say what the agent is for, what it should read and what it should produce. The drafter picks tools from your catalog and puts a first draft in the pane.
The workbench with agent_drafter active: the request and the drafter's question on the left, and the release_notes agent draft on the right with its description, model, tools, input, output and system prompt.

The agent drafter's first draft in the pane, with its question in the chat.

3

Answer its questions

The drafter asks what it can’t settle itself, including whether the agent is for conversation, plan steps, or both.
4

Draft any missing tools

When the agent needs a tool that doesn’t exist, the drafter offers to draft it. Say yes, and once you save the tool you’re back in the agent draft with the tool added.
The agent drafter in the workbench saying none of the tools can post to the changelog page and asking whether to draft one now, with the agent draft in the pane on the right.

The drafter offers to draft a tool the agent needs.

5

Save

Press Ctrl+S. graph writes the file to ./.graph/agents/<name>.yaml.

​
Run the agent

Agent file

Every field an agent file takes.

Talk to an agent

Use your agent in graph ask and graph chat.

Create a tool in the workbench

Draft a tool on its own with the tool drafter.

Customize a built-in agent

Change one of graph’s own agents.