知识库接口与访问权限
大约 2 分钟知识检索操作指南
功能概述
知识库工作区的 API 页签展示当前知识库的调用地址、参数示例和在线调试。外部系统使用 API 密钥调用，资源权限与密钥作用域共同决定可访问范围。
1. 查看接口
进入知识库 API 页签，选择接口及 cURL、JavaScript 或 Python 示例。示例中的知识库标识由当前资源自动填入，接入时替换为调用方的服务地址与资源标识。截图中的 localhost:1888 为本地部署地址。
| 接口 | 用途 |
|---|---|
| POST /v1/rag/lite-search | 返回便于拼接的检索文本 |
| POST /v1/rag/search | 返回分段、评分和来源信息 |
| POST /v1/rag/chat | 使用知识库模型，根据传入命中内容回答 |
2. 签发密钥
通过 管理密钥 或 密钥 页签进入当前知识库的资源密钥管理，按调用方签发密钥。密钥明文只在签发成功时显示一次，请保存到调用方的服务端配置中。资源密钥只能调用所属知识库；平台级集成使用 超级密钥。
请求顺序
外部系统接入知识问答时，先调用检索接口，再将命中结果填入问答接口的 sources。问答接口依据传入的 sources 回答，不会自行检索。
3. 配置调用
检索请求填写 knowledgeIds、text，按需要指定 maxResults 与 minSimilarity。带评分结果用于展示出处和调试；问答请求填写 knowledgeId、messages、sources，按需要开启 stream。
请求头统一为：
Authorization: Bearer <API_KEY>
Content-Type: application/json完整协议与示例见技术手册 知识检索与问答。
4. 设置访问范围
登录运行页、匿名分享与 API 调用是三个独立入口：开放 API 开关决定该知识库能否通过接口调用；匿名访问单独配置，与 API 密钥及工作区登录状态无关。工作区右上 运行 打开的是登录运行页，需登录后访问。