按目标选择下一步
完成第一个智能体模板和智能体实例后,按实际交付目标选择下一条路径。能力模板和实例不是必经步骤;只有当智能体实例需要对应资源时,才在其来源智能体模板中配置。每条路径都应得到可以检查的运行结果,而不只是完成页面配置。
| 交付目标 | 优先进入 | 完成标志 |
|---|---|---|
| 继续调整模型和提示词 | 让开发环境稳定可用 | 固定测试输入可以稳定获得符合提示词要求的回复,并能在 Trace 中定位本次运行 |
| 比较不同业务场景 | 选择一个场景实战 | 已根据额外前提和验收证据选定一条实战路径 |
| 基于团队资料回答,并确认实际发生检索 | 构建可追溯的企业知识助手 | 回答依据已入库资料,Trace 显示知识检索 |
| 让多个智能体使用统一维护的资料 | 构建由平台统一维护、供多个智能体复用的知识服务 | 两个智能体检索同一 Collection,内容更新后无需分别重新上传资料 |
| 使用公开文档 MCP 验证远程工具链路 | 构建使用公开文档 MCP 的技术文档助手 | 新会话先搜索再读取 Microsoft Learn 官方页面并附上来源链接,Trace 显示对应工具调用 |
| 按交付类型验收对象存储中的订单或退款文件 | 构建订单与退款交付验收助手 | 助手调用计划脚本;脚本匹配已批准校验器,审批后产生 PASS 或 FAIL,并从对象存储下载、核对报告 |
| 让业务调用方执行自定义工具并返回真实结果 | 构建可调用业务系统的工单助手 | 调用方收到工具中断、返回测试结果,智能体据此完成回答 |
| 用一个服务台入口处理制度与当前工单 | 构建知识与工单协同的服务台助手 | 混合问题同时触发知识检索和工单工具,并区分信息来源 |
| 让每位飞书用户按需开通个人工作助手 | 构建按用户开通的飞书个人工作助手 | 两位测试用户分别完成 /init,获得不同实例并验证不同的工作助手配置 |
| 在飞书交付统一维护的员工服务 | 构建共享制度知识的飞书员工服务助手 | 两位用户按需开通实例、检索共享资料,并完成解绑后重新开通 |
| 由业务系统调用 | 由业务系统调用 | Invoke API 返回预期内容和 session_id,后续请求可以继续同一会话 |
| 让渠道用户使用 | 让渠道用户使用 | 测试消息进入预期智能体实例并在同一渠道收到回复 |
| 增加知识、工具、记忆、Skill 或沙箱 | 增加外部能力 | 代表性输入触发目标能力,并在 Trace 或相关运行记录中留下证据 |
| 理解资源创建、会话、审批和运行边界 | 理解运行和资源模型 | 能够说明目标配置会创建或共享哪些资源,并知道到哪里核对实际结果 |
| 准备生产上线 | 准备生产交付 | 已确定实例、凭证、能力资源、监控、变更和清理责任 |
让开发环境稳定可用
继续使用智能体实例的 Playground 验证系统提示词、模型参数和多轮对话。需要查看模型调用和工具执行过程时,打开 Trace。
适合以下情况:
- 仍在调整提示词或模型。
- 需要确认工具调用是否进入审批流程,以及模板规则是否产生预期结果。
- 还没有确定最终接入 API 还是渠道。
由业务系统调用
打开智能体实例的 API 调用,在 API 调用状态 中开启调用,先使用 临时调试 Token 验证请求,再选择 创建正式 Token。
继续阅读:
如果业务入口是需要双向长连接的自有消息系统,而不是以请求/响应方式调用的后端服务,请改用通过 WebSocket 接入智能体。先运行最小客户端验证目标部署、Token 和消息往返,再按照 WebSocket API 参考实现业务客户端。
让渠道用户使用
先判断用户是否应共享同一个智能体实例:
- 不同用户只需拥有各自的对话历史:绑定已有智能体实例,并使用不同渠道会话。
- 需要分别管理实例参数、能力资源或生命周期:绑定智能体模板,让用户发送
/init。
参见通过渠道提供智能体和管理渠道会话。需要按固定检查点练习飞书模板绑定、两位用户分别开通和配置个人工作助手、解绑和重新初始化时,参见构建按用户开通的飞书个人工作助手。
增加外部能力
根据智能体要完成的任务选择能力:
- 调用外部系统工具:使用 MCP。
- 检索已入库的企业资料:使用知识库组。
- 保存可供后续交互检索的信息:使用记忆库。
- 复用版本化的工作说明和文件:使用技能组。
- 在隔离环境中执行命令或处理文件:使用沙箱。
参见为智能体添加能力。
理解运行和资源模型
已经熟悉智能体平台、框架或生产系统,并需要预测资源创建、会话延续、工具审批或子代理行为时,可以从以下机制说明进入。这些页面解释可以在控制台、调用结果和运行记录中核对的行为;完成基础创建和测试时不必预先读完。
- 模板和实例如何影响资源:判断能力资源何时创建、共享和更新。
- Session、调用任务和中断:管理 API 会话、调用任务和中断。
- 渠道用户绑定和渠道会话:管理渠道会话。
- 工具审批入口和自动处理规则:配置工具审批。
- Skill 文件和执行能力:使用 Skill。
- 沙箱共享、会话级或调用任务级隔离:选择沙箱隔离范围。
- 子代理委托和后台任务:了解子代理和动态委托。
- HTTP 和 WebSocket 协议:Invoke API 参考和WebSocket API 参考。
准备生产交付
生产交付需要同时确认智能体实例、访问凭证、能力资源、监控和变更方式。为开发、预发布和生产分别创建独立智能体实例和 Token,并通过名称区分;平台不将这三个阶段作为内置环境对象管理。
参见将智能体投入生产。