Skip to content

Repository files navigation

🛡️ SRE Incident Intelligence Agent

Automated Multimodal Triage & Autonomous Remediation

License: MIT Python 3.11+ Powered by LangGraph

📝 Project Overview

In high-stakes e-commerce environments, every second of downtime translates to financial loss. The SRE Incident Intelligence Agent is an AI-native solution designed to automate the critical first response of an incident. It doesn't just report issues; it analyzes them multimodally (logs, screenshots, metrics), retrieves knowledge from runbooks, and executes autonomous remediation actions to lower the Mean Time to Recovery (MTTR).

The Problem

Traditional incident management relies on manual triage, leading to:

  • Delayed response times during off-hours.
  • Human error in diagnosing complex microservice failures.
  • Disconnected silos between monitoring tools and documentation.

The Solution

A stateful AI agent that acts as a Level 3 SRE, capable of:

  1. Multimodal Ingestion: Analyzing text descriptions and error screenshots.
  2. Contextual Reasoning: Correlating APM metrics with historical runbooks via RAG.
  3. Agentic Action: Performing self-healing tasks (e.g., restarting pods) before escalating to humans.

🏗️ Architecture

The system follows a modular, event-driven architecture orchestrated by LangGraph.

Core Components:

  • Ingestion Layer: FastAPI endpoints receiving multimodal webhooks.
  • Brain (LangGraph): A directed acyclic graph (DAG) that manages the ReAct cycle (Reasoning + Action).
  • Perception (GPT-4o-mini): Multimodal LLM that "sees" error screenshots and "reads" logs.
  • Memory (ChromaDB): Local Vector DB providing RAG capabilities for runbook retrieval.
  • Action Layer: Custom toolset for Jira, Slack, and Kubernetes remediation.

🚀 Key Features

  • Multimodal Analysis: Upload a screenshot of a terminal error or a trace; the agent identifies the failure signature.
  • Autonomous Remediation: Low-risk self-healing actions are executed agentically to stabilize the system.
  • End-to-End Traceability: 100% of agent thoughts and tool calls are traced via LangSmith.
  • Closed-Loop Notifications: Automatic updates to technical teams (Slack/Jira) and original reporters (Email).

🛠️ Tech Stack

  • Frameworks: LangGraph, LangChain, FastAPI, Streamlit.
  • LLM: gpt-4o-mini (via OpenRouter).
  • Data & RAG: ChromaDB, HuggingFace Embeddings.
  • Observability: LangSmith, OpenInference.
  • Infrastructure: Docker Compose, Python 3.11.

📋 Quick Start

Detailed instructions are available in QUICKGUIDE.md.

  1. Clone the repository:
   git clone https://github.com/faiber1986/SRE-Triage-Agent.git
   cd sre-triage-agent
  1. Setup your .env file with OPENROUTER_API_KEY, LANGSMITH_API_KEY and LANGSMITH_TRACING_V2=true.
  2. Run the stack:
    docker compose up --build
  3. Access the UI:

📚 Documentation Index

  • AGENTS_USE.md: Agent use cases, safety guardrails, and observability evidence..
  • QUICKGUIDE.md: Detailed step-by-step instructions for testing the end-to-end flow.
  • SCALING.md: Technical assumptions, scaling strategy, and financial/risk assessment.

⚖️ License

This project is licensed under the MIT License - see the LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages