List Agent Versions
agent_versionsThe versions ONE agent ran in a time window, on two dimensions that are
kept apart and must not be read as synonyms: agent is the agent
definition — prompt, tools, policy — as rius.main_agent.version stamps it,
and service is the build that ran it, as service.version stamps it. A
prompt edit ships without a deploy and a deploy without touching the agent,
so the two move independently. Each row carries its traces, failed traces,
failed rate and when it was first and last seen within the window.
This is the same read the Rius console's Agent page draws its Versions
figure from, and every row is ROOT-scoped like the registry fields, so a row's
numbers equal agent_traces_summary with
filters=[{"field": "agent_version" | "service_version", "op": "eq", "values": [version]}]. Use it to learn which two values to hand
compare_agent_versions, or to see when a version appeared. Rows are newest-seen
first within a dimension and capped at 50 per dimension; the totals count
past the cap.
agent: the exact agent name (required: versions are per agent). Read a name
off list_agents or off root_agent on list_agent_traces rather than
guessing one.
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).
hours: lookback window in hours (default 24), used for whichever of start/end
is not given.
start: optional absolute RFC3339 lower bound (e.g. "2026-08-01T00:00:00Z");
overrides the hours-derived value when given.
end: optional absolute RFC3339 upper bound; overrides the hours-derived value
when given.
instance: optional exact instance id, narrowing to one running copy of agent.
Example:
Which versions of planner ran this week?
{ "name": "agent_versions", "arguments": { "agent": "planner", "hours": 168 } }When did planner's new prompt version first show up?
{ "name": "agent_versions", "arguments": { "agent": "planner", "hours": 720 } }Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| agent | Yes | ||
| hours | No | ||
| start | No | ||
| instance | No | ||
| workspace | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |