ZHOU AZ Contact ↗
中文
Agent
产品笔记
解释 AI Agent，不能只讲概念。真正重要的是可复现路径。
001 / Context
中文用户和建设者不缺模型热情，缺的是可运行的路径。
他们真正关心的是：怎么配置、怎么调用工具、怎么处理失败、怎么验证结果、怎么把一个原型变成可以继续演进的产品骨架。
所以好的中文表达不是把英文术语翻译一遍，而是把技术路径重新组织成能够被理解、复现和改造的学习顺序。
001先让系统跑起来环境变量、模型配置、本地启动、示例 prompt、常见报错、API key 权限，比宏大的 Agent 定义更重要。
002解释设计选择围绕真实代码说明为什么用 typed tool schema，为什么工具返回要结构化，为什么工具状态必须可见。
003教开发者扩展新增工具放在哪里，输入输出怎么定义，UI 组件怎么绑定，测试 fixture 怎么写，失败状态怎么覆盖。
004把失败写进教程主动展示配置错误、API 失败、参数不匹配和安全拦截，而不是只展示最顺利的一条路径。
002 / Delivery
一个好的产品原型应该能被继续开发。
- 一个可以本地运行的示例应用，而不是只有 API 片段。
- 一条从安装、配置、运行、观察工具调用到添加新工具的中文上手路径。
- 带有错误案例的排错文档，让使用者知道如何自己定位问题。
- 面向中文语境的演示叙事，把复杂能力讲成可以复现、可以验证、可以继续开发的产品路径。
中文开发者教育的核心，是把复杂能力变成可复现、可验证、可扩展的路径。