How yuyan3616/aiops works
Pi Chat is an AIOps root-cause-analysis workspace: users investigate incidents through a chat UI, while a Main Agent coordinates hypotheses and specialist evidence gathering, then produces a validated conclusion and report. The graph also includes session lifecycle, persisted evidence, visualization, and independent evaluation. Source excerpts show key orchestration and persistence relationships; other links rely on README documentation, and unsampled implementation details are not inferred.
Main entry points: rca/service.ts Investigation coordinator · conversation/service.ts Conversation service · App.tsx Chat workspace · pi-expert.ts Expert sessions
Components 23
Chat workspace
- Chat workspace
apps/pi-chat/src/App.tsx - Conversation stream
apps/pi-chat/src/hooks/useConversationStream.ts - Investigation details
apps/pi-chat/src/components/rca/InvestigationDetailDrawer.tsx - Flow viewer
apps/pi-chat/src/components/rca/MermaidFlowViewer.tsx
Conversation runtime
- Conversation routes
apps/pi-chat/server/routes/conversation.ts - Conversation service
apps/pi-chat/server/conversation/service.ts - Pi session runtime
apps/pi-chat/server/conversation/runtime.ts - Stream channel
apps/pi-chat/server/conversation/channel.ts - Conversation records
apps/pi-chat/server/conversation/repository.ts
RCA investigation
- Main Agent
apps/pi-chat/server/rca/main-agent-tools.ts - Investigation coordinator
apps/pi-chat/server/rca/service.ts - Expert sessions
apps/pi-chat/server/rca/pi-expert.ts - Expert profiles
apps/pi-chat/server/rca/profiles/registry.ts - Budget controls
apps/pi-chat/server/rca/budget.ts
Evidence and data
- Observability tools
apps/pi-chat/server/rca/tools.ts - RCA100 adapter
apps/pi-chat/server/rca/adapter.ts - Parquet queries
apps/pi-chat/server/rca/parquet.ts - Investigation records
apps/pi-chat/server/rca/repository.ts
Investigation outputs
- Visualization service
apps/pi-chat/server/rca/visualization/service.ts - Flow builder
apps/pi-chat/server/rca/visualization/builder.ts - Final report
apps/pi-chat/server/rca/service.ts - Independent evaluator
apps/pi-chat/server/rca/evaluation/scorer.ts
Other components
- User
Connections 24
- User → Chat workspace: starts investigation
README.md - Chat workspace → Conversation stream: streams conversation
README.md - Chat workspace → Investigation details: opens details
apps/pi-chat/src/App.tsx - Investigation details → Flow viewer: renders flow
apps/pi-chat/src/components/rca/InvestigationDetailDrawer.tsx - Conversation stream → Conversation routes: uses API
README.md - Conversation routes → Conversation service: handles requests
README.md - Conversation service → Pi session runtime: creates runtime
apps/pi-chat/server/conversation/service.ts - Conversation service → Conversation records: persists records
apps/pi-chat/server/conversation/service.ts - Conversation service → Investigation coordinator: loads investigation context
apps/pi-chat/server/conversation/service.ts - Pi session runtime → Stream channel: streams events
- Main Agent → Investigation coordinator: requests investigation actions
README.md - Investigation coordinator → Expert sessions: dispatches tasks
apps/pi-chat/server/rca/service.ts - Expert sessions → Expert profiles: selects expertise
apps/pi-chat/server/rca/profiles/registry.ts - Expert sessions → Observability tools: calls tools
README.md - Observability tools → RCA100 adapter: queries case data
README.md - RCA100 adapter → Parquet queries: reads telemetry
- Investigation coordinator → Budget controls: enforces budgets
apps/pi-chat/server/rca/service.ts - Investigation coordinator → Investigation records: persists evidence
README.md - Investigation coordinator → Final report: validates conclusion
README.md - Investigation coordinator → Visualization service: requests visualization
apps/pi-chat/server/rca/service.ts - Visualization service → Investigation records: loads and saves artifact
apps/pi-chat/server/rca/visualization/service.ts - Visualization service → Flow builder: builds flow
apps/pi-chat/server/rca/visualization/service.ts - Independent evaluator → Investigation records: reads completed investigation
apps/pi-chat/server/rca/evaluation/scorer.ts - Independent evaluator → Final report: scores after completion
README.md