T420 Agentic Workflow - Visual Flow Diagram

System Architecture Overview

┌─────────────────────────────────────────────────────────────────────────┐
│                         USER INTERFACE LAYER                            │
│                   (AgenticSupplyChainMatrix.tsx)                        │
│                                                                         │
│  ┌───────────────────────┬─────────────────────────────────────────┐  │
│  │   SOURCING PANEL      │      NEGOTIATION PANEL                  │  │
│  │   (Left 1/3)          │      (Right 2/3)                        │  │
│  │                       │                                         │  │
│  │  📋 PARKING           │  💬 Chat Interface                      │  │
│  │   • Supplier A ✓87    │  ┌────────────────────────────────┐    │  │
│  │   • Supplier B ⚠62    │  │ [AI] Initiating negotiation... │    │  │
│  │                       │  │ [Shepherd] Do you have...      │    │  │
│  │  ⚡ CHARGING          │  │ [Supplier] Yes, we can...      │    │  │
│  │   • Supplier C ✓91    │  │ 💡 [AI] Market rate: $180...   │    │  │
│  │                       │  └────────────────────────────────┘    │  │
│  │  🧹 CLEANING          │                                         │  │
│  │   • Supplier D ✓78    │  [Input] [Send] [Agree & Add]          │  │
│  └───────────────────────┴─────────────────────────────────────────┘  │
│                                                                         │
│  [Activity Log]                                                         │
│  🤖 Initializing agents... ✅ 12 suppliers verified...                 │
└─────────────────────────────────────────────────────────────────────────┘
                                    ↕
┌─────────────────────────────────────────────────────────────────────────┐
│                       ORCHESTRATION LAYER                               │
│                      (AgentOrchestrator.ts)                             │
│                                                                         │
│  ┌─────────────────────────────────────────────────────────────────┐  │
│  │  📊 Message Queue      📝 Agent Logs      🔄 State Management   │  │
│  │                                                                  │  │
│  │  • Routes messages between agents                               │  │
│  │  • Maintains conversation state                                 │  │
│  │  • Aggregates logs from all agents                             │  │
│  │  • Coordinates inter-agent communication                        │  │
│  └─────────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────────┘
                                    ↕
┌─────────────────────────────────────────────────────────────────────────┐
│                          AGENT SERVICE LAYER                            │
│                                                                         │
│  ┌────────────────┐  ┌────────────────┐  ┌────────────────┐           │
│  │   SOURCING     │  │   APPROVAL     │  │     FRAUD      │           │
│  │     AGENT      │  │     AGENT      │  │     AGENT      │           │
│  ├────────────────┤  ├────────────────┤  ├────────────────┤           │
│  │ • Discover     │  │ • Initiate     │  │ • Verify       │           │
│  │   suppliers    │  │   negotiations │  │   suppliers    │           │
│  │ • Score &      │  │ • AI           │  │ • Calculate    │           │
│  │   rank         │  │   suggestions  │  │   trust scores │           │
│  │ • Category     │  │ • Market       │  │ • Detect       │           │
│  │   prioritize   │  │   analysis     │  │   anomalies    │           │
│  │ • Generate     │  │ • Monitor      │  │ • Monitor      │           │
│  │   reasoning    │  │   messages     │  │   negotiations │           │
│  └────────────────┘  └────────────────┘  └────────────────┘           │
│                                                                         │
│  ┌────────────────┐                                                    │
│  │   SUPPLIER     │                                                    │
│  │     AGENT      │                                                    │
│  ├────────────────┤                                                    │
│  │ • Market       │                                                    │
│  │   intelligence │                                                    │
│  │ • Competitor   │                                                    │
│  │   analysis     │                                                    │
│  │ • Pricing      │                                                    │
│  │   recommendations                                                  │
│  │ • RFQ analysis │                                                    │
│  └────────────────┘                                                    │
└─────────────────────────────────────────────────────────────────────────┘
                                    ↕
