List Agents
list_agentsList a workspace's agent instances with their live status — which agents exist, how many copies of each are running, and which copies are stale, gone or stopped. One row per instance, straight from the heartbeat store.
This is the same read the Rius console's Agents page makes, with the
server's own status words: running, ready, stale, gone, stopped.
The status is computed on the server from the last heartbeat; do not
re-derive it from last_seen_at. open_trace_count is the true number of
open traces and the running/ready signal; first_seen_at and stopped_at
appear when the core serves them, and a blank first_seen_at means the
start is unknown, not that it started now.
Every row here is a live instance; a trace-only agent (one that sends traces but no heartbeat) does not appear. If an agent you expect is missing, the reply says why that happens.
workspace: optional workspace id, name, or org-name/workspace-name when
the same name occurs in two of your orgs (defaults to your default;
use list_workspaces to discover them).
agent: optional exact agent name, to list only that agent's instances. The
server has no filter for it, so this narrows the reply here and
names the agents that do have instances when nothing matches.
Example:
Which of my agents are running right now?
{ "name": "list_agents", "arguments": {} }Are any copies of planner lost?
{ "name": "list_agents", "arguments": { "agent": "planner" } }Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | ||
| workspace | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |