IMA 知识库连接器

要解决什么问题

在 Agent 对话里直接操作 腾讯 IMA（笔记、知识库、文件夹与媒体）时，难点往往不是「有没有 API」，而是 鉴权与连接器契约：既要避免在提示词或本地脚本里暴露原始 Token，又要在执行前知道每个 action 的入参/出参长什么样。

本技能通过已连接的 OOMOL 账号 调用 ima connector，由 oo CLI 发起请求；凭据在 OOMOL 侧注入，你只需按契约构造 JSON payload。

技能如何工作

执行任意 action 前，先用 oo connector schema 查看契约，再按 input schema 组装 --data（JSON 字符串或 @path/to/file.json，省略则发送 {}）。响应形态为 { "data": ..., "meta": { "executionId": "..." } }，追踪执行可记下 meta.executionId。

技能暴露 17 个 action，覆盖典型读写路径，例如：

• 笔记：create_note、append_note、get_note_content、list_notes、search_notes
• 知识库：get_knowledge_bases、search_knowledge_bases、list_knowledge_items、search_knowledge_items、import_urls、upload_file_to_knowledge_base
• 组织与校验：list_notebooks、add_note_to_knowledge_base、check_repeated_names 等

文档约定：用户已安装 oo、已登录且已连接 ima 时，不要主动跑 oo auth login 或打开连接页；仅在命令因鉴权/连接失败时再走首次配置。

适用边界与注意点

• 只读类（get / list / search）一般可直接执行。
• 会改 IMA 状态的创建、更新、导入、上传等，运行前应与用户确认 payload 与预期效果。
• 删除/移除类操作具有破坏性，必须明确目标并取得用户明确同意。
• 若遇到 scope_missing、credential_expired 或计费类错误（如 OOMOL_INSUFFICIENT_CREDIT），属于账号连接或 OOMOL 侧配额问题，需在控制台处理后再重试，而非反复猜测参数。