> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Knowledge Base

> 配置一个对现有知识库执行语义、关键词或混合搜索并存储结果的工作流步骤

# Search Knowledge Base

当你希望工作流步骤查询某个知识库并将匹配的分块传递给后续步骤(例如,将检索到的上下文输入 AI Prompt 步骤)时,请使用 **Search Knowledge Base**。

## 配置

| 选项                  | 是否必填 | 说明                                                             |
| ------------------- | ---- | -------------------------------------------------------------- |
| Name                | 否    | 步骤在工作流画布中的标签。                                                  |
| Knowledge Base      | 是    | 要搜索的知识库,在 **Knowledge Base** 中选择。                              |
| Search Query        | 是    | 查询字符串。此字段通过 **Insert Variable** 支持工作流变量。                       |
| Search Type         | 否    | **Hybrid**、**Semantic** 或 **Keyword** 之一。默认为 **Hybrid**。       |
| Result Limit        | 否    | 要返回的匹配分块的最大数量(1–20,默认 5)。                                      |
| Score Threshold     | 否    | 包含结果所需的最低相关性分数(0.0–1.0,默认 0.0)。值为 0.0 时,无论分数如何,都返回直至限制数量的所有结果。 |
| When the step fails | 否    | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。           |

### Search Type

* **Hybrid** — 结合向量相似度和关键词匹配。推荐用于大多数查询。
* **Semantic** — 纯向量相似度搜索。最适合概念性或自然语言查询。
* **Keyword** — 全文关键词搜索。最适合精确匹配或结构化查询。

### Result Limit

控制返回多少分块。更高的限制会增加下游步骤可用的上下文,但也可能增加噪声。滑块接受 1 到 20 之间的值。

### Score Threshold

过滤低相关性的结果。提高此值(接近 1.0)以仅返回高度可信的匹配。保留为 0.0 可返回直至限制数量的所有结果。

## 输出

此步骤返回来自知识库的匹配分块:

```json theme={null}
[
  {
    "content": "...",
    "score": 0.87,
    "metadata": { ... }
  },
  ...
]
```

在后续步骤中引用整个结果集:

```text theme={null}
{{step_2.output}}
```

一种常见模式是将输出直接作为上下文传递给 AI Prompt 步骤:

```text theme={null}
Answer the following question using only the context below.

Context:
{{step_2.output}}

Question: {{start.query}}
```

## 费用

此步骤每次运行消耗 **1 task**。

## 示例

从 **Search steps...** 的 **Knowledge Base** 分组中添加 **Search Knowledge Base**。

将 **Knowledge Base** 设置为你要查询的知识库。

在 **Search Query** 中输入用户的问题,或从起始输入插入变量:`{{start.question}}`。

除非你有特定理由偏好纯语义或关键词搜索,否则将 **Search Type** 保留为 **Hybrid**。

调整 **Result Limit** 以控制返回多少分块。从 5 开始,如果答案看起来不完整,则增加。

如果你想排除低置信度的匹配,将 **Score Threshold** 设置为 0.5 或更高。

点击步骤标题中的 **Run** 来测试搜索。在 **Output** 中查看返回的分块,然后将输出连接到 AI Prompt 步骤以生成答案。

{/* Add screenshot: Search Knowledge Base settings showing result limit and score threshold sliders */}

## 备注

* 如果步骤设置保持默认值,有效搜索类型会回退到知识库自身的默认值。
* 分数值已归一化到 0–1 范围。具体含义取决于底层嵌入模型和搜索后端。
* 搜索查询和结果会作为知识库搜索审计记录被记录,以供监控。

另见:[Write to Knowledge Base](./write-knowledge-base)、[AI Prompt](../ai/ai-prompt)、[创建和编辑](../../creating-and-editing)、[测试与迭代](../../testing-and-iteration) 和 [错误处理](../../error-handling)