ProactivePulse: MSP Insight Agent (PulseAI)

Mission: Continuously correlate helpdesk ticket trends with infrastructure metrics to proactively surface root-cause hypotheses and recommended actions for MSPs using cutting-edge Agentic AI architecture.

🔧 Key Technical Features

• Agentic AI Multi-Agent System: Orchestrator, Data Ingestion, Anomaly Detection, Ticket Analysis, Correlation, Insight Generation, Notification, and Health Check agents
• Enhanced Data Persistence: DynamoDB with Global Secondary Indexes (GSI) support for efficient querying and pagination
• Enterprise Search Engine: AWS OpenSearch with fuzzy matching support, relevance scoring, and full-text search capabilities
• Advanced Analytics: Time-series analytics with multi-dimensional aggregations (avg, sum, max, min) and hourly/daily buckets
• Real-time Indexing: Automatic indexing of insights, anomalies, and clusters with nested document support
• Dual-mode Architecture: Seamless transition between local development and AWS deployment

⚡ Quick Start

For detailed setup instructions, please refer to the component-specific README files:

• Backend Setup
• Frontend Setup
• Deployment Guide

📁 Project Structure

ProactivePulseAI/
├── backend/                 # Python FastAPI backend with Agentic AI
│   ├── app/
│   │   ├── agents/          # Strands Agents SDK implementations
│   │   ├── api/             # FastAPI endpoints
│   │   ├── storage/         # AWS & OpenSearch integration
│   │   └── ...
├── frontend/                # Next.js TypeScript frontend
├── deployment/              # AWS deployment automation
├── docs/                    # Technical documentation
└── ...

For detailed structure, see individual component README files

🏗️ Agentic AI Architecture

Powered by AWS Strands Agents SDK, our system implements a sophisticated multi-agent architecture:

Core Agents:

• Orchestrator Agent: Central coordinator with intelligent routing
• Data Ingestion Agent: Handles metrics and tickets data loading
• Anomaly Detection Agent: Specializes in detecting infrastructure anomalies
• Ticket Analysis Agent: Analyzes and clusters support tickets
• Correlation Agent: Links anomalies with ticket clusters
• Insight Generation Agent: Creates actionable root-cause hypotheses
• Notification Agent: Manages proactive digests
• Health Check Agent: Monitors system performance

Enhanced Data Layer:

• DynamoDB with GSI Support: Microsecond query performance
• AWS OpenSearch Integration: Enterprise-grade search with fuzzy matching
• Real-time Indexing: Automatic insight indexing with relevance scoring
• Time-Series Analytics: Multi-dimensional aggregations

🔄 Agentic Workflow

1. Data Ingestion: Metrics and tickets loaded via specialized agents
2. Anomaly Detection: Infrastructure anomalies identified with GSI-optimized queries
3. Ticket Analysis: Support tickets clustered with Bedrock-powered NLP
4. Correlation Engine: Anomalies correlated with ticket clusters using vector similarity
5. Insight Generation: Root-cause hypotheses created with automatic OpenSearch indexing
6. Proactive Digest: Top insights delivered with relevance scoring

📡 Advanced API Endpoints

• GET /insights - Paginated insights with GSI-optimized queries
• GET /insights/{id} - Detailed insight with nested document support
• GET /insights/{id}/related - Related insights with vector similarity
• POST /analysis/run - On-demand analysis with multi-agent orchestration
• GET /analysis/status/{run_id} - Real-time analysis status tracking
• GET /analysis/history - Historical analysis with time-series aggregations
• GET /search/insights - Full-text search with fuzzy matching support
• GET /search/analytics - Advanced analytics with multi-dimensional aggregations

⚙️ Enterprise Configuration

For detailed configuration options, see Backend Documentation

Key AWS Integrations:

• DynamoDB with GSI Support: Optimized query performance
• AWS OpenSearch: Enterprise search with fuzzy matching
• Amazon Bedrock: State-of-the-art AI models
• S3 Storage: Scalable data persistence

📚 Comprehensive Documentation

• Backend Documentation - Agentic AI implementation details
• Frontend Documentation - Next.js TypeScript frontend
• Deployment Guide - AWS deployment automation
• Technical Specifications - Detailed architecture and API docs