Create agents
You create an agent by asking for one in a channel where an agent answers. The agent handles the setup without a form, config edit, or restart.
What to say
Section titled “What to say”Describe the job. The agent that answers picks the name, the prompt, and the other settings.
Make me an agent called Researcher. It finds sources for my questions and reports in short bullet points.Add an editor agent that tightens my drafts without changing what I mean. Start by asking me what I am working on.Create Notes, an agent that keeps my reading notes, and put its channel in a category for reading.Only the owner and admins can create agents. The agent that answers can be any agent: it creates the new one in its own name.
What agent_create takes
Section titled “What agent_create takes”The agent calls agent_create with these fields filled in from your request:
| Field | What it is |
|---|---|
name |
The permanent name: 1 to 32 lowercase letters, digits, and dashes. It is also the channel name. It cannot contain discord or clyde, and no agent or group may share it, archived ones included. |
display_name |
The name shown on its messages, 1 to 32 characters, in any language. |
prompt |
Its role: the job, the sources, the limits, and how it reports. Up to 4,000 characters. |
class |
Optional. Its character class, such as knight or bard; the default follows its role. See Status and avatars. |
color |
Optional. Its color palette: azure, gules, vert, purpure, amber, sable, teal, or rose. |
task |
Its opening task, up to 4,000 characters, written so it makes sense on its own. |
category |
Optional. Where its channel goes: Agents, which is the default, or Agents-<suffix>. A missing category is created. |
long_running |
Optional. true turns on long-running mode for its conversations before its opening task starts, so its turns go past the usual 10-minute limit by themselves (up to the host’s cap, four hours by default). Only the owner’s request may set it. |
skills |
Optional. Names of skills it carries, from the skill list. Only offered while the skills addon is on; see Skills and memory. |
What the new agent gets
Section titled “What the new agent gets”- A channel with its name, under the category you asked for.
- An avatar. A character the bot composes from its class and color; the default follows its role.
- Its prompt, which comes after the shared prompt every agent starts with.
- An opening task. It starts working in its channel at once, introducing itself in one or two sentences before beginning the task.
- Its skills, when you named some.
Change an agent later
Section titled “Change an agent later”Ask for the change in plain words:
Make Researcher answer in two sentences at most.Switch Editor to the high thinking level.The agent calls agent_update to change these four fields:
| Field | What it does |
|---|---|
display_name |
The name shown on its messages. A group the agent is in updates its channel topic. |
prompt |
The whole new prompt. It replaces the old one, so the agent should read the current prompt first. |
model |
A model written <provider>/<model>, or default to follow the assistant’s model. A model the host cannot run is refused with the list that it can. |
thinking |
off, minimal, low, medium, high, xhigh, or default. The default is auto: a judge picks the level for each turn from your message. |
A change applies from the agent’s next turn, and its conversation stays.
Two things have their own tools:
- Look:
agent_avatarchanges its class, color, or single parts. - Skills:
agent_skillsadds and removes the skills it carries.
Use agent_list to see every agent and group with their channels, and agent_get to read one agent’s prompt, model, thinking level, skills, and look.
Seed agents
Section titled “Seed agents”The agents in agents.ts are created on the first start, the way agent_create would.
Later starts keep the stored agents as they are; edit them in Discord.
See Configure.