Skip to main content
The Agents section is the primary interface for managing your agent fleet. It connects to the Dashboard API for declared state and Bridge for live runtime status, giving you a unified view of every agent in the system.

Agent List

Navigate to /agents to see the full fleet. Each agent shows its deployment status badge, run count, and gateway assignments. Use the controls at the top of the page to:
  • Search by name, tag, skill, or capability
  • Filter by lifecycle stage (draft, active, archived) or deployment status
  • Switch views between card layout and compact list

Agent Card Contents

Name + EmojiStatus BadgeModelRun CountGatewayTier Color
Agents are visually grouped by tier — Operator (amber), Department (purple), Personal (green). Online agents show a breathing glow animation on their card border. Click any agent to open its detail page.

Agent Detail

The detail page (/agents/[id]) shows the full agent definition and operational state. Tabs organize the information:
TabWhat you see
OverviewCapabilities, skills, model binding, prompt configuration, governance constraints, recent activity
DeploymentsWhich gateways this agent is deployed to, deployment status (deploying/active/failed), history
RunsRecent workflow runs involving this agent, with status, cost, and duration
MemoryAgent workspace files (SOUL.md, MEMORY.md, etc.) with view/edit toggle
SessionsActive and recent sessions scoped to this agent

Deploy / Undeploy

Deploy an agent to one or more gateways directly from the detail page. The deployment panel shows:
  • Available gateways with health status
  • Deploy button to push the agent definition to a gateway
  • Deployment status tracking (deploying, active, failed) with timestamps
  • Undeploy to remove from a gateway without deleting the agent definition
Deployment changes take effect immediately. The agent becomes available for workflow step assignment on the target gateway as soon as the deployment status shows active. Browse curated agent templates from the gallery. Each template shows a preview of the agent’s configuration — capabilities, default model, skills, and governance constraints. One-click deploy creates the agent definition and deploys to your selected gateway. Templates are useful for bootstrapping common agent patterns (research agent, code reviewer, document analyst) without configuring from scratch.

Search and Filter

Find agents across the fleet using multiple dimensions:
FilterOptions
Text searchName, tag, skill, or capability
Lifecycle stageDraft, active, archived
Deployment statusDeployed, undeployed, failed
TierOperator, department, personal
GatewayFilter to agents on a specific gateway