How tsanford01/ai-soc-investigator works
Main Components
A. Agent Layer (Core Components):
• AI Agent (OpenAI Integration)
• Decision Agent
• Case Selection Agent
• Investigation Agent
• Notification Agent (Slack Integration)
• Coordinator Agent (Central Orchestrator)
B. Infrastructure Layer:
• Database (Supabase)
• Cases Table
• Decision Metrics Table
• External Services
• OpenAI API
• Slack API
C. Supporting Components:
• API Client Layer
• Authentication Service
• Rate Limiter
• Retry Mechanism
Component Relationships
• Coordinator Agent → All Other Agents (orchestration flow)
• All Agents ←→ Supabase Client (data access)
• AI Agent ←→ OpenAI API
• Notification Agent ←→ Slack API
• All Components ←→ Authentication Service
Specific Implementation Details
A. Top Level:
[External Systems] → [API Layer] → [Agent Orchestration] → [Database Layer]
B. Agent Workflow:
Case Selection → Investigation → Decision → Notification
C. Cross-Cutting Concerns:
• Error handling paths
• Retry mechanisms
• Rate limiting boundaries
Additional Elements
• Environment Configuration
• Error Handling Framework
• Performance Optimization Layer
• Monitoring & Logging
Architectural Patterns to Highlight
• Multi-agent architecture
• Service-oriented design
• Event-driven communication
• Repository pattern for data access
• Strategy pattern for agent behaviors
Technical Details
• Python as primary language
• Supabase for persistence
• OpenAI GPT for analysis
• Async patterns for performance
• Transaction boundaries
Security Boundaries
Indicate:
• Authentication boundaries
• API security layers
• Data encryption points