IMA 订阅知识库

管理 IMA 平台的订阅知识库——创建订阅型知识库并发布到广场、搜索发现公开知识库、加入订阅、管理订阅设置。

你的工作方式

根据用户意图路由：

API 调用方式

所有接口统一格式：

curl -s -X POST "https://ima.qq.com/openapi/wiki/v1/$endpoint" \
    -H "ima-openapi-clientid: $IMA_OPENAPI_CLIENTID" \
    -H "ima-openapi-apikey: $IMA_OPENAPI_APIKEY" \
    -H "Content-Type: application/json" \
    -d "$body"

参数详情见 references/api.md，调用前先读取该文件确认字段。

操作 1：创建订阅知识库

将知识库发布到广场，让其他人可以搜索到并加入。

步骤

1. 收集信息 — 确认用户要创建的订阅知识库名称（必填）。可选：简介、封面URL、推荐问题（最多3个）
2. 确认 — 向用户展示将要创建的信息，特别说明"订阅知识库会发布到知识库广场，可被其他用户搜索和加入"
3. 创建 — 调用 create_knowledge_base，type 设为 1004（订阅型）
4. 设置加入方式 — 创建后，询问用户希望其他人如何加入：
• 直接加入（join_type=1）
• 管理员批准（join_type=2）
• 默认为直接加入，若用户未指定则不额外设置
5. 告知结果 — 返回知识库 ID 和名称

示例

用户: "创建一个叫'公文写作素材库'的订阅知识库，简介是每天更新公文素材"

→ 调用 create_knowledge_base(name="公文写作素材库", description="每天更新公文素材", type=1004)
→ 返回: 已创建订阅知识库"公文写作素材库"，ID: xxx，已发布到广场

操作 2：搜索广场

在知识库广场发现公开的订阅知识库。

步骤

1. 确认搜索词 — 用户给关键词则直接用，未给则询问想找什么类型的知识库
2. 搜索 — 调用 search_knowledge_base_in_square，limit 设为 20
3. 展示结果 — 列出知识库名称、创建者、成员数、内容数
4. 追问 — 询问用户是否要加入某个知识库，如果是则进入操作 3

展示格式

找到 N 个知识库：

1. 📚 公文写作素材库 — by 张三 | 1256 成员 | 342 篇内容
2. 📚 AI行业周报 — by 李四 | 890 成员 | 56 篇内容
3. ...

操作 3：加入订阅知识库

加入广场上的订阅知识库。

步骤

1. 获取 kb_id — 两种来源：
• 从搜索广场结果中获得
• 用户直接提供了知识库名称，则先调用 search_knowledge_base_in_square 查找
2. 确认 — 告知用户即将加入的知识库名称，等待确认（因为加入操作不可逆）
3. 加入 — 调用 join_knowledge
4. 告知结果 — 成功则提示用户可以在对话中 @该知识库 来搜索内容

操作 4：查看我的订阅

查看用户已创建或已加入的订阅知识库。

步骤

1. 查询 — 调用 search_knowledge_base(query="", query_user=true)
2. 筛选 — 从返回结果中筛选 base_type 为"我创建的订阅"或"我加入的订阅"的条目
3. 展示 — 按创建/加入分组列出

展示格式

📂 我创建的订阅：
  • 公文写作素材库 — 1256 成员 | 342 篇内容

📥 我加入的订阅：
  • AI行业周报 — 890 成员 | 56 篇内容
  • 产品经理知识库 — 567 成员 | 128 篇内容

若无订阅知识库，提示用户可以去广场搜索发现。

操作 5：管理订阅设置

修改已创建的订阅知识库的设置。

常见操作

步骤

1. 定位知识库 — 通过 search_knowledge_base 找到用户要修改的订阅知识库 ID
2. 确认修改内容 — 向用户确认要改什么、改成什么
3. 执行 — 调用对应接口
4. 告知结果

注意事项

• 所有写入操作不可逆（API 无删除能力），操作前务必与用户确认
• 知识库 ID 必须原样使用，禁止格式修改
• 搜索广场最多翻页 5 次（约 100 条），避免无限循环
• 加入知识库前，需要先通过广场搜索获取 kb_id
• 订阅知识库的 type 固定为 1004，不要传错