---
title: Run an agent
type: how-to
section: ai-studio
summary: 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.
applies_to:
  clients: [web]
sources:
  - evolve-front-end/app/[lng]/studio/(pages)/agents/page.tsx
  - evolve-front-end/components/agents/hero-composer/**
  - evolve-front-end/components/agents/agent-executions-tab-fast-path.tsx
  - evolve-front-end/app/i18n/locales/en/dsl-agents.json
verified:
  at: 2026-09-04
  env: code
  by: content-lane-ai-studio
ttl_days: 45
related: [ai-studio/follow-an-agent-run, ai-studio/attach-a-repository, ai-studio/cost-and-usage]
---

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

1. Select **Agents** in the sidebar.
2. Choose an agent from the picker in the composer.
3. Describe the work in the box. Some agents replace the prompt with their own wording.
4. Set the fields shown along the composer. These change with the agent: a model, files, a number, a repository, a branch.
5. If the agent asks for more, select **More** and fill in the rest. Its tooltip reads **This agent has more required fields to run**.
6. 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](/help/ai-studio/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.