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

# Chat Agents

> Reusable AI personas with custom instructions and scoped access.

A **Chat Agent** is a named persona you can pick from the AI chat. Each agent bundles:

* Custom **instructions** that shape how it responds.
* A default **model** (set to **Auto** to defer to the workspace default, or pick any model in the catalog).
* A default **strategy** and **mode**.
* A list of **scoped objects** and **scoped pages** the agent should focus on.
* A list of **allowed tools** (leave empty to allow all).
* A **web access** toggle that controls whether the agent can search and browse the public internet.

## Why use a chat agent

A workspace-wide system prompt sets the floor. An agent layers a focused persona on top: a "Product Agent" scoped to the product object answers product questions in the right voice; a "Support Agent" scoped to tickets and the conversation inbox keeps support replies on-brand. The same workspace can host many agents without colliding.

## Selecting an agent in chat

Pick an agent from the dropdown in the chat header. The choice is remembered for the life of that conversation, so the agent stays consistent as you go. Start a new conversation or switch agents to begin fresh.

## Scope (focus areas)

When an agent has scoped objects or scoped pages, it's told to **prefer** those areas when answering, while still being free to reference other workspace data when the request clearly calls for it.

<Note>
  Scope is a **soft focus hint**, not a hard restriction. The agent is told to *prefer* the listed objects and pages, but it can still reach other workspace data the user can already see when the request requires it. The agent can never surface anything the user couldn't already access. Your existing permissions always apply.
</Note>

## See also

* [Instructions](/ai/chat-agents/instructions)
* [Scoping](/ai/chat-agents/scoping)
* [Tool gating](/ai/chat-agents/tools)
* [Models & Providers](/ai/models/overview)


## Related topics

- [Chat Routing](/comms/chat/routing.md)
- [Instructions](/ai/chat-agents/instructions.md)
- [Change Log](/product/updates.md)
- [Rules & Skills](/ai/rules-and-skills.md)
- [Tools](/ai/tools/overview.md)