> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fuentes de datos

> Conecta archivos o APIs externas como origen de datos de tu empresa, con esquema tipado y listo para usar en flujos de datos

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](/docs/datos/flujo-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

| Concepto                    | Valor                                                 |
| --------------------------- | ----------------------------------------------------- |
| Formatos de archivo         | JSON, XML, CSV, Excel/XLSX                            |
| Tamaño máximo de archivo    | 50 MB                                                 |
| Respuesta de API externa    | JSON, hasta 5 MB                                      |
| Tiempo de espera de la API  | 10 segundos                                           |
| URLs permitidas             | HTTP(S) públicas                                      |
| Muestra guardada por fuente | Hasta 50 registros                                    |
| Tipos de campo              | string, number, integer, boolean, null, object, array |

## Qué sigue

* [Flujo de datos](/docs/datos/flujo-de-datos): construye flujos que usan los
  campos publicados de tus fuentes.
* [Importación de estudios externos](/docs/guias/importacion-estudios): para
  cargar estudios propios y unificarlos con tus respondentes.