AppBuilder周高频问题-12.3日更新

产品官网

https://appbuilder.cloud.baidu.com/

产品主页

https://console.bce.baidu.com/ai_apaas/dialogHome

产品文档

https://cloud.baidu.com/doc/AppBuilder/s/6lq7s8lli

Github首页

https://github.com/baidubce/app-builder

产品更新日志

https://cloud.baidu.com/doc/AppBuilder/s/Jlt4dqv3h

平台资源

https://cloud.baidu.com/doc/AppBuilder/s/llq6grh7e

模型计费管理

https://console.bce.baidu.com/qianfan/chargemanage/list

问题

答案

应用调优功能相关问题

应用调优功能的作用是什么

在自主规划Agent中，点击调优按钮，即可进入到应用调优的界面，调优功能支持通过数据干预和规则干预（待上线）的形式对应用对话中的问答进行干预，让应用可以输出开发者期望的标准答案。

数据干预具备什么功能？开启后效果是什么样？

【调优-数据干预】界面中支持干预数据的上传、编辑、采纳、导出和删除等处理方式，通过维护和调整干预数据，你可以实现应用对话效果的调优。干预数据以问答对的形式储存，提问对应对话中终端用户的提问或输入，回答对应对话中应用的回复或输出。

数据干预开启后，当⽤户问题匹配标准问答对中的问题时，会⾃动调取标准回答答案输出，不再做其他分析；你可以通过多种方式获取或上传问答对，在对数据处理并采纳后，问答对将会生效并干预应用的回答，在【配置-预览与调试】界面可以测试数据干预的干预效果。

干预数据列表的待处理、已采纳、不采纳三个tab记录规则分别是什么？

待处理、已采纳、不采纳：所有问答数据将会按照处理状态（已采纳/不采纳/待处理）展示在不同的tab之下，其中：

提问、回答、相似问如何进行干预数据？

干预数据由提问、回答和相似问三个部分组成，所有提问和相似问对应同一个答案。当⽤户问题匹配到已采纳列表下问答对中的问题或相似问时，会⾃动调取标准回答答案输出。

能否看到各项数据的来源？

可以，会展示数据导入的来源，包括在线抽取、用户反馈、标答上传三种类型。

状态是根据什么规则变换的？各个状态对应的规则是很么？

已采纳数据列表中还会展示数据状态，应用开发者采纳数据后，平台将进行安全校验，校验通过后显示为「已生效」，正在校验的显示为「校验中」，由于问答对存在安全或合规问题、校验不合格的显示为「失效」；「已生效」已采纳并生效的数据会干预问答过程。

如何添加干预数据？

可以通过自动获取或标答上传两种形式添加

干预数据如何自动获取？

数据干预支持通过回流用户反馈、抽取历史对话和挖掘知识库信息自动获取用于干预的数据，同时帮助开发者了解应用对话和用户反馈的情况，提供进行干预的参考。

问答对自动获取支持三种来源的配置：用户反馈、在线抽取、离线挖掘（待上线），自动获取到的问答对数据统一为待处理状态，你可以通过采纳问答对使这些数据生效。

标答怎么上传？有什么要求限制吗？

通过手动上传的方式导入问答对数据，支持通过表单逐个添加和通过文件批量导入两种方式。

手动输入：你可以在表单中手动输入提问和回答，提问长度不超过200字，回答长度不超过2000字，点击加号会添加相似提问，补充的相似提问将会匹配到同一条回答。

批量导入：你可以通过上传文件实现大量问答对的批量导入，请按照平台提供的模版进行填写，避免出现格式问题导致的上传失败。

批量导入时，对文件的大小和数据量有限制要求：一次仅能上传一个xlsx文件，且文件大小不超过20M；每个文件不超过10,000个问答对，超出将会上传前10,000个问答对。请勿超出上传限制。

如何处理干预数据？

1. 编辑数据

2. 操作数据

你也可以在已采纳/不采纳页面调整问答对的处理状态。

3. 导出数据

你可以对勾选的数据进行导出，导出的数据将会包含提问、回答、来源、用户反馈评价等信息，导出时支持两种不同的文件格式，你可以自行选择。在进行大量数据导出时，数据处理需要一定时间，请耐心等待。

平台相关问题

模型token如何计费？

https://cloud.baidu.com/doc/WENXINWORKSHOP/s/hlrk4akp7

