How buchidonggua/dg-ai-notes works
This repository is an educational resource about the Pi-Agent SDK, not the SDK runtime itself. Its main reader workflow is to study the source-dive chapters or follow the hands-on DataAgent lessons, using the web book and interactive demonstrations as learning surfaces; a companion skill provides SDK and scenario references. The README documents these content tracks, while source excerpts show selected demo-to-data and component-to-helper relationships. The tutorials describe runtime behavior, but the underlying Pi-Agent SDK is external to this repository.
Main entry points: PartialMessageTimeline.tsx Message Timeline · index.astro Online Book · SKILL.md Skill Guide · KnowledgeGraph.tsx Knowledge Graph
Components 19
Web Book
- Online Book
pi-agent/web/src/pages/index.astro - Chapter Content
pi-agent/web/src/content/modules - Knowledge Graph
pi-agent/web/src/components/islands/KnowledgeGraph.tsx - Module Graph Data
pi-agent/web/src/data/module-graph.ts - Message Timeline
pi-agent/web/src/components/islands/PartialMessageTimeline.tsx - Error Defense Demo
pi-agent/web/src/components/islands/ErrorDefenseDemo.tsx - Event Timeline
pi-agent/web/src/components/islands/shared/EventTimeline.tsx - Play Controls
pi-agent/web/src/components/islands/shared/PlayControls.tsx - Message Card
pi-agent/web/src/components/islands/shared/MessageCard.tsx
Source Dive
- TypeScript Chapters
pi-agent/pi_source_dive/typescript - Python Chapters
pi-agent/pi_source_dive/python
Hands-on Lessons
- Tutorial Lessons
pi-agent/pi_sdk_learn/docs - Runnable Examples
pi-agent/pi_sdk_learn/code - Sales Query Tool
pi-agent/pi_sdk_learn/code/shared/lib/tools/query-data.ts - SSE DataAgent
pi-agent/pi_sdk_learn/code/L07-streaming/07a-sse-server.ts
Developer Skill
- Skill Guide
skills/dg-piagent/SKILL.md - SDK References
skills/dg-piagent/references/sdk_doc - Scenario Guides
skills/dg-piagent/references/scenarios
Other components
- Learner
Connections 17
- Learner → Online Book: reads online
README.md - Learner → TypeScript Chapters: studies TypeScript
README.md - Learner → Python Chapters: studies Python
README.md - Learner → Tutorial Lessons: follows lessons
README.md - Learner → Skill Guide: uses skill
README.md - Online Book → Chapter Content: presents chapters
README.md - Online Book → Knowledge Graph: offers interactive graph
README.md - Knowledge Graph → Module Graph Data: reads graph data
pi-agent/web/src/components/islands/KnowledgeGraph.tsx - Message Timeline → Event Timeline: renders events
pi-agent/web/src/components/islands/PartialMessageTimeline.tsx - Message Timeline → Play Controls: renders controls
pi-agent/web/src/components/islands/PartialMessageTimeline.tsx - Message Timeline → Message Card: renders snapshots
pi-agent/web/src/components/islands/PartialMessageTimeline.tsx - Error Defense Demo → Event Timeline: renders events
pi-agent/web/src/components/islands/ErrorDefenseDemo.tsx - Tutorial Lessons → Runnable Examples: pairs with code
README.md - Runnable Examples → Sales Query Tool: includes shared tool
README.md - SSE DataAgent → Sales Query Tool: registers tool
pi-agent/pi_sdk_learn/code/L07-streaming/07a-sse-server.ts - Skill Guide → SDK References: organizes references
README.md - Skill Guide → Scenario Guides: organizes scenarios
README.md