阿里云百炼平台应用开发、知识库和数据管理的常见问题解答
查阅有关阿里云百炼应用和知识库的常见问题。
CLI 安装、Skills 与报错排查的更多问答见 安装与鉴权 页的「常见问题」。
应用开发
Agent 和 Assistant API 的主要区别是什么?
Agent 和 Assistant API 的主要区别是什么?
两者的核心区别在于开发方式和适用场景:
- Agent(智能体应用):通过控制台可视化配置,无需编码。支持插件市场选择、知识库关联、MCP 工具接入、应用组件复用和记忆功能,适合快速搭建对话应用。
- Assistant API:通过 DashScope SDK 编码调用,按照创建 Assistant、创建 Thread、发送 Message、发起 Run 的流程运行。支持代码解释器、函数调用(Function Calling)等工具,适合需要将智能体集成到自有系统的开发者。
目前官方都支持什么类型的插件?
目前官方都支持什么类型的插件?
目前系统提供五款插件能力,分别是:Python 代码解释器、计算器、夸克搜索、生成二维码、GitHub 搜索。其中部分插件需要经过申请通过后才可以使用。
自定义插件能力是否收费?
自定义插件能力是否收费?
自定义插件服务目前暂时不收费,但配置智能体 API 时如涉及到 prompt 优化、应用调用及测试窗测试,则会收费。
自定义插件或函数的参数是如何被模型理解和使用的?
自定义插件或函数的参数是如何被模型理解和使用的?
自定义 API 插件会遵循协议,传给大模型进行理解。对于函数而言,大模型会学习传入的参数信息,并返回完整的结果。
阿里云百炼调用自定义插件时能否透传自定义 header?
阿里云百炼调用自定义插件时能否透传自定义 header?
不支持自定义 header,仅支持 authorization。
如何将应用回复设置为增量输出?
如何将应用回复设置为增量输出?
设置以下参数即可:
AI 输出内容包含 **xxxxx**,如何显示为加粗?
AI 输出内容包含 **xxxxx**,如何显示为加粗?
** ** 是 Markdown 格式的加粗标识。可以在前端渲染大模型生成的内容时解析 Markdown 语法并做对应的渲染。知识库与 RAG
知识检索增强(RAG)适用于哪些场景?
知识检索增强(RAG)适用于哪些场景?
RAG 模型凭借其强大的检索与生成能力,在问答系统、对话系统、文本摘要、知识图谱构建与推理、教育与培训、客户服务、新闻与内容创作以及智能搜索与推荐等多个领域均有广泛应用。
RAG 应用测试时模型回复不准确,如何优化?
RAG 应用测试时模型回复不准确,如何优化?
可以点击模型回复内容下方的问题反馈按钮,勾选问题类型并提交。也可以复制 RequestId,通过提交阿里云工单反馈。
RAG 检索多个知识库时是并行还是串行?
RAG 检索多个知识库时是并行还是串行?
并行根据每个知识库的配置进行检索,然后再根据得分选取 TopN。
数据管理
上传文件报错:仅支持 pdf/doc/docx 文件(错误码 140010)
上传文件报错:仅支持 pdf/doc/docx 文件(错误码 140010)
上传的文件为 PDF 格式时,请确保文件后缀为小写
pdf。上传文件接口必填的 MD5 参数有什么作用?
上传文件接口必填的 MD5 参数有什么作用?
用来验证上传的文件是否完整。
结构化数据导入后数量少于源文件,是什么原因?
结构化数据导入后数量少于源文件,是什么原因?
请确认表格数据中是否存在空行。如果出现空行,后面的数据将不会被识别。如果第一行是空行,会认为是空文件。
Managed Agents
Managed Agents 支持哪些模型?
Managed Agents 支持哪些模型?
Managed Agents 支持阿里云百炼平台上的主流大语言模型,包括通义千问系列模型。具体支持的模型列表请在控制台创建 Agent 时查看可选模型。
Managed Agents 如何接入自定义 MCP 服务?
Managed Agents 如何接入自定义 MCP 服务?
在 Agent 配置页面的"工具"模块中,选择"MCP 服务"并填入 MCP 服务的 Endpoint 地址即可接入。详细步骤请参考 MCP 服务接入 文档。
CLI
为什么 CLI 调用模型没有扣减 Token Plan?
为什么 CLI 调用模型没有扣减 Token Plan?
当前生效的凭据是普通 API Key(
default Profile)。Token Plan 需使用订阅的 API Key 登录 token-plan Profile;可用 bl auth status --output json 查看当前生效的凭据来源。如何让 CLI 调用模型时使用 Token Plan?
如何让 CLI 调用模型时使用 Token Plan?
使用订阅 API Key 登录 Token Plan Profile:
bl auth login --config token-plan --api-key <sk-sp-Key>;已有该 Profile 时,用 bl config use --name token-plan 切换为当前生效配置。只配置 Token Plan API Key 能否使用全部 CLI 功能?
只配置 Token Plan API Key 能否使用全部 CLI 功能?
不能。模型调用类命令可用;控制台类命令(如
app list、usage free、workspace)需要先完成控制台登录(bl auth login --console),Token Plan 席位管理等命令还需要阿里云 OpenAPI AK/SK 凭据。如何查看和切换当前生效的 API Key?
如何查看和切换当前生效的 API Key?
执行
bl auth status --output json 查看当前凭据(脱敏输出);执行 bl config list 查看全部 Profile,bl config use --name <profile> 切换当前 Profile。