Technische documentatie

1. Architectuur

2. Bestanden

5085 regels verdeeld over 28 bestanden.

API (api/)

Agent (agent/)

Dashboard (dashboard/)

Seed (seed/)

3. Database

SQLite met 5 tabellen in /opt/agentic-demo/data/itsm.db

customers

cmdb (31 CI's)

runs

Kolommen: id, run_name, started_at, completed_at, total_tickets, model_used, temperature, system_prompt_hash

run_results

Kolommen: id, run_id (FK), incident_id, incident_title, status_before, status_after, priority_assigned, resolver_group, category_assigned, agent_reasoning, enrichment (JSON), questions_asked (JSON), tool_calls (JSON), tool_call_count, rounds, processing_time_ms, token_usage (JSON), created_at

{
  "total_input": 12500,
  "total_output": 3200,
  "per_round": [
    {"round": 1, "input": 8000, "output": 1500},
    {"round": 2, "input": 4500, "output": 1700}
  ]
}

4. API endpoints

Core

Incidents

CMDB & Klanten

Runs

Ticket Library

5. Agent werkwijze

7 tools

Agentic loop per ticket

1. Lees het ticket (titel, beschrijving, klant, CI)
2. Haal klantinfo op (SLA's, tier, freezes)
3. Zoek het CI (direct op ID of via CMDB-zoekactie)
4. Check CI-historie (patronen, recent major incident)
5. Analyseer en neem beslissing
6. Update het ticket met alles in één keer

Beslislogica

Tracking

Per ticket wordt opgeslagen: verwerkingstijd (ms), aantal tool calls met input/output per call, token usage per ronde (input + output), totaal rondes. Beschikbaar in run_results en in incident.enrichment._agent_meta.

6. Dashboard pagina's

index.html — Hoofdpagina

• Topbar: Logo, titel, links (Beheer, Handleiding, Docs), stats (Tickets, Verwerkt, Gem. tijd, Tokens, Model), knoppen (Stats, Demo, Reset & Run All)
• Linkerkolom (35%): Ticketlijst met sortering (oudst/nieuwst/prio). Open P1's staan bovenaan in rode sectie. "+ Nieuw" knop opent formulier.
• Rechterkolom (65%): Agent Audit Trail — Binnenkomst, Agent verrijking, Redenering, Besluit
• Stats overlay: Run selector, 4 summary cards, per-ticket tabel
• Nieuw ticket overlay: Titel, beschrijving, klant (filtert CI's), CI, checkbox "Direct verwerken"

admin.html — Beheer

• Snelle acties: Demo, Run All, Reset, Wis runs
• Eén ticket: Dropdown + run naam
• Ticket bibliotheek: Filters (demo-worthy, complexiteit, tags), individuele selectie, start run
• Run historie: Overzicht met naam, datum, tickets, model, status

guide.html — Handleiding

9 secties voor eindgebruikers: Wat is dit, Architectuur, Dashboard, Agent, Tickets, Runs, CLI, API, Demo tips.

7. CLI commando's

Alle commando's vanuit /opt/agentic-demo:

# Seed data resetten
venv/bin/python -m seed.load_seed

# Alle nieuwe tickets verwerken
venv/bin/python -m agent.run_all_new --name "naam"

# Eén ticket verwerken
venv/bin/python -m agent.run_single 4 --name "naam"

# Selectie uit bibliotheek
venv/bin/python -m agent.run_selection --demo-worthy --name "naam"
venv/bin/python -m agent.run_selection --tags gdpr,escalatie --name "naam"
venv/bin/python -m agent.run_selection --complexity hoog --name "naam"
venv/bin/python -m agent.run_selection --ids TL-004,TL-011 --name "naam"
venv/bin/python -m agent.run_selection --demo-worthy --dry-run

# Service beheer
sudo systemctl restart itsm-simulator
sudo systemctl status itsm-simulator
sudo journalctl -u itsm-simulator -f

8. Design systeem

Kleuren

Prioriteiten

P1 P2 P3 P4

Statussen

new triaged dispatched escalated resolved

Fonts

UI: Segoe UI / system. Mono: Cascadia Code / Fira Code / Consolas.