Agent 开发常见问题 - 千问AI平台

知识库与 RAG

知识检索增强（RAG）适用于哪些场景？

RAG 在问答系统、对话系统、文本摘要、知识图谱构建与推理、教育与培训、客户服务、新闻与内容创作以及智能搜索与推荐等领域都有应用。

RAG 应用测试时模型回复不准确，如何优化？

可以点击模型回复内容下方的问题反馈按钮，勾选问题类型并提交。调优思路见 RAG 效果优化。

RAG 检索多个知识库时是并行还是串行？

并行。先按每个知识库各自的配置检索，再根据得分选取 TopN。

上传文件报错：仅支持 pdf/doc/docx 文件（错误码 140010）

上传的文件为 PDF 格式时，请确保文件后缀为小写 pdf。

上传文件接口必填的 MD5 参数有什么作用？

用来验证上传的文件是否完整。

结构化数据导入后数量少于源文件，是什么原因？

请确认表格数据中是否存在空行。如果出现空行，后面的数据将不会被识别；如果第一行是空行，会被当成空文件。

Managed Agent 支持哪些模型？

Managed Agent 支持千问AI平台上的主流大语言模型，包括通义千问系列。具体列表请在控制台创建 Agent 时查看可选模型。

Managed Agent 如何接入自定义 MCP 服务？

在 Agent 配置页面的工具模块中选择 MCP 服务，填入 MCP 服务的 Endpoint 地址即可。详细步骤见在 Agent 中使用 MCP。

无法连接 MCP 服务怎么办？

先确认三件事：MCP 服务已在 MCP 广场开通或升级到新版 Streamable HTTP 协议；使用的是有效的千问AI平台 API Key；服务额度未用尽（部分 MCP 如联网搜索增强版有每月额度限制）。更多报错见 MCP 常见问题。