> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agents (Inventory)

> Full agent inventory with tool counts and prompt metadata

Returns every agent in the inventory as an `AgentSummary`. Compared to [`/risk/agents`](https://docs.tracectrl.ai/api-reference/risk-agents), this endpoint also exposes `tool_call_counts`, `total_tool_calls`, and the raw `system_prompt`.

### Query Parameters

**service** `string`

Filter agents by service name.

### Response

Array of agent objects:

**agent\_id** `string`

Unique identifier

**name** `string`

Human-readable name

**framework** `string`

Detected framework

**role** `string`

Agent role/purpose

**model** `string`

LLM model in use

**tools\_observed** `string[]`

Tool names invoked by this agent

**tool\_call\_counts** `object`

Map of `tool_name` to invocation count

**total\_tool\_calls** `integer`

Sum of all tool calls

**system\_prompt** `string`

System prompt text (may be empty)

**system\_prompt\_hash** `string`

SHA-256 hash of the system prompt (first 16 hex chars)

**run\_count** `integer`

Number of distinct runs

**observation\_count** `integer`

Total spans observed

**maturity** `string`

`LEARNING` or `MATURE`

**first\_seen** `string`

ISO-8601 timestamp

**last\_seen** `string`

ISO-8601 timestamp


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.