Agent Skills
返回列表
腾讯 IMA Hermes 知识管理

腾讯 IMA Hermes 知识管理

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-tencent-ima-hermes。

技能介绍

解决什么问题

腾讯 IMA 的官方 OpenAPI 包更适合“读 + 创建/追加”，但工程师常要把中文笔记、翻译文档、仓库用例批量落到知识库子文件夹，并确认文件真正入库。该技能将官方 v1.1.7 改造为 Hermes 风格，不改 API 端点和字段，但补齐 bin/ima CLI、凭证路径、upload-file 便利封装，并把 folder_id 命名空间、GATE3 查重、分页验证等实战约束写成可执行规则。

技能如何工作

  • 凭证检测：优先检查 IMA_OPENAPI_CLIENTID 与 IMA_OPENAPI_APIKEY，再看 .env 和配置文件，避免“文件不存在”导致的误报。
  • 批量入库：check-name 预检后，文件上传依次经过 check_repeated_names、create_media、COS 上传与 add_knowledge；browse-kb 的结果必须按 cursor 分页拿全后再计数。
  • 落点校验：上传后不只看 code:0，还要对比子文件夹条数，确认条目确实落到目标子文件夹，区分“后端接收成功”和“用户可见成功”。

适用边界与注意点

  • OpenAPI 不暴露稳定的删除、覆盖和可靠移动；move_knowledge 可能返回成功但实际不移动，误创空笔记可能需要手工清理。
  • 笔记模式会挂到 KB 根，无法进入子文件夹；要进入子文件夹应使用文件上传模式，并优先传 folder_ 前缀 ID。
  • upload-file 是新建而不是覆盖；重传同名或同内容可能产生两份，--force 只追加时间戳。
  • 写入 notes 必须处理 UTF-8，PowerShell 5.1 下尤其要把请求体显式转换为 UTF-8 字节。

使用场景

  • 把英文仓库文档翻译成中文后，按主题检查重复并批量上传到 IMA 子文件夹。
  • 上传前用 check-name 与内容查重确认同名/同内容是否已存在，避免知识库产生重复条目。
  • 调用 browse-kb 时按 cursor 分页拿全子文件夹条目，核验上传后是否真正落到目标目录。
  • 检测 IMA_OPENAPI_CLIENTID/APIKEY 是否在环境变量、.env 或配置文件中可用。

适合人员

  • 维护内部知识库的工程师，需要把批量文档稳定落到指定 IMA 子文件夹。
  • 做中英用例库的技术编辑，需要在上传前查重并保留 frontmatter 仓库来源。
  • 集成 IMA API 的 agent 开发者，需要处理凭证优先级、UTF-8 与错误码。
  • 运维自动化负责人，需要验证 CLI 子命令、分页查询与落点一致性。