USER MANUAL · OPERATE

Topology

Visualize agent relationships, call chains, and data flows in an interactive graph.

/topology

Overview#

The Topology page renders an interactive graph of all agents in your workspace. Nodes represent agents; edges represent call relationships and data flows between them. It is a Web-only feature designed for visual exploration of your agent ecosystem.

Use the topology view to identify call chains, spot isolated agents, and understand how data flows across your agent network. Node details are available on click, showing the agent profile, recent activity, and connection summary.

Prerequisites#

Prerequisites

Multiple agents synced from at least one connector
Agent call or session data available (so relationships can be inferred)

Expected Results#

After agents are synced and have interaction data, the Topology page shows:

-Interactive graph with draggable nodes representing each agent
-Directional edges showing call relationships and data flow direction
-Node detail panel on click, showing agent profile, recent calls, and connection count

Web Operations#

The Topology page is a single interactive canvas with the following interaction patterns:

Graph Navigation

Pan by dragging the background. Zoom with scroll or pinch. Double-click to reset the view. Nodes can be dragged to rearrange the layout. The graph auto-layouts using a force-directed algorithm.

Node Details

Click any node to open a detail panel showing the agent name, health status, model, and a summary of inbound/outbound connections. Links to the full Agent detail page are provided.

Call Chains

Edges between nodes indicate A2A call relationships. Thicker edges represent higher call volume. Hover over an edge to see the call count and average latency. Dashed edges indicate inactive or historical connections.

FAQ#

Q: The graph shows no connections between agents.

A: Connections are inferred from A2A call data and session logs. If your agents have not communicated with each other yet, no edges will appear. Run some cross-agent workflows first, then revisit the topology view.

Q: Can I export the topology view?

A: Currently the topology view is interactive-only and does not support image or data export. You can take a browser screenshot for documentation purposes.

Q: What do the connection lines mean?

A: Solid lines represent active call relationships between agents. The arrow direction indicates the caller-to-callee flow. Thicker lines mean more calls. Dashed lines indicate historical connections where agents previously communicated but have no recent activity.