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

# Custom agents

> Build an agent tailored to your team's specific workflow, with the skills, tools, and instructions you define.

Custom agents are AI agents your team builds from scratch. When the default agent doesn't quite fit your workflow, a custom agent gives you a specialist that's built exactly for it. A Space can have **multiple custom agents**. Your team tags any of them with `@` in the same conversation, and each one responds from its own specialization.

## When to build a custom agent

Good candidates for a custom agent:

* A recurring workflow that needs a dedicated AI teammate (marketing, sales, finance, legal, support)
* A team with a specific domain and its own set of tools
* A process that needs consistent instructions, tools, and behavior across Spaces
* A client-facing role with specific tone and context constraints

## What you define

When you create a custom agent, you configure:

| Setting          | What it does                                                                                                                                   |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**         | How your team tags it (`@[name]`) in conversations                                                                                             |
| **Role**         | What this agent specializes in, displayed to team members                                                                                      |
| **Instructions** | Standing guidance that shapes how the agent behaves                                                                                            |
| **Artifacts**    | Documents, tables, and other reference material the agent uses as context                                                                      |
| **Connections**  | Per-agent access to specific apps. Choose from 500+ integrations across productivity, developer tools, CRM, communication, analytics, and more |
| **Permissions**  | What actions the agent can take, and what requires approval                                                                                    |
| **Spaces**       | Which Spaces this agent is available in                                                                                                        |

## Default agent vs. custom agents

|                    | Default agent                           | Custom agents              |
| ------------------ | --------------------------------------- | -------------------------- |
| **Setup**          | Available by default                    | You configure from scratch |
| **Specialization** | General purpose                         | Any domain or workflow     |
| **Instructions**   | Default behavior, overridable per Space | You define from the start  |
| **Flexibility**    | High, customizable per Space            | Maximum, full control      |

## How to create a custom agent

See [Create an agent](/agents/create-an-agent) for step-by-step instructions.

## Managing custom agents

Workspace admins can create, edit, and archive custom agents. Members can see which custom agents are available in their Spaces.

## Related

* [Create an agent](/agents/create-an-agent)
* [Agent permissions](/agents/agent-permissions)
* [Agent instructions](/agents/agent-instructions)


## Related topics

- [The default agent](/docs/agents/default-agent.md)
- [Create an agent](/docs/agents/create-an-agent.md)
- [Agent instructions](/docs/agents/agent-instructions.md)
- [Agent permissions](/docs/agents/agent-permissions.md)
- [FAQ](/docs/help/faq.md)