# 开放能力 > 将知识检索与 AI 推理能力以 API 形式对外开放，赋能业务系统集成与 AI Agent 调用 --- ## 功能概览 知识助理的开放能力分为三个部分：**API 接口**、**Skill 技能**和**凭证管理**。 - **API 接口** —— 提供原子化能力接口和知识库维护接口两类 API，供开发者集成到自有系统 - **Skill 技能** —— 面向 AI Agent 的知识库技能包，让 Agent 能直接调用知识库的检索和问答能力 - **凭证管理** —— 管理 API 密钥，所有 API 调用和 Skill 配置共用同一套凭证 ## 1. API 接口 API 接口分为两类，面向不同的使用场景： ### 原子化能力接口 独立计费，按用量结算。将 AI 底层能力拆解为可独立调用的原子接口： | 接口 | 说明 | 计费额度 | |------|------|----------| | **推理模型** | LLM/VLM 对话推理接口，支持多轮对话和流式输出 | 500 次/月 | | **文档解析** | 解析 PDF、Word、图片等多格式文档，提取结构化内容 | 200 次/月 | | **Embeddings** | 将文本转换为高维向量表示，用于语义搜索和相似度计算 | 10,000 次/月 | | **Rerank** | 对检索结果进行智能重排序，提升搜索精准度 | 5,000 次/月 | 以上为限免试用额度，可申请提升限额。 ### 知识库维护接口 管理知识库与文档，**无调用限额**，可放心使用： | 接口 | 方法 | 说明 | |------|------|------| | **创建知识库** | `POST` | 新建一个知识库空间 | | **更新知识库** | `PUT` | 修改知识库名称、描述等属性 | | **删除知识库** | `DELETE` | 永久删除知识库及其全部文档 | | **文档管理** | `GET` | 获取知识库下的文档列表 | | **文档上传** | `POST` | 上传文档到指定知识库 | > 完整的接口参数、请求示例和响应格式，请参见 [API 接口文档](/doc/aispeech/knowledge/openapi/general_info) ## 2. Skill 技能 Skill 是面向 AI Agent（如小龙虾、LangChain、AutoGPT 等）的**知识库技能包**，允许 Agent 通过标准化接口调用知识库的文档导入、智能检索与 RAG 问答能力。 ### 核心能力 | 能力 | 说明 | |------|------| | **智能检索** | 向量语义 + 关键词混合搜索，精准召回相关内容。支持语义理解、多路召回、相关性排序 | | **文档导入** | 支持 PDF、Word、Markdown、图片等多格式文档解析。自动切片、OCR 识别 | | **网页抓取** | 输入 URL 自动抓取网页内容并导入知识库。自动解析、内容提取、结构化存储 | | **跨库搜索** | 一次查询多个知识库，聚合搜索结果。多库联合、结果聚合、统一排序 | ### 配置方式 Agent 可通过两种方式接入 Skill： **方式一：Skill 仓库地址** —— 将仓库地址发送给 Agent，它将自动下载并安装 Skill。 ``` https://clawhub.ai/lyingbug/weknora ``` 安装后仍需配置 API Key 才能调用知识库能力。 **方式二：环境变量配置** —— 复制配置脚本，Agent 可直接在终端中执行以完成配置。 ```bash export WEKNORA_BASE_URL="https://weknora.weixin.qq.com/api/v1" export WEKNORA_API_KEY="your-api-key" ``` > 凭证页面的 Key 可同时用于 API 调用和 Skill 配置，无需申请多个密钥。 ## 3. 凭证管理 通过凭证管理创建和维护 API 密钥（API Key），用于所有 API 调用和 Skill 配置的身份认证。 | 功能 | 说明 | |------|------| | **查看密钥** | 展示当前有效的 AppID 和 API Key | | **创建密钥** | 生成新的 API Key | | **吊销密钥** | 废止不再使用的密钥 | | **使用统计** | 查看各接口的调用量和额度使用情况 | 所有 API 调用通过 `X-API-Key` Header 进行身份认证。原子化接口额外需要 HMAC-SHA256 签名认证，详见 [API 接口文档](/doc/aispeech/knowledge/openapi/authorization_token)。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条） 2026 年 04 月 13 日skill 描述优化