Skip to main content
GET
/
api
/
v1
/
topology
/
agents
/
{agent_id}
Get Agent Detail
curl --request GET \
  --url http://localhost:8000/api/v1/topology/agents/{agent_id}
{
  "agent_id": "researcher-agent",
  "name": "Researcher",
  "framework": "langchain",
  "role": "Research and analysis",
  "model": "gpt-4o",
  "tools_observed": ["search_documents", "fetch_url", "write_file"],
  "system_prompt_hash": "a1b2c3d4e5f67890",
  "run_count": 15,
  "observation_count": 234,
  "maturity": "MATURE",
  "first_seen": "2026-03-15T10:30:00Z",
  "last_seen": "2026-03-17T14:22:00Z"
}

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.

​
Path Parameters

​
agent_id
string
required
The unique agent identifier (e.g., researcher-agent).

​
Response

​
agent_id
string
Unique identifier
​
name
string
Human-readable name
​
framework
string
Detected framework
​
role
string
Agent role/purpose
​
model
string
LLM model used
​
tools_observed
array
List of tool names this agent has used
​
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 (< 10 observations) or MATURE (>= 10)
​
first_seen
string
ISO-8601 timestamp
​
last_seen
string
ISO-8601 timestamp
{
  "agent_id": "researcher-agent",
  "name": "Researcher",
  "framework": "langchain",
  "role": "Research and analysis",
  "model": "gpt-4o",
  "tools_observed": ["search_documents", "fetch_url", "write_file"],
  "system_prompt_hash": "a1b2c3d4e5f67890",
  "run_count": 15,
  "observation_count": 234,
  "maturity": "MATURE",
  "first_seen": "2026-03-15T10:30:00Z",
  "last_seen": "2026-03-17T14:22:00Z"
}