---
pkg: "@nocobase/plugin-ai-knowledge-base"
title: "Nodo de base de conocimientos de IA - Recuperar documento"
description: "Recupera fragmentos de documentos y pásalos a nodos de empleado de IA posteriores."
keywords: "AI knowledge base,workflow,retrieve document,AI employee,RAG,NocoBase"
---

# Recuperar documento

<PluginInfo name="ai-knowledge-base"></PluginInfo>

## Introduction

In NocoBase, the **Retrieve document** node searches an AI knowledge base in a workflow and returns matched document snippets. It is suitable before an AI employee node: retrieve knowledge base snippets with task input first, then pass the results to the AI employee as task context.

The Retrieve document node is asynchronous. Before using it, configure the knowledge base and make sure it already contains vectorized documents.

## Workflow structure

The example workflow listens for new records in `Questions`, sends matching text to `Retrieve document`, and passes the retrieval result to a downstream `AI employee` node for task processing.

![](https://static-docs.nocobase.com/ai-employees/workflow/knowledge/2026-06-12/kb-retrieve-overview.png)

Where:

- `Collection event` receives task input
- `Retrieve document` retrieves snippets from the knowledge base
- `AI employee` processes the task based on snippets

In real business workflows, the result generated by the AI employee usually needs to be saved. You can continue with database operation nodes after it. This guide omits those later saving steps to focus on the Retrieve document node.

## Before you start

This example is an independent retrieval workflow. Before configuring it, confirm that:

- The knowledge base already contains vectorized documents. For document maintenance, see [Knowledge base overview](../../../knowledge-base/knowledge-base) and [Create document](./create-document)
- A data source for matching text is ready. The example uses the `Questions` collection
- A usable downstream AI employee node is ready. See [AI employee node](../employee/configuration)

## Configure the trigger

Select `Collection event` as the trigger. In the trigger configuration:

- Set `Collection` to the matching-text source collection, such as `Main / Questions`
- Set `Trigger on` to `After record added`

![](https://static-docs.nocobase.com/ai-employees/workflow/knowledge/2026-06-12/kb-retrieve-trigger-config.png)

Each time an input record is added, the workflow automatically enters retrieval and task processing.

## Configure the Retrieve document node

Add a `Retrieve document` node after the trigger. It is recommended to change the node key to an easy-to-reference name, such as `retrieve_docs`.

![](https://static-docs.nocobase.com/ai-employees/workflow/knowledge/2026-06-12/kb-retrieve-node-config.png)

Key settings:

- Select one or more knowledge bases in `Knowledge base`
- Set `Input matching text` to the matching text field
- Set `Top K` to the maximum number of snippets to return
- Set `Score` to the minimum similarity threshold

After execution, the node returns an array of document snippets. Each result contains `id`, `content`, `score`, and `metadata`, sorted by `score` from high to low.

## Pass the result to the AI employee node

In the `AI employee` node, write the retrieval result into the prompt. The example directly references the Retrieve document node output:

```text
Task input: {{$context.data.f_b2izf5j4xx0}}

Knowledge base snippets:
{{$jobsMapByNodeKey.retrieve_docs}}

Use the snippets as context to complete the task. If the snippets are not enough, explain what information is missing.
```

![](https://static-docs.nocobase.com/ai-employees/workflow/knowledge/2026-06-12/kb-retrieve-ai-employee-config.png)

`retrieve_docs` is the key of the retrieval node. If your node key is different, replace it with the actual key.

:::tip

If you only want to pass snippet text, reference the `content` field in the retrieval result through the variable selector. Passing the whole result array also includes `score` and `metadata`, which helps the AI judge source and relevance.

:::
