Create your own agents

Last published : Nov 09, 2026
This guide shows you how to build, import, export, and delete your own agents.
An agent is the assistant with its own instructions for one kind of work, such as writing release notes. An agent can also have its own model and permissions. Agents you create appear under My agents when you choose an agent for a chat.
Related information
Use Knowledge Worker Agent

Open the agent builder

Do one of the following:
  • At the bottom of the sidebar, select Settings (the gear icon), then Agents.
  • Under the message box, select the current agent or preset, then Build a new agent.
The Agent builder lists the agents you created.

Create an agent

  1. Select Create agent.
  2. On the Simple tab, fill in the following:
    • Name: shown in the agent list, for example Release notes writer. It also becomes the agent's file name.
    • Description: when the assistant should use this agent. To have the description rewritten for you, select Improve description.
    • Instructions: who the agent is, how it behaves, and what it should and shouldn't do. To have the instructions tidied up for you, select Polish with AI.
    • Model: which model the agent runs on. Leave Default (OpenCode chooses) to use your workspace's default.
  3. Optional: on the Advanced tab, set how the agent responds, for example Response variability and Maximum steps. You can also select Hide from the agent list or Turn off this agent.
  4. Optional: on the Permissions tab, set what the agent may do. For each capability, choose Allow, Ask first, or Deny. Default for every capability sets them all at once.
  5. Select Save agent.

Use an agent

Under the message box, select the current agent or preset, then select your agent under My agents. For more information, see Choose a model or agent.

Change an agent

  1. In the Agent builder, select the agent, or select Edit on its card.
  2. Make your changes.
  3. Select Save agent.

Import an agent

You can import an agent from a Markdown (.md) agent file, for example one a colleague exported.
  1. In the Agent builder, select Import agent, and choose the file.
    A preview shows the agent's name, description, model, and the permissions it asks for. If the file names things the agent depends on, the preview lists them. Those aren't included in the file, so make sure your workspace has them.
  2. Optional: change the Name.
  3. Select Import agent.

Export an agent

On the agent's card, select Export. The agent's file downloads, ready to share or import elsewhere.

Delete an agent

On the agent's card, select Delete. When asked Delete?, select Yes.

Agents provided by IT

Agents your administrator assigns are listed under Provided by IT when you choose an agent. They don't appear in the Agent builder, and you can't change them there.