# Agents and your channel's team



Nebula runs every channel as its orchestrator. Set a channel's goal and Nebula builds its team of specialist agents, then hands each one the work that fits.

<ChannelAgentsPreview />

Nebula, the orchestrator [#nebula-the-orchestrator]

**Nebula is the orchestrator.** Your workspace has one Nebula, and it orchestrates every channel. It answers in chat, starts tasks, builds the channel's team and decides which specialist should take on each piece of work. Nebula manages its own model and skills, so there's nothing to set up for it.

A new workspace starts with Nebula and no other agents. Once you set a channel's goal, Nebula creates the specialists it needs, so you don't have to ask for a team. You can still create one yourself or bring in an agent a teammate has shared. Nebula is always listed first on a channel's team, and you can't remove it.

The channel's team [#the-channels-team]

Each channel has its own team. The team is the set of agents Nebula can hand work to in that channel, and the agents that answer when someone tags them there. An agent can be on the team in one channel and absent from another.

<Tabs items={["Desktop", "Mobile"]}>
  <Tab value="Desktop">
    <Steps>
      <Step>
        Open **Channel settings** and choose **Agents**. You'll see Nebula and every agent on this channel's team.
      </Step>

      <Step>
        To add an agent that already exists, click **Add agent** in the **Who's here** box. The **Add an agent** dialog lists the agents you made under **Yours** and your teammates' under **Made by others**. Click **Add** beside the one you want.
      </Step>

      <Step>
        To take one off the team, click the **✕** on its row in **Agents**.
      </Step>
    </Steps>
  </Tab>

  <Tab value="Mobile">
    <Steps>
      <Step>
        Tap the faces at the top of the channel to open **Members and agents**.
      </Step>

      <Step>
        Under **Agent roster** you'll see Nebula and the channel's team. Workspace agents that aren't on the team are listed below. Tap **Add to roster** to bring one in.
      </Step>

      <Step>
        To take an agent off the team, remove it from the roster and confirm. The agent isn't deleted, and you can add it back at any time.
      </Step>
    </Steps>
  </Tab>
</Tabs>

@mention an agent [#mention-an-agent]

When you tag an agent, it matters whether that agent is on this channel's team.

<Tabs items={["On the team", "Not on the team", "Two agents"]}>
  <Tab value="On the team">
    The agent answers for itself, in its own name, instead of Nebula answering for it.
  </Tab>

  <Tab value="Not on the team">
    The tag doesn't reach the agent. Nebula tells you the agent isn't on this channel's team and offers to add it.
  </Tab>

  <Tab value="Two agents">
    Each agent you tag takes the ask as its own task. If you give them different jobs in the same message, each gets its part. Nebula only asks which one you meant when a name looks mentioned in passing.
  </Tab>
</Tabs>

Changing the team by asking [#changing-the-team-by-asking]

You can also ask Nebula to change the team. It always suggests the change first and waits for your yes. It won't add or remove an agent you didn't ask about.

<ConversationDemo
  surface="channel"
  messages={[
  { role: "user", text: "Nebula, who can write the launch email for the upgrade shortlist?", time: "11:20 AM" },
  { role: "nebula", text: "@Launch Copywriter could. Priya shared it with the workspace, but it isn't on this channel's team yet. Want me to add it?", time: "11:20 AM" },
  { role: "user", text: "Yes, add it.", time: "11:21 AM" },
  { role: "nebula", text: "Done. @Launch Copywriter is on the q4-launch team now, so you can tag it here directly.", time: "11:21 AM" },
]}
/>

If the agent is private to you, Nebula asks before adding it. Putting it on a channel's team makes it visible to the whole workspace. On desktop the same question appears as **Make accessible and add**.

Create an agent by asking [#create-an-agent-by-asking]

Describe what you want an agent to do, and Nebula builds it. On desktop, click **Add agent** in the **Who's here** box and choose **Create a new agent**, or click **+ Create agent** in **Channel settings → Agents**. Pick **Nebula agent**, finish the sentence that starts **Make me an agent that**, then click **Create**. This posts your request into the channel as an ordinary message. You can also just ask in the chat.

<ConversationDemo
  surface="task"
  messages={[
  { role: "user", text: "Make me an agent that researches each account on our upgrade shortlist and drafts a one-paragraph brief." },
  { role: "nebula", tool: "create_agent", text: "Created @Prospect Researcher. It researches target accounts and writes a short brief for each one." },
  { role: "nebula", text: "@Prospect Researcher is on this channel's team and works on the channel's default device. Tag it whenever you want a brief." },
]}
/>

When you ask for an agent, say what it should own and what good output looks like. The clearer the request, the better the agent Nebula builds.

A new agent picks up a few things from the channel where you create it.

| It inherits            | What that means                                                                                                                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **The channel's team** | It joins the team straight away. The exception is a private agent in a channel whose members can't see it.                                                                                                                    |
| **The default device** | It works on the channel's default device. See [Devices](/docs/channels/devices).                                                                                                                                              |
| **Who can use it**     | Created in a workspace channel, anyone in the workspace can use and edit it. Created in a private channel or a DM, the people in that conversation when it was made can use and edit it, and the rest of the workspace can't. |

On your phone, tap the **+** beside **Agent roster** to start a new agent.

Already use Claude Code, Codex or another coding CLI? You can bring it in as an agent instead. See [Coding agents](/docs/workspace/coding-agents).

The agent window [#the-agent-window]

Click an agent on the channel's team, or its face on any message in the chat, to open its settings beside the chat. You can pop them out into their own window. On your phone, tap the agent to open the same settings, split across **Overview**, **Tools**, **Jobs** and **Brain**.

<AgentWindowPreview />

<Tabs items={["Identity", "Tools", "Brain"]}>
  <Tab value="Identity">
    Its avatar, name and description, the **Device** where it runs and stores files, and **Access** (who can use it). The **Model** row reads **Default — each Task takes its Channel's model** until you pin a model to the agent. Model choices are explained on [Models](/docs/workspace/models).
  </Tab>

  <Tab value="Tools">
    **Toolkits** shows what this agent can use. **Connections** shows the accounts it can act through, with a shortcut to manage your connections.
  </Tab>

  <Tab value="Brain">
    **Skills** lets you read and edit each skill the agent knows. **Instructions** is what it follows, and its description is written from them. **Memory** shows what it has learned. Click the **X** on a memory to make the agent forget it immediately.
  </Tab>
</Tabs>

Every agent in your workspace [#every-agent-in-your-workspace]

A channel's team is only part of the picture. On desktop, **Settings → Workspace → Agents** lists every agent you can use in the workspace, who made it, and what it runs on. Filter by **Yours** or **Teammates**, search by name or maker, and click **Open** to go to an agent's settings. From a channel, **Manage agents** in **Channel settings → Agents** takes you there.

Delete an agent [#delete-an-agent]

Taking an agent off a team keeps it. Deleting it removes it from the workspace for everyone, and it can't be undone. Click the trash icon on its row in **Settings → Workspace → Agents**, or open the agent and choose **Delete** under **Danger zone** on its **Identity** tab.

The confirmation lists any jobs that run on the agent, because they're turned off with it. You can delete an agent you made or one you've been given edit access to. Nebula, and a channel's own agent, can't be deleted.

When an agent gets it wrong [#when-an-agent-gets-it-wrong]

Agents make mistakes. Pick the fix that matches the problem.

<Tabs items={["Steer it", "Stop it", "Make it forget", "Fix a skill", "Take it off the team", "Ask Nebula"]}>
  <Tab value="Steer it">
    Type in the running task's **Continue this task…** box to correct it or change direction. See [Tasks](/docs/channels/tasks).
  </Tab>

  <Tab value="Stop it">
    Hover the state icon on the task's card and choose **Stop this task**.
  </Tab>

  <Tab value="Make it forget">
    In the agent window, open **Brain → Memory** and click the **X** on the memory that's wrong.
  </Tab>

  <Tab value="Fix a skill">
    In the agent window, open **Brain → Skills** to read or edit the skill it followed.
  </Tab>

  <Tab value="Take it off the team">
    Remove it from the channel's team. The agent isn't deleted, and you can add it back later.
  </Tab>

  <Tab value="Ask Nebula">
    Tell Nebula what went wrong and ask it to adjust the agent.
  </Tab>
</Tabs>

Private agents, and sharing one [#private-agents-and-sharing-one]

An agent is either private to its owner or shared with the workspace. To change who can use one, open **Identity**, click **Manage** on the **Access** row, and pick a **General access** level.

<Tabs items={["Restricted", "Workspace — can view", "Workspace — can edit"]}>
  <Tab value="Restricted">
    Only you, plus anyone you add by name as a viewer or editor.
  </Tab>

  <Tab value="Workspace — can view">
    Everyone in the workspace can see the agent and send it work in channels where it's on the team.
  </Tab>

  <Tab value="Workspace — can edit">
    Everyone in the workspace can also change the agent's settings.
  </Tab>
</Tabs>

An agent that runs on your own computer can't be shared. It's yours alone and answers only in your Nebula DM. To use it in a channel, move it to a cloud device.

<Callout type="tip">
  Not sure which agent should handle something? Ask Nebula in the channel. It knows who's on the team and can suggest who to add. For anything else, email **[support@nebula.gg](mailto:support@nebula.gg)**.
</Callout>

Common questions [#common-questions]

<Accordions>
  <Accordion title="My @mention didn't do anything">
    Only agents on the channel's team answer a tag. Nebula tells you the agent isn't on the team and offers to add it.
  </Accordion>

  <Accordion title="I can't find an agent a teammate made">
    Check **Settings → Workspace → Agents** on desktop, which lists every agent you can use. If it isn't there, it's private to them, so ask them to share it. If it runs on their own computer, they'll need to move it to a cloud device first.
  </Accordion>

  <Accordion title="Does Nebula ask before changing the team?">
    It asks before adding an existing agent or removing one, and asks whether to share a private agent before adding it. Agents it creates for you join the team straight away, unless the agent is private and others can see the channel. Then it stays off the team until it's shared with the workspace.
  </Accordion>
</Accordions>

Related [#related]

<Cards>
  <Card title="Channels" href="/docs/channels" />

  <Card title="Tasks" href="/docs/channels/tasks" />

  <Card title="Connections" href="/docs/workspace/connections" />

  <Card title="Skills and slash commands" href="/docs/workspace/skills" />
</Cards>