腾讯 IMA 知识库

解决的问题

很多文档、网页、微信文章分散在本地目录或浏览器收藏里，模型很难直接基于这些材料回答。这个技能把腾讯 IMA 知识库作为可读写接口，让调用方能按关键词检索知识库、浏览文件夹和文件，并把新的文件/网页写入指定知识库。

工作方式

技能基于 IMA OpenAPI，所有请求均为 HTTP POST + JSON，路径前缀为 /openapi/wiki/v1/。凭证由 get-token.ps1 或 get-token.sh 自动处理，可优先走平台代理，其次读环境变量，最后读配置文件。

核心能力包括：

• 读取：用 search_knowledge 搜索内容，用 get_knowledge_list 浏览知识库/文件夹，用 search_knowledge_base 按名称查找知识库。
• 写入：上传文件走 create_media → COS 上传 → add_knowledge；添加网页或微信文章使用 import_urls。
• 批量上传：脚本可扫描目录或按文件列表上传，支持递归、扩展名过滤和结果汇总。

适用边界

上传支持 .pdf、Office 文档、.md、图片、.txt、音频等类型，不同文件大小限制不同。视频文件、部分在线视频页面和 file:// 本地 HTML 不支持。展示结果时应使用知识库名称和文件标题，避免暴露 kb_id、media_id、folder_id 等内部字段。