┌─────────────────────────────────────────────────────────────────────────┐
│                           DATA LAYER                                    │
│                                                                         │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐    │
│  │  Supplier Data   │  │  Market Pricing  │  │  Trust Scores    │    │
│  │  (Scraped)       │  │  (Simulated)     │  │  (Calculated)    │    │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘    │
└─────────────────────────────────────────────────────────────────────────┘

Inter-Agent Communication Flow

SCENARIO: Shepherd selects parking supplier

1. USER ACTION: Click supplier card
   │
   ↓
2. SOURCING AGENT → ORCHESTRATOR
   │ "Supplier X selected"
   │ Match Score: 85%
   │
   ↓
3. ORCHESTRATOR → FRAUD AGENT
   │ "Verify supplier X"
   │
   ↓
4. FRAUD AGENT → ORCHESTRATOR
   │ Trust Score: 87/100
   │ Risk Level: LOW
   │ ✅ APPROVED
   │
   ↓
5. ORCHESTRATOR → APPROVAL AGENT
   │ "Initiate negotiation"
   │ Supplier: X, Trust: 87
   │
   ↓
6. APPROVAL AGENT → UI
   │ "Welcome message"
   │ "AI suggestions"
   │ "Market context"
   │
   ↓
7. USER ACTION: Send message
   │
   ↓
8. APPROVAL AGENT → FRAUD AGENT
   │ "Monitor message: 'Do you have...'"
   │
   ↓
9. FRAUD AGENT checks for scam keywords
   │ ✅ No threats detected
   │
   ↓
10. APPROVAL AGENT → UI
    │ Supplier response (simulated)
    │ AI analysis
    │
    ↓
11. USER ACTION: "Agree & Add to Chain"
    │
    ↓
12. ORCHESTRATOR → FRAUD AGENT
    │ "Final verification before agreement"
    │
    ↓
13. FRAUD AGENT → ORCHESTRATOR
    │ ✅ No critical alerts
    │
    ↓
14. APPROVAL AGENT finalizes agreement
    │ Supplier added to supply chain
    │
    ↓
15. UI redirects to Business Simulator

Data Flow: Trust Score Calculation

┌─────────────────────────────────────────────────────────────┐
│                    FRAUD AGENT                              │
│               Trust Score Calculation                       │
└─────────────────────────────────────────────────────────────┘
                           │
            ┌──────────────┼──────────────┐
            │              │              │
            ↓              ↓              ↓
    ┌───────────┐  ┌───────────┐  ┌───────────┐
    │  Security │  │  Pricing  │  │  Review   │
    │   Checks  │  │  Analysis │  │ Integrity │
    │           │  │           │  │           │
    │ • License │  │ • Discount│  │ • Rating  │
    │ • Insurance│ │   level   │  │   pattern │
    │ • Behavior│  │ • Market  │  │ • Review  │
    │           │  │   compare │  │   count   │
    └───────────┘  └───────────┘  └───────────┘
            │              │              │
            └──────────────┼──────────────┘
                           ↓
            ┌──────────────────────────────┐
            │   WEIGHTED SCORE FORMULA     │
            │                              │
            │  Trust = Base(50) +          │
            │    Rating × 0.30 +           │
            │    Reviews × 0.20 +          │
            │    Checks × 0.25 +           │
            │    Pricing × 0.15 +          │
            │    Integrity × 0.10          │
            │                              │
            │  Range: 0-100                │
            └──────────────────────────────┘
                           ↓
            ┌──────────────────────────────┐
            │      RISK ASSESSMENT         │
            │                              │
            │  < 30  → CRITICAL ⛔         │
            │  30-50 → HIGH ⚠️             │
            │  50-70 → MEDIUM ⚡           │
            │  > 70  → LOW ✅              │
            └──────────────────────────────┘
                           ↓
            ┌──────────────────────────────┐
            │    DISPLAY TO SHEPHERD       │
            │                              │
            │  Badge color:                │
            │  • Green (>80)               │
            │  • Amber (60-80)             │
            │  • Red (<60)                 │
            └──────────────────────────────┘

