Run an agent
Open Agents in the AI Studio sidebar, pick an agent, describe the work, fill in the fields it asks for, and select Start a run.
- AI Studio
- Web
Verified on source code by content-lane-ai-studio. Next review by . Serving build 3abda6b56647, deployed .
Select Agents in the AI Studio sidebar, choose an agent, describe the work under Hand this off to an agent, complete the fields the agent asks for, then select Start a run.
An agent is a named automation your Account provides. Unlike a thread, it works on its own for as long as the job takes and reports back as a run. You cannot create an agent yourself; the list holds those made available to you.
Start a run
- Select Agents in the sidebar.
- Choose an agent from the picker in the composer.
- Describe the work in the box. Some agents replace the prompt with their own wording.
- Set the fields shown along the composer. These change with the agent: a model, files, a number, a repository, a branch.
- If the agent asks for more, select More and fill in the rest. Its tooltip reads This agent has more required fields to run.
- Select Start a run.
A confirmation reads Agent started successfully and the run appears under Agent Executions.
Point an agent at a repository
Where an agent takes a repository, type the owner and name, or the full GitHub address, into the repository field, then set the Branch. Agents that read code need this before they will start.
Where the runs go
A run does not appear in your thread list. It goes to Agent Executions on the same page, below the composer. See Follow an agent run.
Some agents open a thread of their own as they work. Those appear under the Agents tab of the Threads page, not under Primary.
If it did not work
- Agents is not in the sidebar: agents are limited to administrators and developers in your Account. Ask your Account administrator.
- No agents are available.: no agent has been made available to you yet. The page adds Refresh after an administrator grants access to an agent.
- Complete the highlighted field before you start.: fill in the fields marked under Input required:, then start again.
- Select a repository before you start.: set the repository field, then the branch.
- Unable to start this run.: try again. If it repeats, note the agent's name and contact Support.
Related pages
- Follow an agent run — Agent Executions on the Agents page lists every run. Open one to see its steps and outputs, stop it while it is going, or start it again.
- Attach a repository to a thread — Attach up to five GitHub repositories to a thread so the model reads their file listing and README as reference on every message.
- What your requests cost — The Plans page in the AI Studio sidebar shows what pays for your requests, which limits can stop them, and a history of what you have used.