Chat

Selecting an agent

Before Chat can run a conversation, it needs to know which agent to use. You set this through the selector bar — a project dropdown and an agent dropdown at the top of the page. Once you've made a selection, Chat remembers it and restores it the next time you open the page.

The selector bar

The selector bar appears at the top of Chat whenever no agent is currently scoped. It has two controls:

Project — choose the project your agent belongs to. Projects group agents together and are the scope for API keys. If you only have one project, select it and move on.

Agent — once a project is selected, this dropdown lists all the agents in that project. Choose the one you want to chat with.

As soon as both are selected and the connection is ready, the bar hides itself. A small banner at the bottom of the composer confirms which agent is active and displays the model it's running.

Session restore

Chat remembers the last project and agent you had selected. When you return to Chat — after navigating away or reloading the page — it restores that selection automatically, without showing the selector bar. The previous session loads and you can continue right where you left off.

If the remembered agent no longer exists (it was deleted or the project was removed), the bar reappears so you can pick a new one.

Switching agents mid-session

You can switch to a different agent at any time without losing your current session. There are two ways to do it:

Using the selector bar — click anywhere in the agent name area in the composer banner to show the selector bar again, pick a different agent (or project), and the session resets to the new agent.

Using the /agent slash command — type /agent set <name> in the composer and press Enter. Chat finds the agent by name (a partial match works), loads the right project if needed, and switches to it without you opening the bar. You can list all available agents first with /agent on its own.

Cross-project switching

/agent set <name> works across projects. If the agent you name belongs to a different project than the current one, Chat loads the correct project automatically. You don't need to select the project manually first.

Clearing the active agent

To start fresh — no project, no agent, bar visible — type /agent unset. This clears the selection and shows the selector bar so you can pick a new agent from scratch.

Status indicators

While the bar is visible, small status badges on the right side tell you what's happening:

BadgeMeaning
Preparing key…Chat is setting up the API credentials for this project — usually takes a second
Key errorThe API key could not be resolved; try selecting the project again
Project / AgentA named badge confirming which agent is scoped and ready