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

# Write to Knowledge Base

> Configura un paso del flujo de trabajo que escribe contenido en una base de conocimientos existente — desde texto personalizado, un documento o un sitio web extraído

# Write to Knowledge Base

Usa **Write to Knowledge Base** cuando quieras que un paso del flujo de trabajo agregue nuevo contenido a una de tus bases de conocimientos. Cada ejecución crea un nuevo elemento de base de conocimientos para que se preserve el historial completo de escrituras.

## 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 de destino seleccionada en **Knowledge Base**.                                                                                                                           |
| Write Mode             | Sí                 | Uno de **Text**, **Document** o **Scrape**.                                                                                                                                                       |
| Content                | Sí (modo Text)     | El texto a embeber. Este campo admite variables del flujo de trabajo mediante **Insert Variable**.                                                                                                |
| Document URL           | Sí (modo Document) | La URL del documento a extraer y embeber. Admite variables del flujo de trabajo mediante **Insert Variable**.                                                                                     |
| Website URL            | Sí (modo Scrape)   | La URL a extraer.                                                                                                                                                                                 |
| Chunking Strategy      | No                 | **Default** usa fragmentación determinista que respeta párrafos y oraciones. **Advanced** usa el mismo fragmentador y te permite establecer **Max Chunk Length** y **Chunk Overlap** manualmente. |
| Remove Email Addresses | No                 | Cuando está habilitado, elimina las direcciones de correo electrónico del contenido antes de embeber.                                                                                             |
| Remove Phone Numbers   | No                 | Cuando está habilitado, elimina los números de teléfono del contenido antes de embeber.                                                                                                           |
| When the step fails    | No                 | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla.                                                                                                    |

### Write Mode

**Text** — Ingresa texto sin procesar directamente en **Content** o canaliza la salida de un paso anterior usando `{{step_n.output}}`.

**Document** — Ingresa una URL de documento en **Document URL**, o usa **Insert Variable** para pasar una URL de un paso anterior (por ejemplo, una URL de la biblioteca de medios). El contenido se extrae automáticamente y se embebe en la base de conocimientos.

**Scrape** — Ingresa una URL en **Website URL**. Fetch Hive extrae la página y embebe el texto extraído.

### Chunking Strategy

Deja **Chunking Strategy** establecido en **Default** para la mayoría de los casos de uso. Fetch Hive preserva los límites de párrafo y oración cuando es posible, y solo recurre a una división dura cuando una sola unidad es demasiado grande. Cambia a **Advanced** para controlar exactamente cómo se divide el contenido:

* **Max Chunk Length** — Número máximo de caracteres por fragmento (predeterminado 500).
* **Chunk Overlap** — Número de caracteres compartidos entre fragmentos adyacentes (predeterminado 50). El solapamiento ayuda a preservar el contexto en los límites de los fragmentos.

### Eliminación de PII

Habilita **Remove Email Addresses** y/o **Remove Phone Numbers** para redactar esos valores del contenido antes de que sea embebido y almacenado.

## Salida

Este paso devuelve un resumen de la operación de escritura:

```json theme={null}
{
  "knowledge_base_item_id": "...",
  "knowledge_base_id": "...",
  "chunk_count": 12,
  "status": "completed",
  "write_mode": "custom_text"
}
```

Referencia la salida en un paso posterior:

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

## Costo

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

## Ejemplo

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

Establece **Knowledge Base** con la base de conocimientos de destino.

Elige **Write Mode**. Para un pipeline que resume artículos web, selecciona **Scrape** y establece **Website URL** en `{{step_1.output.url}}`.

Deja **Chunking Strategy** como **Default** a menos que necesites un control preciso sobre el tamaño del fragmento.

Habilita **Remove Email Addresses** si el contenido extraído puede contener datos personales.

Haz clic en **Run** en el encabezado del paso para probar la escritura y, a continuación, verifica **Output** para confirmar el conteo de fragmentos y el ID del elemento.

{/* Add screenshot: Write to Knowledge Base settings with Scrape mode and Advanced chunking */}

## Notas

* Cada ejecución crea un **nuevo** elemento de base de conocimientos. Los elementos anteriores escritos por ejecuciones previas no se sobrescriben, por lo que se preserva el historial completo de escrituras en la base de conocimientos.
* El paso valida que se seleccione una base de conocimientos y que la entrada requerida para el modo elegido esté presente antes de ejecutarse.
* La fragmentación y la eliminación de PII se aplican antes de que el contenido sea embebido.

Consulta también: [Search Knowledge Base](./search-knowledge-base), [Creación y edición](../../creating-and-editing), [Pruebas e iteración](../../testing-and-iteration) y [Manejo de errores](../../error-handling)