Skip to main content

System Diagram

Use the Agent System Map to understand your AI workforce, review operational health, and move from the complete fleet into one agent's configuration without leaving the page.

Each altitude and agent-detail tab has its own URL. Browser Back and Forward move through the map in the same order you navigated it, and a copied URL opens the same agent, tab, tool, mailbox, or execution directly.

Open the Agent System Map​

Navigate to Governance > Live Operations > System Diagram.

The page opens at the fleet altitude. Chief of Staff and the AI Platform & Security Officer (AIPSO) occupy the top agent tier. Personal Assistants, Subject Matter Experts, and standard agents are grouped beneath them.

Each agent card shows:

  • Agent name and type
  • Active or paused status
  • Authoritative supervisor
  • Number of monitored mailboxes
  • Number of assigned tools

The visual hierarchy explains the operating model. The Reports to label on each card remains the source of truth for supervision.

Review fleet health​

The summary row reports:

  • Total and active agents
  • Agents that monitor at least one mailbox
  • Execution runs and LLM cost for the selected date range
  • Agents that need attention

Select Last 7 days, Last 30 days, or Last 90 days to change the execution and cost window. If execution telemetry is unavailable or you do not have permission to read it, the map displays Not available. It does not estimate values.

Use the fleet controls to:

  1. Search by agent or supervisor.
  2. Filter by agent type.
  3. Show active agents or agents that need attention.
  4. Collapse the operational workforce when you only need the top-level structure.

The Fleet signals panel summarizes workforce composition, mailbox coverage, and the live update connection.

Inspect an agent​

Select any agent card to move to the agent altitude. The page keeps the current date range and shows:

  • Execution count, LLM cost, and run success
  • Assigned tools and mailboxes
  • Supervisor, lifecycle, autonomy, and model settings
  • Responsibilities and runtime relationships

Use the agent selector to move directly to another agent. Select Back to Supervisor Map to return to the full fleet. The in-page Back control follows browser history after an in-page navigation. When a detail URL is opened directly, it returns to that detail's parent altitude instead.

Overview​

The Overview tab shows the agent's role, lifecycle, status, work type, supervisor, model, and description. Platform Administrators can open the complete agent configuration from this tab.

Executions​

The Executions tab lists runs attributed to the selected agent during the current date range. Select a run to inspect its duration, cost, token count, LLM calls, tool calls, and completion reason. You can also open the complete execution record.

Tools & access​

The Tools & access tab lists tools currently granted to the agent. Select a tool to inspect the assignment, category, status, impact classification, and assignment-level JSON configuration.

Users with agents:write permission can:

  • Save assignment configuration
  • Revoke the agent's access to the tool
  • Open the full tool picker to manage several assignments

Revoking a tool preserves existing execution history.

Mailboxes​

The Mailboxes tab lists every monitored mailbox assigned to the agent. Select a mailbox to review:

  • Address, type, and active status
  • Auto-reply setting
  • Hourly and daily limits
  • Subscription count, renewal time, and expiration

Users with mailbox write permission can open the mailbox configuration page.

Governance​

The Governance tab summarizes the agent's supervisor, autonomy level, model override, lifecycle, and daily and monthly usage-cost limits. Users with agents:write permission can open the full policy editor.

Platform Administrators can also pause or resume a deployed agent from the agent header. Agents that are still interviewing or configured but not yet deployed do not show this control. Pausing an agent stops new work but leaves mailbox assignments visible so the map can show the interrupted processing path.

Change history​

The Change history tab displays redacted configuration mutations when the tenant has the AIPSO audit surface enabled and the user has aipso:view permission. Secret values are masked or omitted.

Live updates​

The page receives agent, mailbox, subscription, and tool changes through the live update connection. An agent that is currently processing pulses in the fleet map.

If live updates disconnect, the current inventory remains visible. Reload the page after the connection recovers if a recent configuration change does not appear.

Troubleshooting​

Metrics show Not available​

Confirm that your role includes executions:read. The page also shows Not available when execution telemetry cannot be reached. Configuration and relationship data remain usable.

An agent appears under the wrong group​

The group is derived from the agent's configured kind: Chief of Staff, AIPSO, Personal Assistant, SME, or standard agent. Review the agent configuration if its kind is incorrect.

The supervisor label is unexpected​

The map uses the supervisor identity stored on the agent. Personal Assistants fall back to their assigned employee, while Chief of Staff and AIPSO fall back to the business owner.

A mailbox has no active processing path​

Review the assigned agent and mailbox status. Resume the agent or reassign the mailbox from Workforce > Mailboxes.