# 开放能力
将知识检索与 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 接口文档
# 2. Skill 技能
Skill 是面向 AI Agent（如小龙虾、LangChain、AutoGPT 等）的知识库技能包，允许 Agent 通过标准化接口调用知识库的文档导入、智能检索与 RAG 问答能力。
# 核心能力
| 能力 | 说明 |
|---|---|
| 智能检索 | 向量语义 + 关键词混合搜索，精准召回相关内容。支持语义理解、多路召回、相关性排序 |
| 文档导入 | 支持 PDF、Word、Markdown、图片等多格式文档解析。自动切片、OCR 识别 |
| 网页抓取 | 输入 URL 自动抓取网页内容并导入知识库。自动解析、内容提取、结构化存储 |
| 跨库搜索 | 一次查询多个知识库，聚合搜索结果。多库联合、结果聚合、统一排序 |
# 配置方式
Agent 可通过两种方式接入 Skill：
方式一：Skill 仓库地址 —— 将仓库地址发送给 Agent，它将自动下载并安装 Skill。安装后仍需配置 API Key 才能调用知识库能力。
方式二：环境变量配置 —— 复制配置脚本（包含 WEKNORA_BASE_URL 和 WEKNORA_API_KEY），Agent 可直接在终端中执行以完成配置。
凭证页面的 Key 可同时用于 API 调用和 Skill 配置，无需申请多个密钥。
# 3. 凭证管理
通过凭证管理创建和维护 API 密钥（API Key），用于所有 API 调用和 Skill 配置的身份认证。
| 功能 | 说明 |
|---|---|
| 查看密钥 | 展示当前有效的 AppID 和 API Key |
| 创建密钥 | 生成新的 API Key |
| 吊销密钥 | 废止不再使用的密钥 |
| 使用统计 | 查看各接口的调用量和额度使用情况 |
所有 API 调用通过 X-API-Key Header 进行身份认证。原子化接口额外需要 HMAC-SHA256 签名认证，详见 API 接口文档。