腾讯 IMA 知识库
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_58d6e673/ima-knowledge-base-skill。
技能介绍
要解决什么问题
你在对话里提到「把这份 PDF 丢进 IMA 知识库」或「在某个库里搜一下上周的会议纪要」,助手若没有对接 腾讯 IMA 的开放接口,就只能让你自己去网页或桌面端操作。本技能把 读取 与 写入 知识库的能力收敛到一组 Python 脚本和明确的接口决策表,让 Agent 按用户意图调用 search_knowledge_base、get_knowledge_list、upload_file.py 等,而不是凭空编造库名或媒体 ID。
技能如何工作
凭证通过环境变量 IMA_CLIENT_ID / IMA_API_KEY,或 ~/.config/ima/ 下的纯文本文件提供;缺失时脚本会返回明确提示,Agent 须如实转告用户去 agent-interface 开通,不得猜测。
ima_api.py:封装https://ima.qq.com/openapi/wiki/v1,统一 JSON 响应{"code": 0, ...},code≠0时把msg直接给用户。upload_file.py:本地上传走完整链路(类型与大小校验 → 重名检查 → 创建媒体 → COS 上传 → 入库),默认拦截重名;可用--keep-both、--skip-if-exists。- 意图映射:空 query 列出自己的知识库;浏览用
get_knowledge_list(可带folder_id);库内检索用search_knowledge;读原文用get_media_info;网页/微信链接受import_urls;笔记用add_knowledge(media_type=11)。用户已指定知识库名称时,不要再调get_addable_knowledge_base_list。 - 分页:列表类接口用游标
cursor,根据is_end与next_cursor翻页直到结束。
面向用户的反馈应结构化(库名、标题、描述、文件数等),且不暴露 knowledge_base_id / media_id / folder_id;上传标题必须等于原文件名(含扩展名)。
适用边界与注意点
- 不支持的类型(视频、B 站/YouTube URL、
file://等)须 直接拒绝,引导用 IMA 桌面客户端,不要问「是否仍要尝试」。 - 单文件大小:Excel/TXT/Xmind/Markdown ≤10MB,图片 ≤30MB,PDF/Word/PPT/音频 ≤200MB;音频超过 2 小时官方不支持。
- 脚本只访问
ima.qq.com与腾讯云 COS 官方域名;凭证仅在内存使用,不写入日志。
使用场景
- 已在 IMA 开通 API,需要在对话里按名称查找目标知识库并列出其中的文件夹与条目
- 把本地 Markdown 或 PDF 上传到指定知识库,且上传前要先做重名检查并按官方大小限制校验
- 在某一知识库内按关键词检索文档,再拉取单篇媒体的原文用于摘要或比对
- 将一批网页或微信文章链接导入到指定知识库的某个文件夹(`import_urls` 需正确的 folder 上下文)
适合人员
- 已在 ima.qq.com 开通 Client ID 与 API Key、希望用助手代替网页端做库内检索与导入的教研/文档维护者
- 经常把合同、规范 PDF 从本机归档到 IMA 指定库、且对重名与文件类型限制较敏感的法务/合规协作人员
- 负责运营知识库结构(文件夹命名、分批导入外链)但需要 Agent 按接口表选对 API、不泄露内部 ID 的知识库管理员
- 在 Cursor/Claude 等环境里编排自动化、要把 IMA 当作团队外部记忆源的集成工程师