openakita-skills-tencent-ima

name	openakita/skills@tencent-ima
description	Tencent IMA OpenAPI skill for notes and knowledge base management. Use when user mentions knowledge base, notes, memos, file uploads, web page collection, or knowledge search. Supports notes CRUD, knowledge base file upload, web link addition, and content search.
license	MIT
metadata	{"author":"tencent-ima","version":"1.1.2"}
requires	{"env":["IMA_OPENAPI_CLIENTID","IMA_OPENAPI_APIKEY"]}

腾讯 IMA 智能工作台

统一的 IMA OpenAPI 技能，支持笔记管理和知识库操作。

配置

1. 打开 https://ima.qq.com/agent-interface 获取 Client ID 和 API Key
2. 存储凭证：

方式 A — 配置文件： mkdir -p ~/.config/ima echo "your_client_id" > ~/.config/ima/client_id echo "your_api_key" > ~/.config/ima/api_key

方式 B — 环境变量： export IMA_OPENAPI_CLIENTID="your_client_id" export IMA_OPENAPI_APIKEY="your_api_key"

API 调用模板

ima_api() { local path="$1" body="$2" curl -s -X POST "https://ima.qq.com/$path"
-H "ima-openapi-clientid: $IMA_CLIENT_ID"
-H "ima-openapi-apikey: $IMA_API_KEY"
-H "Content-Type: application/json"
-d "$body" }

模块决策表

用户意图	模块
搜索/浏览/创建/编辑笔记	notes
上传文件/添加网页/搜索知识库	knowledge-base

预置脚本

scripts/ima_notes.py

IMA 笔记 API 封装，需设置 IMA_OPENAPI_CLIENTID 和 IMA_OPENAPI_APIKEY。

python3 scripts/ima_notes.py search "会议纪要"
python3 scripts/ima_notes.py folders
python3 scripts/ima_notes.py create --content "# 新笔记\n内容"
python3 scripts/ima_notes.py read --doc-id xxx

scripts/ima_kb.py

IMA 知识库 API 封装。

python3 scripts/ima_kb.py search --kb-id xxx "关键词"
python3 scripts/ima_kb.py browse --kb-id xxx
python3 scripts/ima_kb.py import-url --kb-id xxx --url "https://example.com"