在AI智能体里调用腾讯ima知识库中的资料，有一个关键前提：Agent必须原生支持ima Skill插件，才能实现结构化读取。

如果Agent不支持，只能靠简单地粘贴文本或手动上传资料。每次都要重复操作，知识也就无法沉淀和复用。

确认Agent是否支持ima Skill

目前，OpenClaw、Claude Code、WorkBuddy、Codex等主流Agent已经原生兼容ima Skill插件。

操作很简单：打开Agent的设置页，找到「插件管理」，搜索“ima”或“腾讯知识库”。

• 如果列表里出现这个插件，但状态显示“未启用”，说明支持。
• 如果完全搜不到，则需要把Agent升级到2026年5月之后的版本。

特别提醒：不支持的旧版Agent，即使填入API Key也无法调用文档内容，只会返回错误码20004。这是协议层不匹配导致的硬性限制，不是配置能解决的。这一步千万不能跳过。

获取并配置ima API凭证

方法一：网页控制台直接复制（推荐）

1. 访问 https://ima.qq.com/agent-interface，登录你的ima账号，进入「Agent接入」页面。
2. 点击「生成新凭证」，复制弹窗中的Client ID与API Key。
3. 在Agent插件配置界面粘贴，保存后，系统会自动校验连通性。

方法二：用VS Code手动保存（防BOM必选）

把Client ID和API Key分别写成两行，保存为UTF-8无BOM格式的ima_config.json文件。

注意：用记事本保存会自带BOM头，导致API调用失败。VS Code默认保存就是无BOM的；Sublime Text则需要手动选择“Save with Encoding → UTF-8”。

在对话中引用指定知识库内容

第一步：确认知识库已存在且有内容

登录ima网页端或小程序，进入目标知识库（比如“Q2项目复盘”）。检查右上角是否显示“已索引XX份文件”。

如果显示为0，说明文档还在处理中，需要等待3到8分钟，等索引完成。

第二步：在Agent对话框输入指令

直接输入类似这样的命令：@Q2项目复盘 请总结其中关于客户反馈的三点核心问题

关键点：知识库名称必须与ima后台显示的完全一致，包括大小写、空格、中文标点，否则无法命中。

第三步：验证调用结果

如果一切顺利，Agent应该返回一个结构化的摘要，并在末尾附带信源标记。例如：[来自ima知识库/Q2项目复盘/20260412会议纪要.pdf 第7页]。

如果只返回“未找到相关资料”，大概率是知识库名称拼错了，或者该文档还没完成向量化索引。

《夸克》非常好用的免费AI浏览器

下载APP查看