选择一个场景实战
场景实战从一个可运行的业务结果开始，把智能体、能力资源、智能体实例、接入方式和验证方法连成一条完整路径。可以先照着样例运行，再根据自己的数据、系统和交付方式调整。
选择起点
第一次评估一体化智能体运行与协同平台（AgentWorks）的能力链路时，建议从企业知识助手开始。该实战使用固定 Markdown 文件，可以同时验证资料入库、知识库组关联、智能体实例运行和 Trace 检索记录，不需要准备外部业务 API 或渠道应用。
| 选择实战 | 完成标志 | 开始前需要 |
|---|---|---|
| 构建可追溯的企业知识助手：让回答基于团队维护的资料，并确认实际发生检索 | 回答依据样例资料，Trace 显示知识检索 | 可以上传 Markdown 文件 |
| 构建可调用业务系统的工单助手：让智能体调用现有业务逻辑，而不是猜测业务状态 | 调用方收到工具中断、返回测试工单状态，智能体据此完成回答 | 可以执行 Node.js 样例的调用环境 |
| 构建按用户开通的飞书助手：让每位飞书用户按需获得自己的智能体实例 | 两位测试用户获得不同智能体实例，后续消息进入各自实例 | 非生产飞书企业自建应用和两位测试用户 |
第一次使用 AgentWorks 时，完成创建第一个智能体并完成基础验证，并以 Playground 实际返回一条模型回复作为凭证验证结果。凭证可选、模型名称已显示或页面显示 已连接，只表示相应配置已经加载。获得回复后选择一个场景实战，无需把所有能力同时添加到同一个智能体模板。
三条实战的关键区别
知识助手中的检索由 AgentWorks 运行。工单助手中的用户工具只描述工具契约，实际查询由调用 Invoke API 的业务系统运行。飞书助手通过模板绑定，在每位用户执行 /init 时按需创建智能体实例，并保存后续消息使用的用户绑定。
如果工具已经由远程 MCP Server 提供，使用 MCP 模板和实例，而不是让业务调用方处理用户工具中断。如果只需要平台已有工具，参见使用平台工具包。
如何使用场景实战
每条场景实战通常按以下五个阶段推进：
- 运行：使用固定样例得到第一个工作结果。
- 验证：检查 Trace、中断或运行状态，确认预期能力真的被使用。
- 理解：了解关键配置为什么这样选择。
- 调整：把样例替换为自己的数据、业务接口或交付方式。
- 上线：补充权限、凭证、变更、监控、容量和清理措施。
只想快速评估时，可以在“验证”后停止。准备生产系统时，继续完成“调整”和“上线”，并参考将智能体投入生产。
把实战迁移到生产
实战中的固定样例用于验证能力链路，不应直接变成唯一的生产配置。完成“验证”后，先通过将智能体投入生产处理以下事项：
- 为预发布和生产分别创建智能体实例、能力资源、渠道账号和 Token。
- 记录模型、提示词、知识内容和外部连接配置，并为技能组选择明确的 Skill 版本。
- 使用固定成功、失败和边界用例复测，并检查 Trace 和相关运行记录。
- 分阶段切换流量，保留可用的旧实例，并准备凭证、路由和外部写操作的回退方式。
不同实战需要补充的生产责任并不相同。知识助手需要内容负责人和入库检查；业务工具助手需要调用方权限、幂等和审计；飞书助手还需要应用负责人、用户绑定清理和实例容量规划。