---
name: openakita/skills@tencent-ima
source: https://app.decimal.ai/s/openakita-skills-tencent-ima@1/SKILL.md
source_sha256: 0567a5b74100
---

# 腾讯 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。

```bash
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 封装。

```bash
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"
```