Managing Agents
Control the lifecycle, health, and resources of your Trinity agents through the UI, API, or MCP tools.
Start and Stop
Toggle an agent between Running and Stopped using the switch on the Dashboard, Agents page, or Agent Detail page. A loading spinner displays during state transitions.
RunningStateToggle.vue (supports size variants)POST /api/agents/{name}/start and POST /api/agents/{name}/stopstart_agent(name) and stop_agent(name)Rename
Click the pencil icon next to the agent name on the Agent Detail page to edit inline. Renaming is atomic: it updates the database, renames the Docker container, and broadcasts the change via WebSocket.
Restrictions: system agents cannot be renamed. Only owners and admins have permission to rename.
PUT /api/agents/{name}/rename with body {"new_name": "new-name"}rename_agent(name, new_name)Delete
Use the Delete button on the Agent Detail page. A confirmation dialog is required. Deletion cleans up the container, network, sharing records, schedules, activities, and event subscriptions.
DELETE /api/agents/{name}delete_agent(name)Health and Status
The agent header displays status (Running/Stopped), CPU and memory usage, network I/O, and uptime. Telemetry auto-refreshes every 10 seconds.
Fleet-wide monitoring is available at GET /api/monitoring/fleet-health. Health levels, from best to worst: healthy, degraded, unhealthy, critical, unknown.
get_agent_health(name), get_fleet_health(), trigger_health_check()Resource Allocation
Configure per-agent memory and CPU limits in the Config tab. Execution timeout is configurable per agent (range: 60–7200 seconds, default: 900 seconds / 15 minutes).
GET /api/agents/{name}/timeout and PUT /api/agents/{name}/timeoutListing
The Agents page shows horizontal row tiles with success rate bars. Filter by name, status, or tags. The Dashboard offers a network graph view and a timeline view.
GET /api/agents returns all agentslist_agents()For Agents
Agents can manage other agents programmatically through the MCP tools listed above. Common patterns include orchestrator agents that start and stop worker agents on demand, or monitoring agents that poll fleet health and trigger alerts when agents become degraded or unhealthy.