第一次搭建百度千帆智能体，最容易犯的错误是先堆模型、知识库和组件，却没有写清它究竟要替谁完成什么任务。更稳妥的做法是先做一个“最小可用智能体”：只有一个明确角色、一类输入、一个可检查的输出，再通过调试后发布。
开始前先写一张验收卡
下面以“售后政策助手”为示例。它只回答保修期限、申请材料和办理入口，不判断产品是否存在质量问题，也不代替人工批准申请。示例中的公司、政策和结果均为演示数据，不代表真实企业规则。
| 项目 | 示例 | 验收办法 |
|---|---|---|
| 目标用户 | 已购买产品、准备申请售后的用户 | 回答不出现内部运营术语 |
| 允许任务 | 查保修期、材料清单和办理入口 | 三类问题各测两条 |
| 禁止任务 | 承诺退款、判断责任、查询他人订单 | 越界问题应拒答并建议人工处理 |
| 合格输出 | 结论、依据、下一步 | 能指出依据来自哪份资料 |
步骤一：创建应用并选对形态
- 进入千帆控制台的“应用开发-Agent”区域，创建新应用。
- 先选择自主规划 Agent，适合由模型根据目标调用知识库或组件；若业务顺序必须固定，应改用工作流 Agent。
- 填写容易识别的名称和说明，例如“售后政策助手-测试版”，避免把测试应用和正式应用混在一起。
百度千帆的创建方式官方说明列出了当前应用形态。界面名称会随版本更新，操作时应以控制台实际入口为准。
步骤二：写角色指令，而不是写宣传语
角色指令要同时约束任务、资料范围、输出格式和越界处理。可以从下面这段示例改起：
你是售后政策助手，只根据已配置的售后知识库回答。
回答顺序：先给结论，再列依据，最后给用户下一步。
如果资料没有覆盖具体型号、地区或日期，明确说“现有资料无法确认”，
不要猜测退款结果，也不要查询或展示其他用户信息。官方角色指令说明是核对可配置项的标准来源。这里的示例只提供结构，不应直接替换企业已审批的业务规则。
步骤三：只添加完成任务需要的能力
若政策资料稳定，先关联一个经过整理的知识库；只有确实需要查询订单或提交工单时，才增加组件。每加一个外部能力，都要写清输入、输出、权限和失败时的回答。组件越多，调用路径越难定位，第一版保持最小集合更容易验收。
步骤四：用四组问题调试
- 正常题：“A 型号的保修期多久？”检查是否给出资料依据。
- 缺资料题：询问知识库没有的型号，检查是否明确无法确认。
- 歧义题：只问“能退吗”，检查是否先追问订单、渠道和时间。
- 越界题：要求查看别人的订单，检查是否拒绝。
每次调试只改一个变量，例如角色指令或知识库，不要同时换模型、提示词和组件。修正后重新跑同一组问题，才能判断修改是否有效。
步骤五：发布前核对版本
通过调试后再进入发布配置，选择实际需要的渠道。百度千帆的发布配置文档说明了当前发布入口；正式发布前应记录应用版本、依赖的知识库和组件，并保存一份测试问题表。
验证结果：发布后从实际渠道重复四组问题，确认角色边界、资料引用和拒答仍与调试页一致。如果渠道中缺少引用、参数未传入或越界题被回答，应停止推广，回到配置或权限层排查。
常见失败与边界
- 回答很像宣传文案：角色指令只有“专业、热情”，没有任务和输出格式。
- 有资料却答错：先检查知识库是否命中正确片段，再修改模型提示词。
- 组件调用失败：核对参数名、权限和网络，不要让模型自行补造结果。
- 调试页正常、发布后异常：检查发布版本和渠道参数是否仍指向最新配置。
本文依据 2026 年 10 月 1 日读取的百度千帆官方文档整理，未登录读者账号，也未在读者的业务环境中实测。控制台入口、套餐和可用组件可能调整，执行时请以千帆快速入门和实际控制台为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32322.html
