要在AI智能体中调用腾讯ima知识库，需确保Agent原生支持ima Skill插件（如OpenClaw等），通过插件管理启用；配置UTF-8无BOM的API凭证后，在对话中严格按后台名称输入@知识库名+指令，方可获取带信源标记的结构化结果。

要在AI智能体中调用腾讯ima知识库里的资料，必须让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页]。若只返回“未找到相关资料”，大概率是知识库名拼错或该文档尚未完成向量化索引。