# Software factory: Many agents in your app

Give your app more than one AI agent on the AI Agents page: create, edit, order, and pick the default agent.

---

Your app can have up to 20 AI agents that talk with the people who use it. Each one has its own name, instructions, and tools. People pick the agent they want in your app's chat.

Open your project and go to **AI Agents**.

## Two kinds of agents

The page has two sections:

- **AI Engineer.** There is one per project. It builds and changes your app and files tickets. People who use your app never talk to it.
- **Agents in your app.** These talk with the people who use your app. They all share the app's model, knowledge, and connections. Open **Model, knowledge and connections** to change those for all of them.

## Create an agent

1. Under **Agents in your app**, select **Create agent**.
2. Give it a name and a short description. People see the description when they pick an agent.
3. Optional: add an icon (an emoji) and a short label for the agent picker.
4. Write its instructions. Leave them empty to use the app's main instructions.
5. Choose its tools: all of the app's tools, or only the ones you pick.
6. Select **Create agent**.

The note beside the button shows how many agents you have. At 20 agents the button turns off. Delete an agent to add another.

## Change an agent

Select an agent to open it. You can change every field above, and:

- **People can pick this agent.** Turn it off to hide the agent from the picker. Its past conversations stay.
- **Make default.** The default agent answers when someone opens your app's chat, and when a link, an embed, or a channel names no agent.
- **Delete agent.** Its past conversations stay and continue with the default agent.

Use the up and down arrows in the list to change the order people see in the picker.

## Rules

- You can't turn off or delete the default agent. Make another agent the default first.
- Your app always keeps at least one agent.
- If someone else changed the agents in another tab, the page shows what the server said and refreshes the list.

## Chat in your app

**Chat in your app** says which agent answers first. When two or more agents are on, people can switch between them in the chat.

## An app with one agent

Nothing changes until you create a second agent. Your app keeps using its one default agent, with the app's main instructions and all of its tools.