# bhaskar1001/agentic-ai-incident-platform architecture

> Architecture diagram of the GitHub repository bhaskar1001/agentic-ai-incident-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bhaskar1001/agentic-ai-incident-platform
- Repository: https://github.com/bhaskar1001/agentic-ai-incident-platform

## Overview

This is a Python incident-response agent: a caller submits an incident description, the workflow assesses severity, investigates the incident, then chooses escalation or monitoring. Investigation uses a bounded model/tool loop to gather mock logs, metrics, and pod status, preserving evidence and a timeline in structured results. The incident domain also defines status-transition rules, though the sampled workflow does not use the Incident entity. The README is empty; unsampled API details and persistence are not represented.

Main entry points: [`src/agentic_ai/workflows/incident.py`](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/workflows/incident.py) (Incident workflow), [`src/agentic_ai/agents/investigation.py`](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/agents/investigation.py) (Investigation agent), [`src/agentic_ai/llm/severity.py`](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/llm/severity.py) (Severity assessment), [`src/agentic_ai/tools/registry.py`](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/tools/registry.py) (Tool registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Incident workflow"]
  node_workflow["Incident workflow<br/>[incident.py]"]
  node_monitor["Monitoring outcome<br/>[incident.py]"]
end

subgraph group_investigation["Investigation"]
  node_agent["Investigation agent<br/>[investigation.py]"]
end

subgraph group_domain["Domain models"]
  node_incident_model["Incident lifecycle<br/>[incident.py]"]
  node_investigation_model["Investigation results<br/>[investigation.py]"]
end

subgraph group_tools["Observability tools"]
  node_registry["Tool registry<br/>[registry.py]"]
  node_mock_tools["Mock observability tools<br/>[mock_tools.py]"]
end

subgraph group_llm["Model integration"]
  node_severity["Severity assessment<br/>[severity.py]"]
end

node_caller(("Incident caller"))
node_ollama{{"Ollama model service"}}
node_human(("Human responder"))

node_caller -->|"submits incident"| node_workflow
node_workflow -->|"assesses severity"| node_severity
node_severity -->|"requests assessment"| node_ollama
node_severity -->|"uses severity type"| node_incident_model
node_workflow -->|"runs investigation"| node_agent
node_agent -->|"reasons and summarizes"| node_ollama
node_agent -->|"dispatches tools"| node_registry
node_registry -->|"calls registered tools"| node_mock_tools
node_agent -->|"records evidence and results"| node_investigation_model
node_workflow -->|"escalates urgent cases"| node_human
node_workflow -->|"routes normal cases"| node_monitor

click node_workflow "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/workflows/incident.py"
click node_severity "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/llm/severity.py"
click node_incident_model "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/domain/incident.py"
click node_agent "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/agents/investigation.py"
click node_investigation_model "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/domain/investigation.py"
click node_registry "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/tools/registry.py"
click node_mock_tools "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/tools/mock_tools.py"
click node_monitor "https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/workflows/incident.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workflow,node_monitor toneBlue
class node_agent toneAmber
class node_incident_model,node_investigation_model toneMint
class node_registry,node_mock_tools toneRose
class node_severity,node_caller,node_ollama,node_human toneIndigo
```

## Components

### Incident workflow

- [Incident workflow](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/workflows/incident.py): `src/agentic_ai/workflows/incident.py`
- [Monitoring outcome](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/workflows/incident.py): `src/agentic_ai/workflows/incident.py`

### Investigation

- [Investigation agent](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/agents/investigation.py): `src/agentic_ai/agents/investigation.py`

### Domain models

- [Incident lifecycle](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/domain/incident.py): `src/agentic_ai/domain/incident.py`
- [Investigation results](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/domain/investigation.py): `src/agentic_ai/domain/investigation.py`

### Observability tools

- [Tool registry](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/tools/registry.py): `src/agentic_ai/tools/registry.py`
- [Mock observability tools](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/tools/mock_tools.py): `src/agentic_ai/tools/mock_tools.py`

### Model integration

- [Severity assessment](https://github.com/bhaskar1001/agentic-ai-incident-platform/blob/main/src/agentic_ai/llm/severity.py): `src/agentic_ai/llm/severity.py`

### Other components

- **Incident caller**
- **Ollama model service**
- **Human responder**

## Connections

- Incident caller → Incident workflow: submits incident (evidence: `src/agentic_ai/workflows/incident.py`)
- Incident workflow → Severity assessment: assesses severity (evidence: `src/agentic_ai/workflows/incident.py`)
- Severity assessment → Ollama model service: requests assessment (evidence: `src/agentic_ai/llm/severity.py`)
- Severity assessment → Incident lifecycle: uses severity type (evidence: `src/agentic_ai/llm/severity.py`)
- Incident workflow → Investigation agent: runs investigation (evidence: `src/agentic_ai/workflows/incident.py`)
- Investigation agent → Ollama model service: reasons and summarizes (evidence: `src/agentic_ai/agents/investigation.py`)
- Investigation agent → Tool registry: dispatches tools (evidence: `src/agentic_ai/agents/investigation.py`)
- Tool registry → Mock observability tools: calls registered tools (evidence: `src/agentic_ai/tools/registry.py`)
- Investigation agent → Investigation results: records evidence and results (evidence: `src/agentic_ai/agents/investigation.py`)
- Incident workflow → Human responder: escalates urgent cases (evidence: `src/agentic_ai/workflows/incident.py`)
- Incident workflow → Monitoring outcome: routes normal cases (evidence: `src/agentic_ai/workflows/incident.py`)
