# vkuruganti/aiops architecture

> Architecture diagram of the GitHub repository vkuruganti/aiops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vkuruganti/aiops
- Repository: https://github.com/vkuruganti/aiops

## Overview

##### Project type and purpose
- This is a microservices-based orchestration system for enterprise on-call triage.
- Two main areas:
- “agent” – a set of small AI/LLM-powered REST services (PDF processing, ping test, etc.)
- “oncall” – a Python orchestration pipeline that sequences alert ingestion, deduplication, summarization, question generation, action proposal, and ServiceNow ticket drafting, optionally offloading ML inference to Nvidia Triton.

##### File structure
- Top-level:
- README.MD
- agent/
- oncall/
- agent/
- app.py & ping_test.py – Flask entrypoints
- requirements.txt – Flask, PyMuPDF, OpenAI SDK
- pdf/ – sample documents for processing
- templates/index.html – minimal UI
- oncall/oncall-triage-orchestration/
- src/ – pure-Python modules by pipeline stage
- each subfolder is a self-contained component: ingestion, deduplication, summarization, clarifying_questions, next_actions, servicenow
- triton_client.py – Nvidia Triton gRPC client
- utils/helpers.py – shared code
- main.py – coordinator that wires modules in sequence
- .env & requirements.txt – environment variables and dependencies

##### README for additional insights
- agent folder = independent AI agents, designed to run as microservices
- oncall folder = orchestration logic, runs those agents or Triton for scalable inference
- Modularity and separation of concerns

##### Summary of steps for the principal software engineer
6) With protocols (HTTP, gRPC) and key library names (Flask, Triton client).

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Orchestrator"
        ORC["Orchestrator\n(main.py)"]:::internal
        ORC -->|"calls"| ING
        ING["Ingestion Service"]:::internal
        ING -->|"flows to"| DED
        DED["Deduplication Service"]:::internal
        DED -->|"flows to"| SUM
        SUM["Summarization Service"]:::internal
        SUM -->|"flows to"| QST
        QST["Clarifying Questions Service"]:::internal
        QST -->|"flows to"| ACT
        ACT["Next Actions Service"]:::internal
        ACT -->|"flows to"| TKT
        TKT["ServiceNow Ticket Drafter"]:::internal
    end

    subgraph "Agent Microservices"
        PDF["PDF Processing Agent"]:::agent
        PING["Ping Test Agent"]:::agent
    end

    subgraph "External Services"
        TRITON(("Nvidia Triton\nInference Server")):::external
        OPENAI(("OpenAI API")):::external
        SNOW(("ServiceNow API")):::external
    end

    ING -->|HTTP| PDF
    ORC -->|HTTP| PING
    SUM -->|gRPC/HTTP| TRITON
    SUM -->|HTTP| OPENAI
    QST -->|gRPC/HTTP| TRITON
    QST -->|HTTP| OPENAI
    TKT -->|REST API| SNOW

    click ORC "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/main.py"
    click ING "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/ingestion/alert_ingestor.py"
    click DED "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/deduplication/deduplicator.py"
    click SUM "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/summarization/summarizer.py"
    click QST "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/clarifying_questions/question_generator.py"
    click ACT "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/next_actions/action_proposer.py"
    click TKT "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/servicenow/ticket_drafter.py"
    click TRITON "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/triton_client.py"
    click PDF "https://github.com/vkuruganti/aiops/blob/master/agent/app.py"
    click PING "https://github.com/vkuruganti/aiops/blob/master/agent/ping_test.py"
    click ORC_HELP "https://github.com/vkuruganti/aiops/blob/master/oncall/oncall-triage-orchestration/src/utils/helpers.py"

    classDef internal fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef agent fill:#90EE90,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef external fill:#f4f4f4,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2
```
