一、迁移说明

二、AppBuilder知识库&组件编排能力介绍

三、迁移时间

四、迁移步骤

确认知识库已迁移至 AppBuilder 平台

1. 1. 进入 “个人空间” - “知识库” 查看知识库列表。
   2. 确认 ModelBuilder 的知识库已呈现在 AppBuilder 知识库列表中。迁移的知识库名称会出现 ”MB_" 标志。

1. 1. 迁移的知识库在 AppBuilder 中已按照默认的切片规则，完成数据切片。进入知识库列表，点击 “查看” - “查看切片” 可以看到每个文件的切片结果。

确认应用服务已迁移至 AppBuilder 平台

1. 1. 进入 “个人空间” - “应用” 查看应用列表。
   2. 确认 ModelBuilder “插件编排” 下的应用服务已迁移在 AppBuilder 应用列表中。
   3. 对于 ModelBuilder 应用 “服务状态”，请确认：
      1. ModelBuilder 中 “服务状态“ 为 ”已上线“ 的应用，在 AppBuilder 的列表中，可以点击查看 ”发布详情“。
      2. ModelBuilder 中 “服务状态“ 为 ”编辑中“ 的应用，在 AppBuilder 的列表中，需要进行编辑后可发布。
   4. 进入 AppBuilder 每个应用配置页面，请确认：
      1. 应用设定：
         1. 应用基本信息正确。
         2. 角色指令和 ModelBuilder 对应的应用中提示词一致。
      2. 能力扩展：
         1. 如果在 ModelBuilder 中启用了知识库或域内知识检索增强插件：请确认
            1. Appuilder 应用中知识库区域关联了 ModelBuilder 对应的关联知识库。
            2. 知识库的 “高级检索” 配置中，和匹配分与知识插件 “置信度” 一致；召回数量 与 “结果数量” 一致。
         2. 如果在 ModelBuilder 中启用了知识库或域内知识检索增强以外的插件：请确认 AppBuilder 应用中组件区域所关联的组件和 ModelBuilder 添加的插件一致。组件名称映射关系见附件。
         3. 请确认 AppBuilder 中，开场白与 ModelBuilder 设置一致。
      3. 模型能力：
         1. 查看 AppBuilder 应用配置也右上角的模型配置
         2. “问答模型” 是知识库问答时所使用的模型。在配置了关联知识库，且不使用组件时（或组件仅选择百度搜索时），会使用问答模型。确认模型配置中 “问答模型” 与 ModelBuilder 应用中所选模型一致（目前支持 ERNIE 系列模型，其他 ModelBuilder 模型会在后续版本更新）。
         3. “思考模型” 推荐使用 “ERNIE-4.0-8k”。在关联组件时，会使用思考模型调度组件的使用。

对已迁移应用进行调试

1. 1. 测试当前效果
      1. 准备 3-5 个 测试 query，在右侧调试区域，输入 query ，查看当前应用的返回效果。如需改善答复效果，请参考如下步骤。
   2. 调整角色指令
      1. 如需对应用的答复语言风格调试，可以通过更改角色指令实现对应效果。也可以通过角色指令区域，右上角的 “优化” 功能，自动优化角色指令内容。当模型选择为 ERNIE 4.0-8k 时，对角色指令遵循会好于其他模型。
      2. AppBuilder 目前暂不支持在角色指令中添加变量。
   3. 调整模型
      1. 模型选择：对于仅使用知识库的场景，推荐将“问答模型”设置为 “ERNIE Speed-AppBuilder” ，结果风格会更简练，有条例，响应速度快。对于使用多组件的场景，推荐将 “思考模型” 设置为 ERNIE 4.0-8k。
      2. 多样性：对于知识库问答场景，推荐将多样性设为最低，从而让模型总结的内容，更加遵循知识库的反馈。
   4. 调整知识库高级检索配置
      1. 检索方式：推荐选择高级检索，获得更全面准确的切片段落。

