开发 Agent 路径

这条路径对应 Awaken 的开发侧：实现 runtime 可以安全执行的能力。代码聚焦 tool、 plugin、state、provider、store 和明确执行边界。后续应由运营者调整的行为放进 托管配置，再进入 调优与运营 使用浏览器和 REST 工作流。

推荐顺序

1. 先读 构建 Agent，确定 runtime、model registry 和 agent spec 的骨架。
2. 再读 添加 Tool 和 添加 Plugin，用安全的方式扩展行为。
3. 需要一个 Agent 接管当前 thread 时，阅读 使用 Agent Handoff。
4. 自定义 tool 代码需要受控调用子 Agent 时，阅读 在工具里调用 Sub-Agent。
5. 需要 Agent 在文本之外流式输出 UI 文档时，阅读 使用 Generative UI。
6. 通过配置调优 Agent 行为 用于理解代码能力和运营调优的边界。

建议搭配阅读

• Tool Trait 用于核对精确契约。
• Tool 与 Plugin 的边界 用于判断扩展应该放在哪一层。
• 架构 用于理解完整运行时模型。