---
title: "知识库检索"
method: POST
path: "/llm-application/open/knowledge/retrieve"
tags: ["知识库 API"]
---

# 知识库检索

`POST /llm-application/open/knowledge/retrieve`

用于检索个人知识库，支持向量检索、关键词检索、混合检索，支持自定义重排模型。点击 **Try it** 按钮可快速试用。

## Request body

- KnowledgeRetrieveRequest
  - `request_id` string — 请求唯一id，用于定位日志
  - `query` string, required — 查询内容，限制在1000字以内
  - `knowledge_ids` string[], required — 知识库ID列表
  - `document_ids` string[] — 文档ID列表
  - `top_k` integer — 最终召回数量，取值范围为[1~20]，默认为8
  - `top_n` integer — 初始召回数量，取值范围为[1~100]，默认为10
  - `recall_method` 'embedding' | 'keyword' | 'mixed' — 检索类型 - embedding: 向量化检索 - keyword:关键词检索 - mixed: 混合检索（默认）
  - `recall_ratio` integer — 混合检索中向量检索的权重，取值范围(0~100)，默认为80
  - `rerank_status` 0 | 1 — 是否开启重排，0: 不开启，1: 开启，默认不开启
  - `rerank_model` 'rerank' | 'rerank-pro' — 重排模型，支持rerank、rerank-pro
  - `fractional_threshold` number — 相似度阈值，低于该阈值的切片会被过滤，取值范围为(0~1)

## Response `200`

业务处理成功

- KnowledgeRetrieveResponse
  - `data` object[] — 检索结果列表
    - `text` string — 切片内容
    - `score` number — 相似度分数
    - `metadata` object — 切片元数据
      - `_id` string — 切片ID
      - `knowledge_id` string — 知识库ID
      - `doc_id` string — 文档ID
      - `doc_name` string — 文档名称
      - `doc_url` string — 文档URL
      - `contextual_text` string — 上下文增强内容，不开启上下文增强则为空
  - `code` integer — 响应码，200为成功
  - `message` string — 响应信息
  - `timestamp` integer — 响应时间戳

## Other responses

- `default` — 请求失败。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)