Creating agents
An agent bundles fixed instructions, knowledge from brains, files and conversation starters for a recurring task. This page shows how to create an agent, test it and change it later.
Last checked on 28 September 2026
On this page
What an agent is
An agent is a prepared chat for a task that comes up again and again: writing quotes, answering customer enquiries, drafting minutes. You define once how it works, what it knows and which templates it has to hand. From then on, everyone allowed to use it starts a chat with exactly these settings in one click.
In Custodos, recurring workflows are built as agents. An agent always works in the chat: it replies when someone writes to it and never starts on its own.
Creating an agent
- 1
Open agents
Click Agents in the sidebar, then New agent. To start from a ready-made draft, choose the Templates tab instead, see Templates. - 2
Describe it in your own words
On the Create tab, write what the agent should do. The fields fill themselves as you go. - 3
Check the fields
On the Configure tab you see and change each field individually. - 4
Test
In the Preview you try the draft out in a real chat. - 5
Save
Click Create. Until then nothing is saved and the editor shows Unsaved. An existing agent is saved with Save.
Describing the agent in a conversation
The Create tab is a short chat about the agent itself. You describe the task, who it is for, the tone and the rules. Custodos replies and enters matching values in the fields; the fields that changed are listed under Updated: …. Further messages ask for changes.
This conversation saves nothing. It runs on your workspace's default model and is charged in credits like a chat message. The transcript only lasts while the editor is open; the filled-in fields become part of the agent when you save.
The fields under Configure
Name and Instructions are required, every other field is optional.
| Field | What it sets | Limit |
|---|---|---|
| Name | What the agent is called in the list and in the chat. | 80 characters |
| Choose icon | The icon next to the name. | fixed selection |
| Description | One sentence on what the agent does. Shown in the list. | 300 characters |
| Instructions | How the agent works: process, tone, output format, rules and exceptions. A counter shows how much space is used. | 40,000 characters |
| Conversation starters | Suggestions in the empty chat. One click sends them. | 4 starters of up to 200 characters each |
| Model | The model for new chats. Automatic uses the workspace's default model. A different one can still be chosen in the chat. | approved models only |
| Brains | Knowledge the agent searches when it needs to. | 20 brains |
| Files | Templates and forms that come with every chat with the agent. | 10 files, 20 MB each, 300,000 characters of text in total |
| Web search | Under Capabilities: whether the agent may look up current information on the web. | only if the workspace offers web search |
| Sharing | Who may see and use the agent. See Sharing agents. | new agents: Private (only me) |
Instructions, brain or file
The editor explains the split under Instructions or Brain?. The rule of thumb: the instructions describe how the agent works. A brain holds what it needs to know. Files are templates it fills in during any chat.
| Where | What belongs there | How the agent uses it |
|---|---|---|
| Instructions | Process, tone, output format, the steps and their exceptions. | Reads them in full with every message. |
| Brains | Larger sets of documents: price lists, policies, contracts, FAQs. | Searches them when needed instead of reading everything. Spread many documents across several brains by topic, so each search stays focused. |
| Files | Templates and forms: PDF, Word, Excel, PowerPoint, text and images. | Has them to hand in every chat. The model can edit Word and Excel files directly. |
Brains, model and web search
You can only pick brains you are allowed to read yourself. Once an agent has brains, only models that can search them can be selected; the editor points this out with With brains, only models that can search them.
Which models exist is set by the admins and depends on the processing region the workspace has chosen. The model picker shows what is available. The same applies to web search: if the workspace does not offer it, the switch does not appear and the agent does not search the web, even if a template intends it to.
More under Models and Web search.
The preview
The preview is a real chat with the unsaved draft. The same rules apply as later for everyone who uses the agent: data protection settings, brain permissions, files, tools. Messages in the preview are charged in credits like ordinary chat messages.
On wide screens the preview sits to the right of the editor and can be closed with Hide preview. On narrow screens it is a tab of its own. Start over begins a fresh test chat with the same draft. The preview does not appear in your chat history.
What happens when you save
Changes only reach other people once you save. From then on, depending on the field:
| Change | Applies from |
|---|---|
| Instructions | the next message in every chat with the agent, including running ones |
| Web search | the next message in every chat with the agent, including running ones |
| Model | the next newly started chat |
| Brains and Files | the next newly started chat |
Working with an agent
In the list under Agents, Start chat opens a chat with the agent. The empty chat shows the conversation starters; one click sends them. The agent's files sit ready in the message field like your own attachments. You see what the model receives and can remove a file before sending.
You can switch the model in the chat. If you have started a chat with the agent but not written anything yet, Start chat reopens that chat instead of creating a second one. If your workspace starts new chats in security mode, that applies to agent chats too.
Editing and deleting
Only the person who created the agent and the workspace admins can edit or delete it. Admins can only change agents they can see: a colleague's private agent stays hidden from them as well.
Delete agent removes the agent for good. Chats that were started with it are kept.
Read next
Still have a question? Write to us.
