Skip to main content

Agent Statuses

Every AI agent shows one of six statuses on the Agents screen and on its own page. An agent answers customers — and replies in the Playground — only while it is Running. For the start and stop workflows, see AI Agents.

The six statuses​

StatusColorMeaningWhat to do
StoppedBlueThe agent is not running; customers cannot talk to it. New agents are created in this status.Start agent to launch it.
StartingPurpleThe agent is launching.Wait for Running. If the agent stays stuck, use Force stop agent.
RunningGreenThe agent is live: it answers in its attached channels and in the Playground.Stop agent to take it offline.
StoppingPurpleThe agent is shutting down.Wait for Stopped.
ErrorRedThe agent failed to start or crashed while running.Force stop agent first — see below.
Creating—The agent is still being created.Wait; the status changes when creation finishes.

The action offered on an agent is always one of Start agent, Stop agent, or Force stop agent, depending on the current status — there is no separate restart action.

Where statuses appear​

  • In the Status column of the Agents table — use the column's filter icon to filter by one or more statuses.
  • On the agent's own page.
  • On channel connections, which use the same colors — see Supported Channels.

Recover from Error​

  1. Choose Force stop agent — the status resets to Stopped.
  2. Open the agent's logs (Show Logs) and check the Backend tab for the failure reason.
  3. Fix the cause the log points to.
  4. Choose Start agent and wait for Running.
tip

If the agent goes to Error immediately after a start, open Show Logs and read the Backend tab — startup failures are reported there. See AI Agents for working with agent logs.

Notes​

  • Saving an agent in Simple mode automatically restarts a running agent, so configuration changes take effect without a manual stop and start.
  • The agent's Playground menu item is available while the agent is Running.

Was this article helpful?