教程路线

教程按“完成一件真实事情”组织。每篇都说明前置条件、可观察结果、关键代码和验证方式；如果你只想查询某个参数或类型，请直接去指南总览。

15 篇任务式教程 覆盖 SDK 到生产 Runtime Python 3.10+

路线 A：先把 Agent 跑起来

01 · 基础跑通第一个任务安装、配置、执行、读取结构化结果。

02 · 基础会话与流式输出复用 session，处理文本、工具和终态事件。

03 · 扩展工具、Skills 与 MCP直接调用工具、加载项目规范、连接外部工具服务。

路线 B：构建可编排 Runtime

04 · Runtime启动持久化 Run消费 canonical events，获取 Artifact 和稳定 run_id。

05 · Workflow编排并行 Workflow节点、边、并行、Join、条件和确定性状态合并。

06 · Team组织多 Agent 团队Specialist role、任务 DAG、并发与 Artifact 聚合。

路线 C：完成可恢复质量闭环

07 · Control审批、暂停与恢复让 waiting 不占 worker，并从 checkpoint 恢复。

08 · QualityQuality Gate 修复循环测试、lint、review 与有限次数自动返修。

09 · Isolation在 Sandbox 中执行文件、网络、环境和资源边界的正确配置。

路线 D：部署和二次开发

10 · StoragePostgreSQL 与 S3把 catalog 与大型 Artifact 拆成生产级存储。

11 · OperationsCLI、TUI 与 Web 协作跨界面观察、审批、恢复和导出运行产物。

12 · Extension扩展 Runtime注册工具、节点、Evaluator、Store 和远程 Sandbox transport。

路线 E：SDK 专题能力

13 · Tooling自定义工具与中间件把业务动作注册成工具，并统一做鉴权、改参与输出脱敏。

14 · Interaction多模态与人工交互发送截图，在流中接住 question、confirm 与 feedback。

15 · Context记忆、事件与指标保存项目知识，监听生命周期事件，导出调用指标。

教程与指南的区别

你现在想做什么	应该看哪里
从零跑通一个完整场景	本教程路线
查询完整参数、类型和默认值	指南
理解信任边界和实现约束	架构与Sandbox
排查线上 Run	运行观测与故障处理