1. 1. 1. 命中测试：调整召回数量和匹配分时，建议参考 “命中测试” 结果进行调整。
         1. 进入知识库列表，点击 “查看”，点击 “命中测试”。
         2. 使用测试 query 查看命中效果，确认正确切片的排序位置和切片匹配分数。
         3. 根据排序位置调整下述召回数量；根据匹配分数，调整下述匹配分。
      2. 召回数量：当模型返回结果所包含的信息点不足时，通过命中测试确认信息点所在切片排序位置。可通过提高召回数量，扩充切片的命中范围。
      3. 匹配分：当模型返回结果所包含的信息点不足时，通过命中测试确认信息点所在切片匹配分数。可通过降低匹配分，扩大召回切片范围。当返回

1. 1. 如果对知识库问答流程有复杂的逻辑要求，可通过工作流编排方式，配置详细流程。进入 “组件广场” - “创建组件” 使用工作流编排功能。使用方式可以参考：“文档中心：工作流创建组件” 。
   2. 如果需要使用自定义组件，可以通过工作流编排方式，将 API 封装为组件，并关联到应用配置中。使用方式可以参考 “文档中心：工作流创建组件 - API 节点”

更新您现有的应用调用方式

1. 1. 获取 API 秘钥
      1. 点击右上角头像，点击 “API密钥”。创建 “API密钥”
   2. 获取应用 ID
      1. 进入 “个人空间” - “应用列表” ，复制对应的 “应用 ID”。
      2. 如果 ”发布详情“ 灰态，则该应用还未发布。需要进入编辑页面，发布后用于 API 调用。
   3. 根据示例代码调用 API
      1. 【待0426更新文档。】

五、功能对比详情

功能列表

功能	千帆 ModelBuilder	千帆 AppBuilder
知识库	文本文档格式	支持文本文档格式,并支持自动生成知识点提高匹配度
	结构化格式	个人空间-「知识库」支持.xlsx结构化文件，仅支持固定2列模板格式（模板下载地址：固定格式xlsx模板） 个人空间-「数据库」功能，支持通用excel、jsonl等格式文件导入
	1个应用支持选择3个知识库	1个应用默认可选择5个知识库 自定义组件（工作流）-知识库节点：支持选择10个知识库 https://cloud.baidu.com/doc/AppBuilder/s/glv0f48qe
	从bos上传文件	暂不支持
插件编排	“智慧图问”插件	可使用“图像内容理解”组件替代：https://console.bce.baidu.com/ai_apaas/componentCenter/image_understand/detail 注意：需要用户完成个人认证或企业认证后，前往console领取免费额度
	“天气”插件	使用组件广场-“天气查询”组件实现
	“网页解析”插件	使用组件广场-“WebPilot”组件实现
	“百度搜索”插件	使用组件广场-“百度搜索”组件实现
	自定义插件	通过创建自定义组件（工作流）配置API来实现， 可参考：https://cloud.baidu.com/doc/AppBuilder/s/jlwg829cw
	选择模型类型： 预置模型 其他模型如：SFT训练模型	选择模型类型： 预置模型（可分别选择 思考模型和 问答模型） 工作流大模型节点已支持选择SFT模型
	配置“返回结果数量”和“置信度”	选择知识库后，点击“高级配置” 来配置检索方式、召回数量以及匹配分（对应千帆modelbuilder的置信度）
	配置自定义提示词	通过配置“角色指令”来实现
	配置引用提示词	通过创建自定义组件：知识库节点-大模型节点 来实现自定义rag框架的prompt

插件对应关系

六、常见问题解答（FAQ）

1.迁移截止时间？或千帆Model Builder的知识库&插件编排功能什么时候下线？

2.原来创建的插件是否还能使用？不迁移的话是否会对业务有影响？

3.迁移后需要用户侧进行什么工作？

4.是否支持通用excel格式上传？

5.是否支持从bos上传知识文件

6.知识库插件支持选择SFT微调模型

7.是否支持配置“携带上下文轮数”

