ATOM Documentation

← Back to App

Graph Data Diagnosis for Email Entity Type

Issue

After promoting the Email entity type, the graph view at https://brennan.atomagentos.com/graph?type=email shows no data.

Root Cause Analysis

The backfill sync likely:

  1. ✅ Created the EntityTypeDefinition for Email (the schema)
  2. ✅ Promoted it to active
  3. ❌ Did NOT create actual GraphNode records for the 1000 emails

Diagnostic Steps

Run this in your browser console at https://brennan.atomagentos.com:

// 1. Check the entity type
fetch('/api/v1/entity-types?is_active=true')
  .then(r => r.json())
  .then(data => {
    const emailType = data.entity_types.find(et => et.slug === 'email');
    console.log('Email Entity Type:', emailType);
  });

// 2. Check graph nodes for email type
fetch('/api/graph/nodes?type=email')
  .then(r => r.json())
  .then(data => {
    console.log('Graph nodes with type=email:', data);
    console.log('Count:', Array.isArray(data) ? data.length : (data.nodes?.length || 0));
  });

// 3. Check all graph nodes
fetch('/api/graph/nodes')
  .then(r => r.json())
  .then(data => {
    const nodes = Array.isArray(data) ? data : (data.nodes || []);
    console.log('Total graph nodes:', nodes.length);
    console.log('Unique types:', [...new Set(nodes.map(n => n.type))]);
  });

Expected Results

If the backfill only created the schema but not nodes:

  • ✅ Entity type exists and is active
  • ❌ Graph nodes query returns empty array

Solutions

Option 1: Trigger Graph Ingestion

The Outlook integration needs a separate ingestion pass to create GraphNode records. Check if there's an:

  • Ingestion endpoint: /api/integrations/outlook/ingest
  • Historical sync job that needs to be triggered
  • GraphRAG ingestion process

Option 2: Check Backfill Logs

Review the Outlook backfill logs to see if it reported ingesting emails to the graph:

fly logs -a atom-saas | grep -i "outlook\|email\|ingestion\|graph"

Option 3: Manual Trigger

There might be a manual trigger to sync emails to the graph. Check the Knowledge Graph settings page for:

  • "Sync to Graph" button
  • "Ingest Emails" action
  • "Refresh Data" option

Next Steps

  1. Run the diagnostic script above
  2. Share the results
  3. I'll help identify which ingestion process needs to be triggered