User Journey: Successful Negotiation

START
  │
  ↓
┌─────────────────────┐
│ 1. Shepherd Login   │
│    Zone: Miami      │
└─────────────────────┘
  │
  ↓
┌─────────────────────┐
│ 2. Go to Dashboard  │
│    "MY SUPPLIERS"   │
└─────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 3. Agents Initialize (2s)       │
│    • Sourcing discovers 12      │
│    • Fraud verifies each        │
│    • Recommendations ready      │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 4. Browse Recommendations       │
│    Categories:                  │
│    • PARKING (2 suppliers)      │
│    • CHARGING (2 suppliers)     │
│    • CLEANING (2 suppliers)     │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 5. Select "Secure Park"         │
│    Match: 85%                   │
│    Trust: 87/100 ✅             │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 6. Approval Agent Activates     │
│    • Welcome message            │
│    • AI suggestions             │
│    • Market context ($150)      │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 7. Shepherd Messages            │
│    "Do you have capacity?"      │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 8. Fraud Agent Monitors         │
│    ✅ No scam keywords          │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 9. Supplier Responds (2s)       │
│    "Yes, $150/vehicle/month"    │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 10. AI Analyzes Pricing         │
│     💡 "17% below market"       │
│     ✅ "Good deal"              │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 11. Exchange 2-3 Messages       │
│     (availability, SLA, etc.)   │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 12. Click "Agree & Add"         │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 13. Final Fraud Check           │
│     ✅ No alerts                │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 14. Agreement Finalized         │
│     • Contract recorded         │
│     • Supplier added to chain   │
└─────────────────────────────────┘
  │
  ↓
┌─────────────────────────────────┐
│ 15. Redirect to Simulator       │
│     (2s delay)                  │
└─────────────────────────────────┘
  │
  ↓
END ✅

Component Breakdown

AgenticSupplyChainMatrix.tsx
├── AgentStatus (Component)
│   ├── Sourcing: ACTIVE 🟢
│   ├── Approval: IDLE/ACTIVE 🔵
│   ├── Fraud: MONITORING 🔴
│   └── Supplier Intel: READY 🟠
│
├── SourcingPanel (Component)
│   ├── Category Header
│   └── SupplierRecommendationCard[]
│       ├── Supplier Name
│       ├── Match Score Badge
│       ├── Trust Score Badge (color-coded)
│       ├── Estimated Cost
│       ├── Distance
│       └── Reasoning Preview
│
├── NegotiationPanel (Component)
│   ├── Header (Agent name, supplier name)
│   ├── Message List
│   │   ├── Shepherd Messages (right-aligned)
│   │   ├── AI Messages (left-aligned, blue)
│   │   ├── Supplier Messages (left-aligned, gray)
│   │   └── AI Suggestions (amber, with icon)
│   └── Input Controls
│       ├── Message Input
│       ├── Send Button
│       └── "Agree & Add" Button
│
└── ActivityLog (Component)
    └── Log Entries (scrollable, newest first)

File Dependencies

App.tsx
  └─ imports AgenticSupplyChainMatrix
       │
       └─ imports AgentOrchestrator
            │
            ├─ imports SourcingAgentService
            │    └─ imports SupplierContentService
            │
            ├─ imports ApprovalAgentService
            │    └─ imports agent types
            │
            ├─ imports FraudAgentService
            │    └─ imports SupplierContentService
            │
            └─ imports SupplierAgentService
                 └─ imports agent types

All agent services import from:
  └─ types/agents.ts
       └─ defines all interfaces and types

---

This visual guide helps understand:

1. How the UI is structured

2. How agents communicate

3. How data flows through the system

4. The complete user journey

5. Component hierarchy and dependencies