Saltar al contenido principal

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ónRequeridoDescripción
NameNoEtiqueta del paso en el lienzo del flujo de trabajo.
Knowledge BaseLa base de conocimientos de destino seleccionada en Knowledge Base.
Write ModeUno de Text, Document o Scrape.
ContentSí (modo Text)El texto a embeber. Este campo admite variables del flujo de trabajo mediante Insert Variable.
Website URLSí (modo Scrape)La URL a extraer.
Chunking StrategyNoDefault 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 AddressesNoCuando está habilitado, elimina las direcciones de correo electrónico del contenido antes de embeber.
Remove Phone NumbersNoCuando está habilitado, elimina los números de teléfono del contenido antes de embeber.
When the step failsNoControla 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 — Adjunta un documento al paso. 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:
{
  "knowledge_base_item_id": "...",
  "knowledge_base_id": "...",
  "chunk_count": 12,
  "status": "completed",
  "write_mode": "custom_text"
}
Referencia la salida en un paso posterior:
{{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.

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, Creación y edición, Pruebas e iteración y Manejo de errores