Skip to main content
The Agent Registry builds a topology of your AI system automatically from your traces. Every agent that has run at least one trace appears here with the tools it called, the models it used, and any sub-agents it delegated to.
Agent registry showing agent nodes, tools, and delegation connections

​
What the registry shows

Each agent entry shows:
FieldDetails
Agent nameThe identifier set in withAgent() or wrapADKAgent()
Last seenTimestamp of the most recent trace for this agent
Total tracesCount of all recorded runs
Tools usedList of tool names called by this agent
ModelsAll model identifiers this agent has used
Sub-agentsAgents this agent has delegated to

​
Agent topology

The topology view renders agents as nodes connected by delegation edges. An edge from Agent A to Agent B means A called B as a sub-agent in at least one trace. Edge thickness scales with delegation frequency. Use the topology to identify:
  • Coordinator agents that delegate to many specialists
  • Agents with unexpectedly high tool diversity (potential scope creep)
  • Isolated agents with no connections (standalone tools)

​
Tool usage

Each agent’s tool panel lists every tool the agent called, with call counts and failure rates. A tool with a failure rate above 10% is highlighted in the reliability column.

​
Filtering

Filter agents by:
  • Last active — see which agents are actively running vs dormant
  • Model — find all agents using a specific model
  • Environment — separate production from staging agents

​
Registering agents in code

Agents appear in the registry automatically when you use the SDK’s agent context: 
import { zespan, withAgent } from "@zespan/sdk";

await withAgent({ name: "research-agent", model: "gpt-4o" }, async () => {
  // all LLM calls and tool invocations inside are attributed to this agent
  const result = await openai.chat.completions.create({ ... });
});
For Google ADK agents, use wrapADKAgent() or instrumentADK() — see Google ADK integration.

​
Next steps

  • Agents — per-agent performance dashboard
  • Traces — drill into individual agent runs