角色指令长度限制多少？

目前限制为3000字符

为什么模型选择了免费的但是依旧提示无资源？

需要在资源额度页面开启切换付费按钮：https://console.bce.baidu.com/ai_apaas/resource

为什么使用3.5、4.0、4.0-turbo时有token包仍消耗了帐户余额？

https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Wlqatm587#%E8%A7%A6%E5%8F%91%E6%90%9C%E7%B4%A2prompt_tokens%E6%89%A9%E5%A4%A7%E5%8F%8A%E7%8B%AC%E7%AB%8B%E6%8C%89%E6%AC%A1%E8%AE%A1%E8%B4%B9%E8%AF%B4%E6%98%8E
搜索增强按次收费，于2024年10月31号正式商用。

appbuilder中如何避免使用3.5、4.0、4.0-turbo触发搜索增强？

可以为应用添加知识库或百度搜索组件，模型将自动关闭搜索增强；

appbuilder发布后能设置成不登录直接使用么？

有计划，目前暂不支持，可通过小程序、API、sdk封装等实现免登录

思考模型是每次都要进行消耗吗？

不一定，如果与大模型闲聊对话，不消耗思考模型token，具体消耗可在debug页面对话后查看

思考模型和问答模型的区别？

您可以在千帆大模型平台查看各个模型的介绍和版本说明。

组件是如何计费的？

是否支持查看bot的历史对话？

已新增记忆功能，打开记忆片段，即可查看对话片段

https://cloud.baidu.com/doc/AppBuilder/s/Jlqa9qyot#%E8%AE%B0%E5%BF%86%E7%89%87%E6%AE%B5

思考模型目前还是原本的ERNIE-3.5-8k、ERNIE-4.0-8k、ERNIE-speed-AppBuilder吗？

已新增ERNIE-4.0-Turbo-8k、Qianfan-AppBuilder-lite-128k、Qianfan-Agent-lite-8k、Qianfan-agent-speed-8k

需要使用更多其他模型的话需要在哪开通和购买？

目前千帆大模型平台模型已全部预设开通，无需单独开通

可前往页面进行购买：https://console.bce.baidu.com/qianfan/ais/console/onlineService

appbuilder query 字数长度有限制么

有长度限制,目前限制在2000字符内

是否可以免费使用

AppBuilder的计费模式是怎么样的？

由模型调用费用与组件调用费用组成，详情可查看：https://cloud.baidu.com/doc/AppBuilder/s/llq6grh7e

使用中token消耗是怎么计算的？

当前token消耗由用户问题，角色指令 和 系统预置三部分组成，预计消耗平均值可查看：https://cloud.baidu.com/doc/AppBuilder/s/llq6grh7e#token%E6%B6%88%E8%80%97%E8%A7%84%E5%88%99

组件相关问题

API节点各种第三方平台的API都能接进来吗？

平台支持接入遵守RESTful架构规范并采用标准认证机制的API。API接入前需要已经完成服务化，确保所有接入的API均遵循RESTful架构规范，确保使用无状态的请求模型并通过HTTP标准方法（如GET、POST、PUT、DELETE)进行资源操作，同时接口使用标准的认证机制。此外，接口设计符合OpenAPI规范，接入的API已经过性能测试、安全审查和兼容性检测，以确保API的稳定性和可靠性。同时为确保模型调用组件的最终效果，当前接口参数层级不支持超过10层。

API节点输出内容限制大小是多少？

300kb的限制

组件工作流输出的内容有长度限制吗？

组件输出长度没限制

意图识别节点的功能

意图识别节点可以对输入的语句进行意图分类，并根据配置抽取该语句内的关键参数，匹配到不同的流程分支执行。

记忆变量节点的功能

记忆变量节点可以写入和读取应用配置中的记忆变量。记忆变量节点需要与应用中的记忆变量功能配合使用。您可以通过此节点写入变量值，调试成功后，变量值会同步至应用中的记忆变量，也可以通过此节点读取应用中的记忆变量值并输出。

用python代码创建组件时，是否支持通过pip install命令安装某些类库？

工作流的代码节点不支持pip install，有一些安全问题。如果希望写代码态组件，推荐使用appbuilder-sdk，部署API服务到公有云再注册到API节点

组件广场支持上传自己的组件吗？