8.如何通过agent实现同时调用多个不同的组件？

  
  

   
   

    # 角色人物
   
   
   
   

    您是一个先进的AI工具，专为识别用户提供的商品图片并匹配电商平台上的购买链接而设计。您的目标是帮助用户通过上传商品的照片快速找到在哪里可以购买该商品，以及提供比较购物选项的功能。
   
   
   
   

    
   
   
   
   

    # 工具能力
   
   
   
   

    当用户上传一张商品的图片时，首先使用图像内容理解分析并识别出图片中的商品。
   
   
   
   

    识别出商品后，利用电商商品查询，查询该商品在不同电商平台上商品信息，返回购买链接。
   
   
   
   

    
   
   
   
   

    # 限制要求
   
   
   
   

    请始终确保用户的隐私和数据安全，不要在不经用户同意的情况下收集或存储任何个人信息.
   
   
  
  

  
  

   
   

    # 角色任务
   
   
   
   

    您是一个智能旅行助手，专门设计用来帮助用户查询航班信息和规划目的地旅行。您的目标是提供一站式服务，包括航班查询、旅行日程安排以及目的地活动建议。
   
   
   
   

    
   
   
   
   

    # 组件能力
   
   
   
   

    1. 航班动态查询：当用户输入他们的旅行日期和航班号时，您需要使用航班动态查询并展示相关的航班信息。这包括航班号、出发和到达时间。
   
   
   
   

    2. 天气查询：可以使用天气查询组件，做天气查询。
   
   
   
   

    3. 百度搜索：使用百度搜索组件，查询用户旅游目的地的美食和景点，推荐荐相关的活动和安排。
   
   
   
   

    
   
   
   
   

    # 要求与限制
   
   
   
   

    1. 生成的旅行攻略需要考虑到航班的到达时间和每天的天气情况，合理规划安排
   
   
   
   

    2. 生成的回复内容需要规划每天的行程安排，并遵循以下内容格式：
   
   
   
   

    DAY 1：
   
   
   
   

    DAY2：
   
   
   
   

    如：
   
   
   
   

    DAY 1：4月11日中午十二点航班抵达北京，有可能下雨，注意携带雨伞。可以先前往酒店办理入住，下午四点左右出发去天安门广场。
   
   
   
   

    DAY 2：4月12日天气晴朗，早9点可以达到故宫游玩，但是要注意防晒和补水，中午12点可以品尝南门涮肉，下午两点出发去颐和园和圆明园，预计晚上六点结束。
   
   
  
  

9.AppBuilder 如何查看免费额度？

• 查看模型资源额度

• 查看组件资源额度
  • agent应用中可用的组件资源额度

• • SDK单独调用组件可用的资源额度

10.agent的qps可以达到多少？

11.agent响应速度比较慢，如何优化？

12.OpenAPI和Assistants API的区别是什么？

13.conversation_id过期时间是多久？是否支持调用接口查看conversation_id对应历史会话？

14.如何监控agent应用的调用量，以及失败成功情况？

15.appbuilder 支持的知识库集合数量和单知识库集合支持的文件数量？

16.知识库切片长度限制是多少？

17.AppBuilder如何收费？

• 思考模型：如果应用中未使用组件，思考模型不消耗tokens；如果使用了组件，输入预估消耗600-1800左右tokens,输出在60-400tokens。

• 问答模型：预置prompt的tokens大概在1000左右。如果应用中使用了知识库，会额外消耗一定tokens。

18.如何通过API/SDK来调用应用？

• OpenAPI的使用方法，请参考：OpenAPI使用指南（https://cloud.baidu.com/doc/AppBuilder/s/klv2eywua）
• AppBuilder-SDK的使用方法，请参考：AppBuilder-SDK使用指南（https://cloud.baidu.com/doc/AppBuilder/s/Glqb6dfiz）

19.如何获取知识库问答的回答来源？

20.如何获取接口调用消耗的tokens？

21.如何将自己开发的agent应用发布到官方应用广场？

22.agent应用如何实现语音回复？

23.报错：“与我互动人数较多，请稍后再试”如何解决？

24.如何通过API/SDK来批量上传知识库文件？

25.目前开放了哪些语言的sdk，其他语言是否有计划？

26.是否支持将应用发布到微信公众号，企业微信等平台？

• 微信公众号发布指南：https://cloud.baidu.com/doc/AppBuilder/s/Pltiltogx
• 企业微信-微信客服发布指南：https://cloud.baidu.com/doc/AppBuilder/s/9ltilry9v

27.如何自定义知识库的系统提示词？

28.如何通过自定义组件（工作流）构建自定义API组件？