Skip to content

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.

In the guide channel, a user asks for an agent that keeps reading notes. Guide answers that it made Notes in a new notes channel, with a prompt, an avatar, and a skill for saving links, and that it already started its first job.

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.

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.
  • 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.

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_avatar changes its class, color, or single parts.
  • Skills: agent_skills adds 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.

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.