现已开启，可在个人空间-组件页面选择上传进行发布

自定义组件中代码节点必须按格式来写吗？

是的， 要按照示例格式进行编写

语音识别组件不准确

需要用对应的格式与帧率的单声道音频才能进行识别

可在组件广场中的组件详情页面查看组件可使用的环境

组件的QPS额度可以扩充吗

通过应用配置的组件，目前限额为1

其他组件可查询：https://cloud.baidu.com/doc/AppBuilder/s/Glqb6dfiz#3%E3%80%81%E5%BC%80%E9%80%9A%E7%BB%84%E4%BB%B6%E6%9C%8D%E5%8A%A1

百度搜索组件可以通过API进行调用吗？

不可以

工作流组件的学习教程有吗？

工作流创建组件：https://cloud.baidu.com/doc/AppBuilder/s/glv0f48qe

视频教程：https://cloud.baidu.com/partner/course-center/course.html?id=784

目前自定义工作流组件可以单独通过API调用吗？

不可以，需要等待官方更新。目前只能通过放置在应用中调用应用。

知识库

知识库里有多个文件时，大模型在回答过程中是全部文件都检索吗

是的

正则表达式的标题使用这个示例吗？1代表什么？
•标题模板 “第章〞：（第八d一二三四五六七八九十零
壹贰叁肆伍陆柒捌玖拾](1,;章

可以直接使用这个模板，1代表的是至少为1，大量章节可以先用这个示例尝试
如效果不好，可以用这个尝试：(第)?(\d+|[\d一二三四五六七八九十零壹贰叁肆伍陆柒捌玖拾百千万]+)章

知识库更新后有哪些变化？

您可前往官方文档进行查阅：https://cloud.baidu.com/doc/AppBuilder/s/rlz9jsyj3

如果一个问题覆盖多个文件的话，可以将多个文件里的知识点都检索出来吗

可以

txt 文件显示 1000 页限制，这个是按多少字符来算的？

2000字符，大量的换行和空格也会影响上传。

知识库可以扩容吗？

可以通过bos、bes两款产品进行创建，实现无限容量的知识库存储

知识库有说明吗？

https://cloud.baidu.com/doc/AppBuilder/s/Jlqa9qyot#%E7%9F%A5%E8%AF%86%E5%BA%93

AppBuilder知识库是否支持图片检索

AppBuilder知识库不支持图片检索

知识库上传内容一直处理中

可能处于排队状态，等待上传成功或重新导入即可。

知识库召回数量影响回复速度，召回数量在哪里

知识库添加位置的高级配置页面中

知识库数量限制是多少

一个应用可以配置几个知识库

单个知识库上传的容量是多少

知识库数量为100个

一个应用可在知识库位置添加5个知识库

单次上传文档数量为100个；共计可上传800个文件

目前支持.doc，.txt，.docx，.pdf，.ppt，pptx六种格式；txt 文件不能超过10MB， docx、pdf、doc、ppt、pptx 文件不能超过50MB且不能超过1000页

同时具备知识库与百度搜索时，如何控制应用优先通过知识库进行回复

可以点击【高级配置】按钮，支持将知识库和网页搜索搭配使用、选择优先知识库

同时可以调整知识库检索策略，知识库检索包括全文检索、语义检索、混合检索三种策略，以及设置召回数量和匹配分等。

数据库

数据库上传数据表的限制是多少？

每个账号通过上传数据表的方式最多创建100个数据库，每个数据库最多创建100个数据表；通过直连数据库的方式最多创建20个数据库，每个数据库中表的数量无上限。

添加了数据库，为什么出现 Python 窗口？

数据库是用python代码调取，所以会出现代码窗口

数据库可以通过API进行写入吗？

暂不支持

数据库可以和自己的数据库连接吗？

可以，创建数据库时可选择直连数据库

数据库可支持配置多个数据库吗？

暂不支持，目前只可设置一个数据库

数据库的作用

引用结构化的数据，实现表格问答，支持单表问答或多表联合问答。大模型会根据你的问题以及数据表描述来自动调用数据回答问题，可以和其他组件以及知识库联合使用，每个应用最多支持关联1个数据库。

数据库和知识库的区别

数字人

数字人是否支持定制形象

目前暂不支持，已在更新计划内

数字人是否支持定制声音

目前暂不支持，已在更新计划内

应用发布

官方分发支持企业微信吗？

现已支持

两个appbuilder应用发布的微信客服可以相同吗

一个客服一个应用，可以在微信多增加客服数量

过小程序二维码分享的那种用户的聊天记录不会保存是吗？第二次打开以后和上次的上下文关联不上吗

无法关联

AppBuilder可以提供小程序的访问路径吗？

/pages/conversation/index?app_id=应用ID

可以分发到什么渠道？

应用广场、微信小程序、网页版、百度搜索、企业微信、微信客服、微信公众号、网站嵌入

如何在公众号/小程序中配置指定小程序跳转链接

/pages/conversation/index?app_id=xxx

（xxx取个人空间中的应用ID）

可以发布至百度搜索吗？

可以，详情参考：https://cloud.baidu.com/doc/AppBuilder/s/sltilu5k2

sdk/openAPI

AppBuilder-SDK目前版本是？

可前往github（https://github.com/baidubce/app-builder）查看，支持AppBuilderClient-Tool Call、AppBuilder-Trace、AppBuilder-Knowledge等功能；

builder.run里面的tools是做什么用的？

builder.run里面的tools参数主要用于调用和配置工具
https://github.com/baidubce/app-builder/blob/master/cookbooks/end2end_application/agent/tool_call.ipynb 可以看这个cookbook

appbuild toolcall等 很多功能 go sdk版本都有支持吗？

toolcall go 支持的；这里有示例文档和代码：https://github.com/baidubce/app-builder/blob/master/docs/basic_module/appbuilder_client.md

AppBuilder能通过API接口或者SDK来查询应用吗？

可以

AppBuilder能通过API接口或者SDK来实现知识库完整的增删改查功能吗

可以

AppBuilder-SDK只有python的吗？

Python/Go/Java 以及 OpenAPI

appbuilder支持支持多agent吗？

没有在平台上提供这个功能，通过SDK可以自己代码态组装

appbuilder如何通过sdk部署

可以登陆我们的Github首页查看：https://github.com/baidubce/app-builder?tab=readme-ov-file

如何进行上下文对话？

使用同一个 conversion id 就可以上下文对话

tokens的计算有没有工具代码可以用，我看不同的模型，tokens不一样？

可以用最新版本的AppBuilder SDK 或 OpenAPI，大模型对话接口会返回当前的token用量

记忆

记忆变量功能使用有什么需要注意的吗？

1.准确的变量名称与描述，可以让智能体更准确的写入和读取变量信息。
2.开发者删除变量或修改变量名称/描述，应用更新发布后会导致用户对应的变量数据被删除或重置为默认值，请谨慎操作。

记忆功能的长期和单次会话有什么区别

记忆时长
长期：用户一旦赋予变量值后将会长期存储，不会随着会话关闭而恢复为默认值。
单次会话：当一次会话结束后，则应用用户赋予的变量值会自动恢复为默认值，仅对一次会话生效。

记忆表对应的字段都是什么意思怎么配置？

列名：设置一张记忆表表头有哪些字段。开发者定义好存储字段后，终端用户可在对应字段下存储相关数据。
列描述：用来解释此列数据的含义和用途，智能体将会根据列描述对记忆表进行按需调用并读写列信息。
数据类型：选择存储字段对应的数据类型，智能体将按照开发者定义的字段数据类型，对终端用户输入的内容进行保存。
是否必要：定义字段是否必要，在保存记忆表的一行数据时，终端用户在对话中必须提供必要字段的信息，否则无法保存该行数据。

记忆表功能使用技巧和注意事项有什么？

删除列名或修改表名/表描述/列名/列描述，应用更新发布后会导致对应列的用户数据被删除或清空，需谨慎操作。

记忆表可以通过对话添加内容吗？

可以的，在定义好记忆表后，应用用户在和智能体的对话过程中，可以通过自然语言的方式将数据存储在记忆表中，智能体会识别用户对话中的信息，生成sql将信息写入记忆表。

记忆片段有什么作用呢？

记忆片段可以让智能体记住非结构化的信息，并根据记忆生成更个性化的回答。

记忆片段的prompt是具备什么作用

预设prompt可以记录聊天中有关用户信息、偏好、计划等内容进行记忆；自定义prompt能让智能体更个性化的记录用户的关键信息。