System Diagram

Understand the visual system architecture and real-time updates on the Real-Time Usage page.

Overview

The System Diagram is an interactive visualization on the Real-Time Usage page that shows your Outermind system at a glance. It displays all major components—mailboxes, agents, tools, and LLM providers—along with their connections and real-time status.

Accessing the System Diagram

Navigate to Operations > Dashboard > System Diagram in the sidebar to view the system diagram.

Understanding the Diagram

Visual Layout

The diagram shows a flow from left to right:

Mailboxes → SuperAgent → Specialist Agents → Tools → LLM Providers

This represents how emails flow through your system:

1. Mailboxes receive incoming emails
2. SuperAgent routes to appropriate specialists
3. Specialist Agents process with assigned tools
4. LLM Providers power the AI reasoning

Component Types

Mailboxes (Left Side)

Each monitored mailbox appears as a node showing:

• Email address
• Display name
• Status indicator (active/inactive)
• Subscription status

Color coding:

• Green border - Active and receiving emails
• Gray border - Inactive or paused
• Red border - Subscription error

SuperAgent (Center-Left)

The routing agent that directs emails:

• Shows as a central hub
• Connects to all monitored mailboxes
• Routes to specialist agents

Specialist Agents (Center)

Your configured agents appear as nodes showing:

• Agent name
• Assigned model
• Status

Click an agent to see:

• Full configuration
• Assigned tools
• Recent execution stats

Tools (Center-Right)

Available tools appear grouped by type:

• Communication tools
• Search tools
• Lookup tools
• Calendar tools

Tool connections show which agents can use which tools.

LLM Providers (Right Side)

Configured AI providers showing:

• Provider name
• Provider type (Anthropic, OpenAI, Azure)
• Connection status

Color coding:

• Green - Healthy and connected
• Red - Connection error
• Yellow - Degraded performance

Connection Lines

Lines between components show relationships:

• Solid lines - Active connections
• Dashed lines - Inactive connections
• Animated lines - Real-time activity

Real-Time Updates

SignalR Integration

The diagram updates automatically using SignalR websockets:

• No page refresh needed
• Changes appear within seconds
• Activity is visualized in real-time

What Updates Automatically

Change	Visual Update
New mailbox added	Node appears
Agent created	Node appears with connections
Provider status change	Color updates
Email processed	Animation on path
Configuration change	Connections update

Activity Indicators

When emails are being processed:

• Animated pulses along connection lines
• Brief highlights on active components
• Counter increments on agents

Interacting with the Diagram

Hovering

Hover over any component to see:

• Quick summary info
• Status details
• Related statistics

Clicking

Click components for more details:

Mailbox click:

• Opens mailbox details panel
• Shows recent activity
• Quick link to manage

Agent click:

• Opens agent detail modal
• Shows configuration summary
• Recent execution stats
• Quick link to edit

Tool click:

• Shows tool description
• Lists agents using this tool
• Configuration status

Provider click:

• Connection status details
• Available models
• Quick link to manage

Zooming and Panning

For complex setups:

• Scroll to zoom in/out
• Drag to pan around
• Double-click to reset view

Agent Filtering

Use the Agent dropdown in the diagram header to filter the view:

• All Agents (default) - Shows the complete system diagram with all components
• Select specific agent - Shows only the selected agent and its connected components:
  • The agent node itself
  • The mailbox assigned to the agent
  • The subscription connected to that mailbox
  • All tools assigned to the agent
  • The LLM provider node

This filtering is useful when you want to:

• Focus on a single agent's configuration
• Verify an agent's tool assignments
• Troubleshoot issues with a specific agent
• Document a specific agent's setup

Note: Only tools that are assigned to at least one agent appear in the diagram. Unassigned tools are hidden to reduce clutter.

Reading System Health

Overall Health Indicators

At a glance, check:

• Are all mailboxes green? (Subscriptions active)
• Are providers green? (AI services connected)
• Are agents active? (Processing enabled)

Common Patterns

Healthy System:

• All mailboxes green with active subscriptions
• Agents connected to appropriate tools
• Providers showing green status
• Occasional activity animations

Warning Signs:

• Red mailbox nodes (subscription issues)
• Disconnected agents (no tool connections)
• Red provider nodes (API issues)
• No recent activity

Quick Diagnostics

Symptom	Likely Issue	Action
Mailbox red	Subscription expired	Renew subscription
Provider red	API key invalid	Check provider config
Agent disconnected	Tools not assigned	Edit agent, add tools
No activity	System paused	Check Account Settings

Using the Dashboard for Monitoring

Daily Check

Each day, briefly review:

1. All components showing expected status
2. No red indicators
3. Recent activity visible
4. No unexpected changes

After Configuration Changes

After making changes:

1. Return to dashboard
2. Verify changes reflected
3. Check connections are correct
4. Monitor for any issues

During Issues

When troubleshooting:

1. Check dashboard for obvious problems
2. Identify affected components
3. Follow connections to find root cause
4. Verify fixes show on dashboard

Component Details Modal

Agent Details

Clicking an agent opens a modal with:

Overview Tab:

• Name and description
• Model and temperature
• Status and creation date

Tools Tab:

• List of assigned tools
• Tool descriptions
• Usage statistics

Activity Tab:

• Recent executions
• Success/failure rate
• Average response time
• Token usage

Quick Actions:

• Edit agent
• View executions
• Toggle status

Mailbox Details

Clicking a mailbox shows:

• Email and display name
• Assigned agent
• Subscription status
• Recent email count
• Quick links to manage

Best Practices

Regular Monitoring

• Check dashboard daily for quick health overview
• Investigate any red indicators immediately
• Note patterns in activity levels

After Changes

• Always verify changes on dashboard
• Check connections are as expected
• Monitor for unexpected side effects

Documentation

• Screenshot dashboard for documentation
• Reference diagram when explaining system
• Use for onboarding new admins

Troubleshooting

Diagram Not Loading

Symptoms: Blank area where diagram should be

Solutions:

1. Refresh the page
2. Check browser console for errors
3. Verify API is accessible
4. Clear browser cache

Real-Time Updates Not Working

Symptoms: Changes not reflecting without refresh

Solutions:

1. Check SignalR connection
2. Verify websocket isn't blocked
3. Check for network issues
4. Refresh to reconnect

Components Missing

Symptoms: Expected components not showing

Solutions:

1. Verify components are configured
2. Check filter settings
3. Zoom out to see full diagram
4. Refresh data

Wrong Status Colors

Symptoms: Status doesn't match reality

Solutions:

1. Wait a moment for update
2. Refresh the page
3. Check component directly
4. Verify status in component's page

Related Topics

• Admin Console Overview
• Agents
• Monitored Mailboxes
• LLM Providers