Skip to main content
Una fuente de datos es un origen de información a nivel de empresa: un archivo que subes o una API externa que conectas, con un esquema tipado que define cada campo. Los campos que publicas quedan disponibles para agentes, funciones y acciones al construir flujos de datos. El módulo vive en el grupo Datos del menú lateral, en la sección Fuentes de datos.

​
Crear una fuente

Una fuente se crea con un asistente de cuatro pasos: Conectar, Revisar datos, Definir esquema y Publicar.

​
1. Conectar

Puedes partir de dos orígenes:
  • Subir archivo: acepta JSON, XML, CSV y Excel/XLSX de hasta 50 MB.
  • Conectar API externa: indicas la URL, el método (GET o POST) y, si el servicio lo requiere, una API key que se envía como token Bearer. El botón Probar conexión verifica el acceso antes de continuar. La respuesta debe ser JSON, de hasta 5 MB, y la conexión espera un máximo de 10 segundos. Solo se aceptan URLs HTTP(S) públicas.
En ambos casos woku detecta automáticamente los campos presentes y la cantidad de registros del origen.

​
2. Revisar datos

Se muestra una tabla con los campos detectados. Para cada campo ves un ejemplo recibido y el tipo detectado (Email, Número, Fecha, Objeto, Lista o Texto), y decides si se incluye o se excluye de la fuente. Los campos excluidos no forman parte del esquema publicado.

​
3. Definir esquema

En este paso defines cómo queda cada campo. Puedes trabajar de tres maneras, combinándolas como prefieras:
  • Asistente de IA: un chat que propone el esquema campo por campo. Se detalla en la sección siguiente.
  • Pestaña Visual: edición campo a campo del nombre visible, tipo, formato, descripción y obligatoriedad, incluidas las propiedades de los objetos y los elementos de las listas.
  • Pestaña Código: editor JSON del esquema con validación en vivo. Si hay un error, marca la línea y la columna exacta donde ocurre.
Los tipos disponibles son string, number, integer, boolean, null, object y array, más un formato opcional como email o date para los campos que lo necesiten.

​
4. Publicar

Antes de publicar ves un resumen final con los campos que se publicarán, los campos excluidos y el botón Ver JSON para inspeccionar el esquema resultante. Al publicar, la fuente queda disponible para construir flujos de datos.

​
El asistente de esquema

El asistente de IA revisa los datos detectados y propone, campo por campo, el nombre visible, el tipo, el formato, la descripción y la obligatoriedad. Puedes pedirle ajustes en lenguaje natural, por ejemplo que marque un campo como obligatorio o que cambie la descripción de otro, y el esquema se actualiza en las pestañas Visual y Código. La conversación con el asistente se guarda junto con la fuente y se restaura al reabrirla, así retomas el contexto donde lo dejaste.

​
Gestionar tus fuentes

El home del módulo muestra cada fuente como una tarjeta con la cantidad de registros, los campos definidos, los campos excluidos y hace cuánto tiempo fue publicada. Puedes buscar entre tus fuentes por nombre. Desde cada fuente puedes:
  • Editar esquema: reabre el asistente en el paso Definir esquema para ajustar campos y volver a publicar.
  • Ver JSON: muestra el esquema publicado.
  • Eliminar fuente: la quita de la empresa.
Cada fuente guarda además una muestra de hasta 50 registros completos, que alimenta la simulación y la ejecución de los flujos de datos que la usan.

​
Límites y formatos

​
Qué sigue