> ## 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

> Configura un paso del flujo de trabajo que ejecuta una búsqueda semántica, por palabra clave o híbrida en una base de conocimientos existente y almacena los resultados

# Search Knowledge Base

Usa **Search Knowledge Base** cuando quieras que un paso del flujo de trabajo consulte una de tus bases de conocimientos y pase los fragmentos coincidentes a pasos posteriores — por ejemplo, alimentando el contexto recuperado a un paso de AI Prompt.

## Configuración

| Opción              | Requerido | Descripción                                                                                                                                                                                            |
| ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Name                | No        | Etiqueta del paso en el lienzo del flujo de trabajo.                                                                                                                                                   |
| Knowledge Base      | Sí        | La base de conocimientos a buscar, seleccionada en **Knowledge Base**.                                                                                                                                 |
| Search Query        | Sí        | La cadena de consulta. Este campo admite variables del flujo de trabajo mediante **Insert Variable**.                                                                                                  |
| Search Type         | No        | Una de **Hybrid**, **Semantic** o **Keyword**. Por defecto es **Hybrid**.                                                                                                                              |
| Result Limit        | No        | Número máximo de fragmentos coincidentes a devolver (1–20, predeterminado 5).                                                                                                                          |
| Score Threshold     | No        | Puntuación mínima de relevancia requerida para incluir un resultado (0.0–1.0, predeterminado 0.0). Un valor de 0.0 devuelve todos los resultados hasta el límite, independientemente de la puntuación. |
| When the step fails | No        | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla.                                                                                                         |

### Search Type

* **Hybrid** — Combina la similitud vectorial y la coincidencia por palabra clave. Recomendado para la mayoría de las consultas.
* **Semantic** — Búsqueda pura por similitud vectorial. Mejor para consultas conceptuales o en lenguaje natural.
* **Keyword** — Búsqueda de texto completo por palabra clave. Mejor para consultas de coincidencia exacta o estructuradas.

### Result Limit

Controla cuántos fragmentos se devuelven. Límites más altos aumentan el contexto disponible para los pasos posteriores, pero también pueden aumentar el ruido. El deslizador acepta valores de 1 a 20.

### Score Threshold

Filtra los resultados de baja relevancia. Aumenta este valor (hacia 1.0) para devolver solo coincidencias con alta confianza. Déjalo en 0.0 para devolver todos los resultados hasta el límite.

## Salida

Este paso devuelve los fragmentos coincidentes de la base de conocimientos:

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

Referencia el conjunto completo de resultados en un paso posterior:

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

Un patrón común es pasar la salida directamente a un paso de AI Prompt como contexto:

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

Context:
{{step_2.output}}

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

## Costo

Cada ejecución de este paso cuesta **1 task**.

## Ejemplo

Agrega **Search Knowledge Base** desde el grupo **Knowledge Base** en **Search steps...**.

Establece **Knowledge Base** con la base de conocimientos que quieres consultar.

Ingresa la pregunta del usuario en **Search Query**, o inserta una variable desde una entrada inicial: `{{start.question}}`.

Deja **Search Type** como **Hybrid** a menos que tengas una razón específica para preferir la búsqueda puramente semántica o por palabra clave.

Ajusta **Result Limit** para controlar cuántos fragmentos se devuelven. Comienza con 5 y aumenta si las respuestas parecen incompletas.

Establece **Score Threshold** en 0.5 o más si quieres excluir las coincidencias de baja confianza.

Haz clic en **Run** en el encabezado del paso para probar la búsqueda. Revisa los fragmentos devueltos en **Output** y, a continuación, conecta la salida a un paso de AI Prompt para generar una respuesta.

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

## Notas

* El tipo de búsqueda efectivo recurre al valor predeterminado de la propia base de conocimientos si la configuración del paso se deja con su valor predeterminado.
* Los valores de puntuación están normalizados al rango 0–1. El significado exacto depende del modelo de embeddings subyacente y del backend de búsqueda.
* Las consultas y los resultados de búsqueda se registran como registros de auditoría de búsqueda de la base de conocimientos para monitoreo.

Consulta también: [Write to Knowledge Base](./write-knowledge-base), [AI Prompt](../ai/ai-prompt), [Creación y edición](../../creating-and-editing), [Pruebas e iteración](../../testing-and-iteration) y [Manejo de errores](../../error-handling)