> ## Documentation Index
> Fetch the complete documentation index at: https://docs.circuit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents overview

> What agents are, the available domain templates, and how to create your first agent.

An **agent** is an AI-powered agent that answers questions using your workspace's indexed documents. Each agent is configured with a domain, a set of tools, and a reference scope that determines which indexes it can search.

## Agent domains

When you create an agent, you choose a **domain** that provides a starting template. Each domain comes with pre-configured tools, prompts, and behaviors suited to a particular use case.

| Domain               | Best for                | Description                                                                           |
| -------------------- | ----------------------- | ------------------------------------------------------------------------------------- |
| **General purpose**  | Broad knowledge queries | A flexible starting point for agents that need to answer a wide range of questions.   |
| **Field enablement** | Field technicians       | Optimized for troubleshooting, installation procedures, and technical specifications. |

These are two common examples. Circuit offers many additional domain templates tailored to specific use cases such as customer service, RFP response, sales enablement, and more.

The domain is a starting point. You can customize any aspect of the agent after creation. See [agent configuration](/admin/agent-configuration) for details.

## Creating an agent

<Steps>
  <Step title="Navigate to agents">
    From your Circuit dashboard, go to the agents section.
  </Step>

  <Step title="Create a new agent">
    Click create and provide:

    * **Name**: a clear name that describes the agent's purpose (e.g., "Field Support Agent" or "Product FAQ Agent")
    * **Description**: optional, helps users understand what the agent is for
  </Step>

  <Step title="Choose a domain">
    Select the domain template that best fits your use case. This sets the initial tools, behavior, and prompt structure.
  </Step>

  <Step title="Set the reference scope">
    Choose which indexes the agent can search. You can select one or many indexes. The agent only has access to the documents in these indexes.
  </Step>

  <Step title="Review and save">
    Review the default configuration and save. You can start chatting with the agent immediately to test it.
  </Step>
</Steps>

## What agents can do

Depending on configuration, agents have access to different **tools**. Some common examples:

* **Search**: query indexes to find relevant content
* **Read**: read full document sections for deeper context
* **Write**: generate structured content (reports, summaries, draft responses)
* **Web fetch**: retrieve content from external web pages (if enabled)

Beyond these core tools, Circuit provides a wide range of special-purpose tools that vary by domain and use case. The specific tools available depend on the domain template and any customizations you make.

## Personal vs workspace agents

* **Personal agents** are created by individual users and only visible to them
* **Workspace agents** belong to the workspace and can be shared with users and groups

For most team use cases, you'll want workspace agents so they can be shared and managed centrally.

## Next steps

<CardGroup cols={2}>
  <Card title="Agent configuration" icon="sliders" href="/admin/agent-configuration">
    Fine-tune tools, reference scope, skills, and actions.
  </Card>

  <Card title="Agent sharing" icon="share" href="/admin/agent-sharing">
    Share agents with users and groups, and manage roles.
  </Card>
</CardGroup>