perinchiang--all-in-one-llm-wiki/docs/methods/ima-usage.md

IMA 知识库集成

将腾讯 IMA 知识库中的数据导入 LLM Wiki,让 Agent 能搜索你订阅的公域知识库。

前置条件

1. 注册腾讯 IMA 账号:访问 ima.qq.com 下载客户端
2. 获取 API 凭证:在 ima.qq.com/agent-interface 生成 Client ID 和 API Key
3. 安装 IMA 技能到你的 Agent(参考 SKILL.md)

配置凭证

将凭证写入配置文件:

mkdir -p ~/.config/ima
echo "your_client_id" > ~/.config/ima/client_id
echo "your_api_key" > ~/.config/ima/api_key
chmod 600 ~/.config/ima/api_key ~/.config/ima/client_id

或通过环境变量:

export IMA_OPENAPI_CLIENTID="your_client_id"
export IMA_OPENAPI_APIKEY="your_api_key"

浏览和订阅公域知识库

在 IMA 桌面客户端进入「知识库广场」,搜索感兴趣的公域知识库并订阅。

推荐搜索方向:

方向	推荐关键词	说明
生活技巧	菜谱 烘焙 收纳 家居	厨房技巧、生活百科
AI	AI Agent 大模型 提示词	行业资料、工具评测
编程	Python JavaScript 算法	教程、代码库
阅读	书单 电子书 TED	书单推荐、演讲笔记
旅行	攻略 路线 citywalk 美食	出行指南、城市漫步

将 IMA 集成到 LLM Wiki

查询 IMA 知识库

Agent 可通过 IMA API 搜索已订阅知识库中的内容:

# 搜索菜谱知识库
ima_api "openapi/wiki/v1/search_knowledge" '{
  "query": "红烧肉",
  "knowledge_base_id": "<kb_id>",
  "cursor": ""
}'

# 搜索旅行攻略库
ima_api "openapi/wiki/v1/search_knowledge" '{
  "query": "citywalk",
  "knowledge_base_id": "<kb_id>",
  "cursor": ""
}'

自动清洗到 Wiki

在 LLM Wiki 的 entities/ 目录下创建索引页 pat-ima-subscriptions.md:

---
title: IMA 知识库订阅索引
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity
tags: [ima, knowledge-base, subscription]
sources: []
confidence: high
---

# IMA 知识库订阅索引

| 知识库 | 文件数 | 说明 |
|--------|--------|------|
| 菜谱大全 | 500+ | 中餐/西餐/烘焙/甜品做法 |
| 旅行攻略 | 300+ | 国内外城市漫步/美食探店 |
| AI 前沿 | 200+ | 大模型/Agent/工具评测 |

定时同步

设置每周定时任务,让 Agent 自动搜索 IMA 知识库中的新内容,写入 WASH 总结:

🌐 每周自动循环
  ↓
IMA 知识库搜索 → 提取新内容 → 更新 Wiki 索引 → 刷新 Agent 画像

支持的 API

功能	API	说明
列出知识库	search_knowledge_base	搜索已订阅/创建的知识库
知识库搜索	search_knowledge	在指定知识库内搜索内容
浏览内容	get_knowledge_list	浏览知识库目录结构
添加网页	import_urls	添加网页到知识库
上传文件	create_media → COS → add_knowledge	上传文件到知识库
新建笔记	import_doc	创建新笔记
追加笔记	append_doc	追加内容到已有笔记

隐私说明

• API Key 仅用于 IMA 官方接口认证,只发送到 ima.qq.com
• 公域知识库数据来自其他用户的公开分享,导入 Wiki 后按 .gitignore 规则管理
• 建议在 log.md 中记录每次导入的来源和时间