`invarium_list_agents`

List all agents registered in your Invarium workspace. Shows each agent’s name, status, AQS score, scenario count, and when it was last tested.

When to Use

Call invarium_list_agents when you need a quick overview of all agents in your workspace. Common scenarios:

At the start of a session to see what agents are registered
To find the exact name of an agent before calling other tools
To compare AQS scores across agents and identify which ones need attention
After registering a new agent to confirm it appears in the list

This tool takes no parameters — it returns all agents in the authenticated workspace.

Parameters

This tool takes no parameters. Authentication is handled automatically via the INVARIUM_API_KEY environment variable.

invarium_list_agents

List all agents registered in your Invarium workspace. Shows each agent's name, status, AQS (Agent Quality Score), scenario count, and when the agent was last tested.

Returns

Formatted list of all agents with name, status, AQS score, scenario count, and last run timestamp.

Example

Your agents (3 total):

1. customer-support-agent
   Status: ACTIVE | AQS: 78/100 (↑ +5) | Scenarios: 12 | Last run: 2 hours ago

2. travel-booking-agent
   Status: ACTIVE | AQS: 65/100 | Scenarios: 8 | Last run: 1 day ago

3. data-analysis-agent
   Status: ACTIVE | AQS: — | Scenarios: 0 | No test runs yet

Response

The tool returns a numbered list of all agents in the workspace:

Your agents (3 total):

1. customer-support-agent
   Status: ACTIVE | AQS: 78/100 (↑ +5) | Scenarios: 12 | Last run: 2 hours ago

2. travel-booking-agent
   Status: ACTIVE | AQS: 65/100 | Scenarios: 8 | Last run: 1 day ago

3. data-analysis-agent
   Status: ACTIVE | AQS: — | Scenarios: 0 | No test runs yet

Per-Agent Fields

Field	Description
Name	The agent’s registered name, used as the identifier in all other tools.
Status	Current status: `ACTIVE`, `INACTIVE`, or `UNKNOWN`.
AQS	Agent Quality Score (0—100) with optional trend indicator (↑/↓). Shows `--` if no test runs have been completed.
Scenarios	Number of test scenarios generated for this agent.
Last run	Relative timestamp of the most recent test run (e.g., “2 hours ago”, “3 days ago”). Shows “No test runs yet” if no runs exist.

Empty State

If no agents have been registered yet, the tool returns:

No agents registered yet. Use invarium_upload_blueprint to register your first agent.

Examples

Basic Usage

List all agents in the workspace:

"List all my agents."

Finding an Agent Name

Use the list to find the exact name of an agent before calling other tools:

"List my agents, then show me details for customer-support-agent."

Identifying Agents That Need Attention

Review the AQS scores across all agents. Agents with low scores or downward trends should be prioritized for additional testing or blueprint improvements:

"List my agents and show me which ones have the lowest AQS scores."

Error Responses

Error	Cause	Fix
`Authentication failed: invalid API key`	Invalid or missing API key.	Verify your `INVARIUM_API_KEY`. Run `invarium_connect` first.
`Failed to list agents: ...`	Backend API error or network issue.	Check your connection and try again.

See Error Codes for the full error reference.

Was this page helpful?

invarium_get_agent invarium_delete_agent