选择一个场景实战
场景实战从一个可运行的业务结果开始，把智能体、能力资源、智能体实例、接入方式和验证方法连成一条完整路径。可以先照着样例运行，再根据自己的数据、系统和交付方式调整。
选择起点
这组实战也是一条产品学习路径。基础实战先让一项核心能力独立工作；进阶实战加入外部连接或多人治理；组合实战复用前面已经验证的能力，完成更接近真实业务的结果。这样可以逐步扩大能力范围，又不会在第一条实战中同时排查过多变量。
第一次评估智能体开发服务平台（AgentWorks）的能力链路时，建议从企业知识助手开始。该实战使用固定 Markdown 文件，可以同时验证资料入库、知识库组关联、智能体实例运行和 Trace 检索记录，不需要准备外部业务 API 或渠道应用。
基础：理解一条核心能力链路
| 选择实战 | 重点能力 | 完成标志 | 开始前需要 |
|---|---|---|---|
| 构建可追溯的企业知识助手 | 企业知识检索和 Trace | 回答依据样例资料，Trace 显示知识检索 | 可以上传 Markdown 文件 |
| 构建可调用业务系统的工单助手 | 用户工具、Invoke 中断和调用方执行 | 调用方收到工具中断、返回测试工单状态，智能体据此完成回答 | 可以执行 Node.js 样例的调用环境 |
| 构建按用户开通的飞书个人工作助手 | 个人工作助手、模板绑定、/init 和按用户配置 | 两位测试用户获得不同智能体实例，分别完成会议行动项整理和需求澄清 | 非生产飞书企业自建应用和两位测试用户 |
进阶：学习外部连接和能力治理
| 选择实战 | 重点能力 | 完成标志 | 开始前需要 |
|---|---|---|---|
| 构建由平台统一维护、供多个智能体复用的知识服务 | 共享知识、维护者与使用者分工 | 两个智能体的 Trace 指向同一 Collection，资料更新后都能取得新答案 | 可以维护 Collection，建议准备第二个同租户测试账号 |
| 构建使用公开文档 MCP 的技术文档助手 | 外部 MCP 和最小权限工具规则 | 回答附上实际读取的 Microsoft Learn 官方页面链接 | 可以访问 Microsoft Learn，并且只使用公开、非敏感的测试问题 |
| 使用 Todo 和文件系统生成研究简报 | 外部 MCP、Todo 和会话文件 | 按计划搜索、读取、写入并回读 Markdown 简报 | 已有可用的 Microsoft Learn MCP 实例和可写的智能体文件系统 |
| 构建订单与退款交付验收助手 | 对象存储挂载、校验器清单、验收计划和持久报告 | 助手调用接收方计划脚本；脚本匹配订单或退款校验器，审批后生成 PASS 或 FAIL，并从对象存储核对报告 | 获准的非生产对象存储范围、Python 3 沙箱和人工工具审批 |
组合：复用已经验证的能力
| 选择实战 | 重点能力 | 完成标志 | 开始前需要 |
|---|---|---|---|
| 构建知识与工单协同的服务台助手 | 企业知识与用户工具协同 | 同一条混合问题触发知识检索和工单工具，并分别说明信息来源 | 已完成知识助手和工单助手，且可以运行 Node.js 样例 |
| 构建共享制度知识的飞书员工服务助手 | 共享知识与按用户开通的飞书交付 | 两位用户分别完成 /init，获得不同实例，并从同一知识资源取得有依据的回答 | 已验证的知识库组实例、专用飞书应用和两位测试用户 |
第一次使用 AgentWorks 时，完成创建第一个智能体并完成基础验证，并以 Playground 实际返回一条模型回复作为凭证验证结果。凭证可选、模型名称已显示或页面显示 已连接，只表示相应配置已经加载。获得回复后选择一个场景实战，无需把所有能力同时添加到同一个智能体模板。
每条实战都会围绕一项主能力，只添加完成该结果所需的辅助能力。新建智能体模板默认开启文件系统功能；不需要文件产物、Todo 或长会话压缩的实战会明确关闭或不启用这些功能，避免把无关能力带入验证。公开文档 MCP 实战先用精确允许规则和默认拒绝规则学习最小权限；需要文件产物时，再进入独立的研究简报实战组合 Todo 和文件系统功能。完成实战并不表示生产智能体应长期关闭或开启同一组能力；应按目标启用所需能力，并为它增加独立的成功、失败和恢复检查。
理解实战之间的关键区别
知识助手中的检索由 AgentWorks 运行；共享知识服务实战进一步把资料维护与智能体使用分开，让多个智能体连接同一个知识库组实例。公开文档助手中的搜索和页面读取由外部 Microsoft Learn MCP Server 提供，AgentWorks 负责连接服务、发现工具并限制允许调用的范围。工单助手中的用户工具只描述工具契约，实际查询由调用 Invoke API 的业务系统运行；服务台助手把知识检索和业务工具组合到同一个入口。两条飞书实战都使用模板绑定和 /init，但基础实战聚焦用户绑定与实例生命周期，员工服务实战进一步加入统一维护的知识。
如果工具已经由远程 MCP Server 提供，可以先完成构建使用公开文档 MCP 的技术文档助手，再选择 MCP 实例或模板调整为自己的服务；不要让业务调用方处理本应由 MCP Server 执行的工具。如果只需要平台已有工具，参见使用平台工具包。
如何使用场景实战
每条场景实战通常按以下五个阶段推进：
- 运行：使用固定样例得到第一个工作结果。
- 验证：检查 Trace、中断或运行状态，确认预期能力真的被使用。
- 理解：了解关键配置为什么这样选择。
- 调整：把样例替换为自己的数据、业务接口或交付方式。
- 上线：补充权限、凭证、变更、监控、容量和清理措施。
只想快速评估时，可以在“验证”后停止。准备生产系统时，继续完成“调整”和“上线”，并参考将智能体投入生产。
把实战迁移到生产
实战中的固定样例用于验证能力链路，不应直接变成唯一的生产配置。完成“验证”后，先通过将智能体投入生产处理以下事项：
- 为预发布和生产分别创建智能体实例、能力资源、渠道账号和 Token。
- 记录模型、提示词、知识内容和外部连接配置，并为技能组选择明确的 Skill 版本。
- 使用固定成功、失败和边界用例复测，并检查 Trace 和相关运行记录。
- 分阶段切换流量，保留可用的旧实例，并准备凭证、路由和外部写操作的回退方式。
不同实战需要补充的生产责任并不相同。知识助手需要内容负责人、版本和入库检查；业务工具和服务台助手需要调用方权限、幂等和审计；飞书实战还需要应用负责人、允许名单、用户绑定清理和实例容量规划。