Agent Action Graph

The Agent Action Graph is obs-unified's causal view of human and agent work. Traditional traces show execution order. The action graph adds the semantic "why": which browser action, cron job, agent run, LLM call, retrieval, or tool call caused the next step.

Use it when you need to answer:

• Which user action or background job started this agent run?
• Which model step chose a side-effecting tool?
• Which retrieval or prompt version influenced the answer?
• Which backend trace, log line, replay, AI cost, CPU profile, or eval case is connected to this action?

Identity model

The graph extends the normal interaction chain:

with action-level causality:

Browser-triggered agents create a fresh root_action_id while retaining the browser interaction_id. Background agents, cron jobs, and MCP hosts can also mint action roots when there is no browser interaction.

What becomes graph data

obs-unified projects these records into the action graph when explicit action fields are present or derivable:

• Native SDK agent runs and steps
• LLM calls, retrievals, tool calls, guardrails, and eval cases
• OpenInference-shaped spans
• OpenTelemetry GenAI spans
• OpenTelemetry MCP spans such as tools/call, resources/read, and prompts/get
• Backend traces, logs, profiles, and replay evidence sharing the same identity chain

Dashboard surface

In the dashboard, action graph pages are nested, bookmarkable routes:

#/actions/:actionId
#/agent-runs/:agentRunId
#/tool-calls/:toolCallId

Each page shows action metadata, upstream/downstream causes, connected telemetry, and graph tabs for the causal action tree, governance/auditing, and prompt diffs/evals.

The website screenshot pipeline now captures the route directly from the seeded Astronomy demo. The current public captures are:

• Agent Action Graph
• Interaction ID path
• Trace waterfall with Connected Rail
• Trace to CPU profile join point

Agent surface

The same graph is exposed to AI agents through the MCP server. An agent can start from a failing trace, follow connected signals to an action, inspect the action graph, then return with the relevant replay, log, AI cost, or profile evidence.

For implementation details in the GitHub repo, see the Agent Action Graph guide and the Action ID wire spec.