How smartdata-polito/cybersleuth_forensic_agent works
Flow Reporter Agent analyzes PCAP events, summarizes TCP flows, then lets a tool-using LangGraph agent research findings and produce a structured forensic report. The benchmark runners initiate event processing; the graph runs flow analysis before the main reasoning loop. Web retrieval, semantic memory, and report formatting are distinct capabilities. Edges are limited to README statements and shown excerpts or SOURCE INDEX references; the separate TShark-expert module has no demonstrated connection to this branch’s graph.
Main entry points: graph.py Workflow graph · pcap_flows_reporter.py Flow reporter · main_agent.py Reasoning agent · online_browser.py Web search
Components 27
Event analysis
- Benchmark runner
src/run_agent.py - Web-event runner
src/run_agent_web_events.py - PCAP datasets
data - Flow reporter
src/multi_agent/main_agent/nodes/pcap_flows_reporter.py - PCAP tools
src/multi_agent/main_agent/tools/pcap - TCP flow analyzer
src/multi_agent/pcap_flow_analyzer/pcap_flow_analyzer.py - Flow extraction
src/multi_agent/common/utils.py - TShark expert tool
src/multi_agent/main_agent/tools/tshark_expert_tool/tshark_agent.py
Agent orchestration
- Agent settings
src/configuration.py - Workflow graph
src/multi_agent/main_agent/graph.py - Shared state
src/multi_agent/common/global_state.py - Reasoning agent
src/multi_agent/main_agent/nodes/main_agent.py - Tool-call router
src/multi_agent/main_agent/nodes/router.py - Tool executor
src/multi_agent/main_agent/nodes/tools.py
Research and memory
- Web search
src/browser/online_browser.py - Document chunking
src/browser/chunking_utils.py - Search summarization
src/browser/summarization_utils.py - Search prompts
src/browser/prompts.py - Memory upsert
src/multi_agent/main_agent/tools/memory/upsert_memory.py
Reporting
- Final report formatter
src/multi_agent/main_agent/tools/report/final_report.py - Log reporter
src/multi_agent/log_reporter/log_reporter.py
Other components
- Analyst
- TShark
- Google Search API
- Web pages
- Semantic memory store
- Event logs
Connections 31
- Analyst → Benchmark runner: runs benchmark
README.md - Analyst → Web-event runner: runs web test
README.md - Benchmark runner → Workflow graph: builds workflow
src/run_agent.py - Web-event runner → Workflow graph: builds workflow
src/run_agent_web_events.py - Benchmark runner → PCAP datasets: selects event PCAP
README.md - Web-event runner → PCAP datasets: selects event PCAP
README.md - Workflow graph → Flow reporter: starts with
src/multi_agent/main_agent/graph.py - Workflow graph → Reasoning agent: then invokes
src/multi_agent/main_agent/graph.py - Workflow graph → Tool executor: dispatches tools
src/multi_agent/main_agent/graph.py - Workflow graph → Tool-call router: routes messages
src/multi_agent/main_agent/graph.py - Flow reporter → Shared state: reads event state
src/multi_agent/main_agent/nodes/pcap_flows_reporter.py - Reasoning agent → Shared state: reads conversation
src/multi_agent/main_agent/nodes/main_agent.py - Flow reporter → PCAP tools: generates summary
src/multi_agent/main_agent/nodes/pcap_flows_reporter.py - Flow reporter → TCP flow analyzer: analyzes flows
src/multi_agent/main_agent/nodes/pcap_flows_reporter.py - Flow reporter → Flow extraction: extracts flow text
src/multi_agent/main_agent/nodes/pcap_flows_reporter.py - Flow extraction → TShark: runs capture commands
src/multi_agent/common/utils.py - Reasoning agent → PCAP tools: summarizes capture
src/multi_agent/main_agent/nodes/main_agent.py - Reasoning agent → Semantic memory store: searches memories
src/multi_agent/main_agent/nodes/main_agent.py - Reasoning agent → Agent settings: loads settings
src/multi_agent/main_agent/nodes/main_agent.py - Tool executor → Memory upsert: executes upserts
src/multi_agent/main_agent/nodes/tools.py - Memory upsert → Semantic memory store: writes memories
src/multi_agent/main_agent/tools/memory/upsert_memory.py - Tool executor → Web search: runs search
src/multi_agent/main_agent/nodes/tools.py - Web search → Google Search API: queries API
src/browser/online_browser.py - Web search → Web pages: fetches pages
src/browser/online_browser.py - Web search → Document chunking: chunks documents
src/browser/online_browser.py - Web search → Search summarization: summarizes results
src/browser/online_browser.py - Search summarization → Search prompts: uses prompts
src/browser/summarization_utils.py - Tool executor → Final report formatter: formats final answer
src/multi_agent/main_agent/nodes/tools.py - Analyst → TShark expert tool: optional expert analysis
- Workflow graph → Log reporter: optional log analysis
src/multi_agent/main_agent/graph.py - Log reporter → Event logs: reads event logs
src/multi_agent/log_reporter/log_reporter.py