Documentacion de EasyData

Bienvenido a EasyData! Esta guia cubre todo lo que necesitas saber para organizar y gestionar tus datos con asistencia de IA.

Que es EasyData?

EasyData es una plataforma de gestion de datos asistida por IA que te ayuda a organizar, almacenar y trabajar con datos estructurados. Ya sea que estes rastreando clientes, gestionando inventario u organizando cualquier tipo de informacion, EasyData proporciona una forma flexible e inteligente de manejar tus datos.

Caracteristicas Principales

• Creacion de Esquemas Asistida por IA — Describe tus datos en lenguaje natural y deja que la IA cree la estructura por ti
• Entrada Inteligente de Datos — Agrega entradas manualmente o describelas en lenguaje natural
• Relaciones entre Esquemas — Vincula tus datos usando referencias entre esquemas
• Campos con Formula — Crea campos calculados con expresiones tipo Excel que se actualizan automaticamente
• Reportes — Crea paneles de datos con agregaciones, agrupaciones, filtros de origen y formulas a traves de tus esquemas
• Formatos de Campo — Personaliza como se muestran los datos con formatos como moneda, email, telefono y mas
• Importacion Inteligente — Importa archivos CSV, TSV y Excel con deteccion automatica de secciones, mapeo editable de campos y deteccion inteligente opcional con IA
• Busqueda Inteligente — Usa campos embebidos para habilitar busqueda potenciada por IA
• Opciones de Exportación — Exporta tus datos a Excel, CSV, JSON o Google Sheets, con exportaciones grandes procesadas en segundo plano

Inicio Rapido

Asi es como puedes comenzar en solo unos pasos:

1. Crea Tu Primer Esquema

1. Navega a la pagina de Esquemas
2. Haz clic en Crear Esquema
3. Elige el modo Asistido y describe tus datos (ej., “Una lista de contactos con nombre, email, telefono y empresa”)
4. Haz clic en Generar Esquemas
5. Revisa el esquema generado y haz clic en Crear Esquemas

2. Agrega Algunos Datos

Una vez creado tu esquema:

1. Haz clic en tu esquema para abrirlo
2. Haz clic en Agregar Entrada Manual para agregar datos usando un formulario
3. O haz clic en Agregar con IA para describir tus datos en lenguaje natural

3. Organiza con Referencias

A medida que tus datos crecen, puedes:

1. Crear esquemas adicionales para datos relacionados (ej., “Empresas” para tus contactos)
2. Editar tu esquema original para agregar campos de referencia
3. Vincular entradas para mejor organizacion

Esquemas

Los esquemas son la base de EasyData. Un esquema define la estructura de tus datos — piensa en el como una plantilla que describe que informacion quieres almacenar y como debe organizarse.

Que es un Esquema?

Un esquema es como un plano para tus datos. Por ejemplo, si quieres rastrear clientes, tu esquema podria incluir campos como:

• Nombre (texto)
• Email (texto con formato de email)
• Telefono (texto)
• Activo (si/no)

Una vez que creas un esquema, puedes agregar entradas (registros individuales) que sigan esta estructura.

Creando Esquemas

El diálogo Crear esquema mantiene su título al cambiar entre Asistido, Plantillas y Manual. La generación asistida comienza al elegir Generar esquemas; revisa los esquemas propuestos antes de crearlos.

EasyData ofrece tres formas de crear esquemas: Asistido por IA, Plantillas y Manual.

Creacion Asistida por IA

La forma mas rapida de crear un esquema es describir lo que necesitas en lenguaje natural:

1. Haz clic en Crear Esquema desde la pagina de esquemas
2. Selecciona la pestana Asistido
3. Describe la estructura de tus datos en el area de texto
4. Opcionalmente adjunta un archivo para contexto adicional (CSV, Excel, PDF, etc.)
5. Haz clic en Generar Esquemas
6. Revisa el esquema generado y haz ajustes si es necesario
7. Haz clic en Crear Esquemas para guardar

Ejemplos de prompts:

• “Una base de datos de clientes con nombre, email, numero de telefono y empresa”
• “Registrar mi coleccion de libros con titulo, autor, genero y calificacion”
• “Directorio de empleados con nombre, departamento, fecha de contratacion y gerente”

Plantillas

Las plantillas te dan un punto de partida para flujos comunes. Una plantilla puede crear un esquema o un conjunto de esquemas vinculados con referencias ya configuradas. Los esquemas creados desde plantillas son esquemas normales: puedes editar sus campos, agregar datos, vincularlos a proyectos y eliminarlos como cualquier esquema que crees manualmente.

Algunas plantillas tambien pueden crear un proyecto para mantener juntos los esquemas relacionados.

Creacion Manual

Para control total sobre la estructura de tu esquema:

1. Haz clic en Crear Esquema desde la pagina de esquemas
2. Selecciona la pestana Manual
3. Haz clic en Agregar Esquema para crear una nueva tarjeta de esquema
4. Ingresa el nombre del esquema
5. Agrega campos usando el boton Agregar Campo
6. Configura las propiedades de cada campo
7. Haz clic en Crear Esquemas para guardar

Propiedades de Campos

Cada campo tiene varias propiedades configurables:

• Nombre para Mostrar — El nombre legible que se muestra en la interfaz
• Tipo — Elige Texto, Numero, Si/No u Opciones para listas controladas
• Requerido — Cuando esta habilitado, las entradas no pueden guardarse sin un valor en este campo
• Valor Predeterminado — Un valor prellenado para nuevas entradas
• Ocultar/Mostrar — Los campos pueden ocultarse de la cuadricula de datos sin eliminarlos
• Formato — Controla como se muestran los datos (ej., moneda, email, telefono). Ver Formatos de Campo
• Formula — Una expresion que calcula el valor de este campo automaticamente. Ver Campos con Formula

Reglas de Nombres de Esquemas

Los nombres de esquemas deben seguir estas reglas:

• Solo letras, numeros y espacios permitidos
• Maximo 50 caracteres
• No puede estar vacio
• Sin caracteres especiales (guiones, guiones bajos, etc.)

Nombres validos: “Clientes”, “Lista de Productos”, “Tareas 2024”

Nombres invalidos: “Mi-Esquema”, “Productos_v2”, “Tareas@Trabajo”

Relaciones entre Esquemas

Una de las caracteristicas poderosas de EasyData es la capacidad de vincular esquemas usando Referencias.

Que son las Referencias?

Un campo de referencia crea un vinculo entre dos esquemas. En lugar de escribir el mismo valor repetidamente, seleccionas de entradas existentes en otro esquema.

Ejemplo: Tienes dos esquemas:

• Categorias: “Electronica”, “Ropa”, “Libros”
• Productos: Cada producto referencia una categoria

Al agregar un producto, en lugar de escribir “Electronica”, lo seleccionas de un dropdown de categorias existentes.

Creando un Campo de Referencia

1. Edita tu esquema
2. Agrega un nuevo campo o edita uno existente
3. En el dropdown de Referencia, selecciona el esquema al que quieres vincular
4. Elige un Campo de Visualizacion — esto determina que texto aparece en el dropdown

Convirtiendo una Columna a Esquema

Si tienes un campo con muchos valores repetidos (como categorias o estados), puedes convertirlo en un esquema separado:

1. Abre la cuadricula de datos de tu esquema
2. Pasa el cursor sobre el encabezado de la columna y haz clic en el icono de base de datos
3. Ingresa un nombre para el nuevo esquema
4. Los valores unicos se convierten en entradas del nuevo esquema
5. Se agrega un nuevo campo de referencia a tu esquema, vinculando al nuevo esquema

Tu campo original permanece sin cambios. Esto es util para normalizar tus datos y evitar errores de escritura en valores repetidos.

Formatos de Campo

Los formatos de campo controlan como se muestran e ingresan los datos. Actuan como indicadores de visualizacion — el tipo de dato subyacente permanece igual, pero la interfaz se adapta para mostrarlo de una forma mas significativa.

Formatos Disponibles

Configurando un Formato

1. Edita tu esquema
2. Selecciona un campo
3. Elige un formato del dropdown de Formato
4. Guarda el esquema

Campos con Formula

Los campos con formula te permiten crear columnas calculadas que computan sus valores automaticamente basandose en otros campos. Piensa en ellos como formulas de Excel para tus datos.

Como Funcionan las Formulas

Cuando agregas una formula a un campo, ese campo se convierte en solo lectura — su valor se calcula cada vez que se crea o actualiza un registro. No puedes editar manualmente un campo con formula.

Escribiendo Formulas

Las formulas referencian otros campos usando el prefijo $ con el nombre para mostrar del campo:

$cantidad * $precioUnitario

Aritmetica: +, -, *, /, % (modulo)

Comparaciones: ==, !=, >, <, >=, <=

Logica: AND, OR, NOT

Funciones Disponibles

Referenciando Datos Relacionados

Las formulas pueden acceder a campos de esquemas referenciados usando notacion de punto:

$producto.precio * $cantidad

Aqui $producto es un campo de referencia, y .precio accede al campo “precio” del esquema referenciado.

Funciones de Agregacion

Las funciones de agregacion calculan valores a traves de todos los registros en un esquema relacionado, filtrados por un campo de referencia que apunta al registro actual. Son utiles para calculos “uno-a-muchos” como totalizar todas las lineas de pedido de un cliente.

Argumentos:

• "Esquema" — El nombre del esquema relacionado (ej., “ItemsPedido”)
• "campo" — El campo a agregar (no necesario para COUNT)
• "campoReferencia" — El campo de referencia en el esquema relacionado que apunta al esquema actual (ej., “pedidoId”)

Ejemplos

Reportes

Al abrir un reporte desde la barra lateral o una tarjeta se muestran sus Resultados. Esta acción lee los resultados existentes, sin guardar la definición ni iniciar generación con IA. Usa Definición para cambiar el nombre, los campos, las fórmulas, la agrupación o los filtros de origen. Los enlaces de esquemas abren Datos y los de proyectos abren su contenido. El nombre del objeto permanece visible al cambiar entre contenido y definición.

Los reportes te permiten crear paneles de datos que agregan y resumen datos a traves de tus esquemas. Pueden mostrar una sola fila de totales (sin agrupar) o desglosar los datos en multiples filas usando Agrupar Por (agrupados). Piensa en ellos como dashboards en vivo para tus datos.

Que es un Reporte?

Un reporte es una coleccion de campos — ya sean valores estaticos que ingresas manualmente o formulas que se calculan automaticamente a partir de los datos de tus esquemas. Los reportes tambien pueden agrupar resultados por un campo, dandote desgloses como ingresos por mes o pedidos por estado.

Por ejemplo, un reporte de “Resumen de Pedidos” podria mostrar:

• Ingresos Totales — SUM("Ventas", "monto")
• Numero de Pedidos — COUNT("Pedidos")
• Pedido Promedio — AVG("Ventas", "monto")
• Tasa de Impuesto — 0.16 (un valor estatico)
• Impuesto Estimado — $ingresosTotales * $tasaDeImpuesto

Creando un Reporte

1. Navega a la pagina de Reportes
2. Haz clic en Nuevo reporte
3. Ingresa un nombre para tu reporte
4. Agrega campos — elige entre Valor (estatico) o Formula (calculado)
5. Opcionalmente configura Agrupar Por para desglosar resultados en filas
6. Haz clic en Guardar

Campos de Reporte

Cada campo en un reporte tiene estas propiedades:

• Nombre para Mostrar — La etiqueta que se muestra en la tabla del reporte
• Tipo — Ya sea “Valor” (entrada manual) o “Formula” (auto-calculado)
• Valor — Para campos de valor, el numero que ingresas
• Formula — Para campos de formula, la expresion a calcular
• Formato — Como mostrar el resultado (numero, moneda o porcentaje)

Formulas de Reporte

Las formulas de reporte usan la misma sintaxis que las formulas de esquema pero con una diferencia clave: las funciones de agregacion operan sobre todos los registros globalmente (o dentro de cada grupo cuando Agrupar Por esta configurado).

Agregaciones de Esquema

Referencias a Campos Locales

Referencia otros campos dentro del mismo reporte usando $:

$ingresosTotales * $tasaDeImpuesto

Agrupar Por

Agrupar Por te permite desglosar un reporte en multiples filas basadas en un campo de uno de tus esquemas. Por ejemplo, agrupar por un campo de fecha con granularidad de mes muestra una fila por mes.

• Esquema — El esquema por el cual agrupar
• Campo — Cual campo usar como clave de agrupacion
• Granularidad — Para campos de fecha, elige dia, mes o año

Puedes agrupar por multiples campos para crear desgloses compuestos (ej., ingresos por producto y mes).

Filtros de Origen

Los reportes agrupados pueden filtrar los registros de origen antes de calcular los resultados. Los filtros de origen usan reglas de campo, operador y valor similares a los filtros de esquemas, pero se aplican solo al esquema de origen del reporte.

Por ejemplo, un reporte de ingresos mensuales puede incluir solo registros donde Estado es “Pagado”, o un reporte de inventario puede agrupar solo productos donde Activo esta marcado. Cuando un reporte agrupado tiene filtros de origen, esos filtros afectan las filas, los totales y las exportaciones de ese reporte.

Vinculando Reportes a Esquemas

Puedes mostrar reportes junto a los datos de tu esquema:

1. Abre la cuadricula de datos de un esquema
2. Haz clic en Vincular reportes en la barra de herramientas
3. Selecciona cuales reportes vincular
4. Guarda la selección. Los reportes vinculados aparecen debajo de los datos; sus títulos abren la página de Resultados del reporte.

Esto es util para ver totales y desgloses en contexto mientras navegas tus datos.

Ejemplos

API Publica

La API Publica de EasyData permite que integraciones del lado del servidor listen esquemas, lean o escriban registros, preparen creaciones de registros asistidas por IA e inicien checkouts de creditos de IA de un solo pago sin usar la app web.

Claves de API

Crea y revoca claves desde Configuración → Acceso de desarrolladores → Claves de API. Las claves se muestran una sola vez como secretos ed_sk_.... EasyData guarda solo un hash y despues identifica las claves por su prefijo visible.

Alcances:

• Solo lectura — listar esquemas, obtener esquemas, consultar registros, obtener un registro, listar paquetes de creditos y consultar una compra de creditos
• Lectura y escritura — todas las acciones de lectura mas crear esquemas, crear, actualizar o eliminar registros, creacion de registros asistida por IA e iniciar un checkout de creditos

URL Base y Autenticacion

Usa el namespace /api/public/v1 y envia la clave como bearer token:

curl -s "https://easydata.cc/api/public/v1/schemas" 
  -H "Authorization: Bearer $EASYDATA_API_KEY"

Usa /api/public/v1/named cuando quieras payloads de request y response con nombres de campo.

curl -s "https://easydata.cc/api/public/v1/named/schemas" 
  -H "Authorization: Bearer $EASYDATA_API_KEY"

IDs y Nombres de Campo

La API estable en /api/public/v1 usa IDs de campo inmutables como f1, f2 y f3. Las respuestas de esquema incluyen nombres y nombres visibles para que tu integracion pueda mapear etiquetas a IDs estables.

La API con nombres en /api/public/v1/named usa el nombre interno de cada campo, como customerName, en registros, filtros y ordenamiento. Los registros se devuelven como objetos planos, con f1 devuelto como id. Los campos de referencia siguen guardando UUIDs, y los registros relacionados tambien se devuelven con claves por nombre de campo.

Para creaciones seguras ante reintentos, las integraciones de servidor pueden enviar UUIDs deterministas. La creacion de esquemas conserva un id no vacio, la creacion de registros con IDs de campo conserva un f1 valido, y la creacion con nombres conserva id. Reutilizar un ID existente de esquema o registro devuelve 409 Conflict.

Para reintentos de red, envia el header opcional Idempotency-Key en escrituras POST publicas: creacion de esquemas, creacion de registros, creacion de registros con nombres y Smart Create. EasyData limita la clave a la API key, metodo, ruta y cuerpo del request. La misma clave con el mismo request devuelve la respuesta JSON exitosa guardada; la misma clave con otro request devuelve 409 Conflict. Los requests fallidos no se guardan.

Las compras de creditos usan el UUID requestId del cuerpo del request para tolerar reintentos. Reutilizalo solo para la misma compra del mismo paquete. La API devuelve un checkoutUrl de Paddle; la compra no esta completa hasta que el usuario termina el checkout y el estado cambia a completed.

Los requests recientes de la API publica se ven en Configuración → Acceso de desarrolladores → Claves de API. Los logs incluyen metodo, ruta, estado, duracion, cuerpo del request y cuerpo de la respuesta para depurar integraciones. Los headers de Authorization y los secretos de API keys nunca se guardan. Los cuerpos muy grandes se limitan y se marcan como truncados.

Las respuestas de esquema con nombres devuelven fields como un array con id, name, displayName, type y otros metadatos de cada campo. Si un esquema tiene nombres de campo duplicados, usa la API con IDs de campo o renombra los campos antes de usar la API con nombres.

Al crear esquemas con la API con nombres, incluye targetSchemaId en un campo para convertirlo en un campo de referencia. Las referencias siempre apuntan al id del registro destino.

Endpoints

Endpoints con IDs de campo:

Endpoints con nombres:

Endpoints de compra de creditos:

Antes de crear una compra de creditos, muestra al usuario el paquete disponible y su precio y solicita confirmacion explicita. Envia { "productId": 1, "requestId": "<uuid>" } y luego entrega al usuario el checkoutUrl devuelto. El usuario completa el pago directamente mediante Paddle Checkout.

Ejemplos con Curl y Nombres

Crear un esquema con nombres de campo:

curl -s -X POST "https://easydata.cc/api/public/v1/named/schemas" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Idempotency-Key: schema-orders-001" 
  -H "Content-Type: application/json" 
  -d '{"schemas":[{"id":"018f7f37-78a2-7000-9000-000000000101","name":"Pedidos","description":"Pedidos de clientes","displayField":"customerName","fields":[{"name":"customerName","type":"string","displayName":"Cliente"},{"name":"amount","type":"number","displayName":"Monto"}],"embeddedFields":["customerName"]}]}'

Consultar registros con nombres de campo:

curl -s "https://easydata.cc/api/public/v1/named/schemas/$SCHEMA_ID/records/query?limit=50&offset=0" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"filters":{"fields":[{"field":"customerName","conditions":[{"operator":"contains","value":"Ada"}],"logic":"and"}],"logic":"and"},"orderBy":[{"field":"customerName","direction":"asc"}]}'

Crear registros con nombres de campo:

curl -s -X POST "https://easydata.cc/api/public/v1/named/schemas/$SCHEMA_ID/records" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Idempotency-Key: order-018f7f37-201" 
  -H "Content-Type: application/json" 
  -d '{"records":[{"id":"018f7f37-78a2-7000-9000-000000000201","customerName":"Cliente de ejemplo","amount":42}]}'

Actualizar registros con nombres de campo:

curl -s -X PATCH "https://easydata.cc/api/public/v1/named/schemas/$SCHEMA_ID/records" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"records":[{"id":"$RECORD_ID","data":{"customerName":"Cliente actualizado"}}]}'

Eliminar registros:

curl -s -X DELETE "https://easydata.cc/api/public/v1/named/schemas/$SCHEMA_ID/records" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"ids":["$RECORD_ID"]}'

Ejemplos con Curl e IDs de Campo

Crear un esquema con IDs de campo:

curl -s -X POST "https://easydata.cc/api/public/v1/schemas" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Idempotency-Key: schema-orders-001" 
  -H "Content-Type: application/json" 
  -d '{"schemas":[{"id":"018f7f37-78a2-7000-9000-000000000101","name":"Pedidos","description":"Pedidos de clientes","fields":{"f1":{"name":"id","type":"string","order":0,"displayName":"ID"},"f2":{"name":"customerName","type":"string","order":1,"displayName":"Cliente"},"f3":{"name":"amount","type":"number","order":2,"displayName":"Monto"}},"primaryKey":["f1"],"uniqueKeys":[],"foreignKeys":[],"embeddedFields":["f2"]}]}'

Consultar registros:

curl -s "https://easydata.cc/api/public/v1/schemas/$SCHEMA_ID/records/query?limit=50&offset=0" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"filters":{"fields":[],"logic":"and"},"orderBy":[]}'

Crear registros:

curl -s -X POST "https://easydata.cc/api/public/v1/schemas/$SCHEMA_ID/records" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Idempotency-Key: record-018f7f37-201" 
  -H "Content-Type: application/json" 
  -d '{"records":[{"f1":"018f7f37-78a2-7000-9000-000000000201","f2":"Valor de ejemplo","f3":42}]}'

Crear registros con IA:

curl -s -X POST "https://easydata.cc/api/public/v1/smart-entry/create" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Idempotency-Key: smart-order-acme-001" 
  -H "Content-Type: application/json" 
  -d '{"message":"Agrega un pedido para Acme por 2400 con vencimiento manana","schemaIds":["$SCHEMA_ID"],"autoSave":false}'

schemaIds es opcional pero recomendado cuando tu integracion ya conoce el esquema destino. Con autoSave: false, EasyData devuelve registros propuestos usando IDs de campo. Con autoSave: true, EasyData guarda resultados solo de creacion con la misma validacion, historial, formulas, embeddings, reportes y actualizacion de conteos que la API de registros.

Actualizar registros:

curl -s -X PATCH "https://easydata.cc/api/public/v1/schemas/$SCHEMA_ID/records" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"records":[{"id":"$RECORD_ID","data":{"f2":"Valor actualizado"}}]}'

Eliminar registros:

curl -s -X DELETE "https://easydata.cc/api/public/v1/schemas/$SCHEMA_ID/records" 
  -H "Authorization: Bearer $EASYDATA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"ids":["$RECORD_ID"]}'

V1 no incluye edicion de esquemas, importaciones, flujos completos de Smart Entry con continuaciones, reportes, widgets ni claves publicas o de navegador.

Conectar Agentes de IA

EasyData permite que los agentes de IA se conecten a la cuenta de un usuario sin pedirle que copie una clave de API. El agente se registra como cliente OAuth publico, el usuario inicia sesion y aprueba el acceso, y EasyData emite credenciales limitadas al recurso y alcance aprobados.

Clientes y Conexiones de Usuario

Un client_id identifica a la aplicacion del agente, no a un usuario de EasyData. Es un identificador publico y se puede incluir de forma segura en solicitudes de autorizacion. Un cliente puede conectarse con varios usuarios, pero cada usuario debe aprobar una concesion separada y recibe su propio access token y su propia familia de refresh tokens.

Cada conexion activa es unica para un usuario, cliente y recurso. Los usuarios pueden revisar y revocar inmediatamente sus concesiones desde Configuración → Integraciones y agentes → Agentes conectados.

Flujos de Autorizacion

Ambos flujos crean el mismo tipo de conexion y emiten los mismos tipos de token. Los codigos de autorizacion y claim tokens son intermediarios de corta duracion y un solo uso; no pueden llamar a la API por si mismos.

Recursos, Alcances y Tokens

• Recurso REST — https://easydata.cc/api/public/v1
• Recurso MCP — https://easydata.cc/api/mcp
• Lectura — listar u obtener esquemas, consultar u obtener registros, listar paquetes de creditos y consultar compras de creditos
• Lectura y escritura — todas las acciones de lectura mas creacion de esquemas, escritura y eliminacion de registros, Smart Entry e iniciar un checkout de creditos confirmado

Los access tokens son bearer tokens firmados validos durante una hora. Los refresh tokens son credenciales opacas validas por hasta 30 dias y rotan con cada uso. Guarda los access tokens y refresh tokens como secretos. Reutilizar un refresh token despues de que haya rotado revoca toda la conexion.

Descubrimiento e Integracion

Los agentes deben comenzar con los documentos de descubrimiento legibles por maquinas de EasyData en lugar de guardar los endpoints en su codigo:

• Metadatos del servidor de autorizacion OAuth
• Metadatos del recurso protegido
• Guia de autenticacion para agentes
• Indice de Agent Skills
• Endpoint MCP Streamable HTTP: /api/mcp

Por ejemplo, un agente puede descubrir todos los endpoints OAuth con:

curl -s "https://easydata.cc/.well-known/oauth-authorization-server"

La respuesta del registro de cliente devuelve un client_id. El agente guarda y reutiliza ese identificador publico, pero guarda el refresh token de cada usuario por separado y nunca expone tokens en URLs, bundles del navegador, logs o chats.

Campos Embebidos

Los campos embebidos habilitan una poderosa funcion de IA: cuando agregas entradas usando el asistente de IA, puede buscar y referenciar tus datos existentes.

Que son los Campos Embebidos?

Cuando marcas un campo como “embebido”, sus valores se indexan en una base de datos vectorial. Esto permite que la IA encuentre entradas relevantes cuando describes datos en lenguaje natural.

Como Funciona

1. Marcas campos como “Nombre” o “Email” como embebidos en tu esquema
2. El sistema sincroniza estos valores al indice de busqueda (veras un indicador de estado de sincronizacion)
3. Al agregar entradas via IA, puedes referenciar datos existentes naturalmente

Ejemplo:

Tienes un esquema “Contactos” con “Nombre” marcado como embebido, conteniendo una entrada para “Juan Garcia”.

Al agregar una tarea, puedes decir: “Crear una tarea de seguimiento para Juan”

La IA:

1. Buscara en tus campos embebidos “Juan”
2. Encontrara “Juan Garcia” en tus Contactos
3. Vinculara automaticamente la tarea al contacto correcto

Buenos Candidatos para Embeber

Elige campos que ayuden a identificar entradas:

• Nombres (nombres de personas, nombres de productos, nombres de empresas)
• Direcciones de email
• Descripciones
• Titulos

Habilitando Campos Embebidos

1. Edita tu esquema
2. Encuentra el campo que quieres embeber
3. Activa el interruptor de Embebido
4. Guarda el esquema
5. Espera a que se complete la sincronizacion

Gestionando Datos

Una vez que has creado un esquema, puedes comenzar a agregar y gestionar entradas de datos.

Viendo Tus Datos

Haz clic en una tarjeta o nombre de esquema en la barra lateral para abrir Datos. Esta interfaz muestra los registros. Usa Definición para configurar campos, tipos, fórmulas y referencias; elige Datos para volver a los registros.

Agregando Entradas

Entrada Manual

Para control preciso sobre tus datos:

1. Haz clic en Agregar Entrada Manual en la barra de herramientas
2. Aparece una nueva fila vacia en la parte superior de la cuadricula
3. Llena cada campo haciendo clic en las celdas
4. Presiona Enter para guardar y crear otra entrada, o Escape para cancelar

Entrada Asistida por IA

Deja que la IA te ayude a convertir lenguaje natural en datos estructurados:

1. Haz clic en Agregar con IA en la barra de herramientas
2. Describe tus datos en lenguaje natural
3. Revisa los datos convertidos en la vista previa
4. Haz clic para agregar las entradas a tu esquema

Ejemplos de prompts:

• “Agrega un cliente llamado Juan Garcia, email [email protected], telefono 555-1234”
• “Crea tres productos: Widget A por $19.99, Widget B por $29.99, Widget C por $39.99”
• “Agrega una tarea para dar seguimiento al equipo de marketing sobre el informe Q1”

Tambien puedes usar entrada de voz haciendo clic en el icono del microfono.

Importando Archivos

Para hojas de calculo o archivos tabulares existentes:

1. Abre el esquema al que quieres importar
2. Haz clic en Importar en la barra de herramientas
3. Sube un archivo CSV, TSV, XLS o XLSX
4. Revisa la seccion detectada del archivo y el mapeo de columnas a campos
5. Ajusta cualquier campo mapeado u omite columnas que no quieras importar
6. Haz clic en Importar para crear los registros

EasyData detecta automaticamente la mejor seccion importable del archivo y sugiere un mapeo entre columnas del archivo y campos del esquema. Esto ayuda con hojas que tienen titulos adicionales, filas vacias, varias regiones o formatos de campo/valor en lugar de una tabla simple.

Si la seccion detectada o el mapeo no parecen correctos, usa Detectar con IA en el paso de revision. La deteccion inteligente usa creditos de IA para elegir la mejor seccion y el mejor mapeo para el esquema seleccionado, y luego vuelve a la misma pantalla de revision para que confirmes antes de importar.

Tambien puedes adjuntar archivos tabulares al usar Agregar con IA. Cuando EasyData detecta que un archivo subido se maneja mejor como importacion, muestra una oferta de revision de importacion para que puedas inspeccionar el mapeo antes de crear registros.

Editando Entradas

Edicion en Linea

La forma mas rapida de editar datos:

1. Haz clic en cualquier celda en la cuadricula de datos
2. Escribe el nuevo valor
3. Presiona Enter para guardar, Tab para moverte a la siguiente celda, o Escape para cancelar

Los cambios se guardan automaticamente cuando abandonas una celda.

Campos de Referencia

Al editar un campo de referencia:

1. Haz clic en la celda para abrir un dropdown
2. Busca o desplazate para encontrar la entrada que deseas
3. Haz clic para seleccionarla

Filtrar y Ordenar

Ordenar

Abre Ordenar en la barra de herramientas para elegir una columna y el orden ascendente o descendente, o para quitar el ordenamiento. Su contador muestra las reglas activas. La flecha de cada columna también ofrece Ordenar y filtrar como acceso directo.

Filtrar

Usa las opciones de filtro para reducir tus datos:

1. Abre Filtrar en la barra de herramientas, o Ordenar y filtrar desde la flecha de una columna
2. Selecciona el campo y un operador (igual, contiene, mayor que, etc.)
3. Ingresa el valor del filtro
4. Aplica el filtro. El contador muestra los campos con filtros activos

Los filtros y el ordenamiento afectan a la tabla actual. Guarda un filtro para reutilizarlo. Los archivos importados aparecen por separado porque identifican el origen de los registros importados.

Operadores de filtro disponibles:

Configurar Vista

Abre Opciones de vista en la barra de herramientas del esquema:

• Visibilidad y orden de columnas abre un borrador en la tabla. Agrega u oculta columnas, arrastra para reordenar y elige Aplicar para guardar o Cancelar para descartar.
• La densidad y los anchos de columnas se aplican de inmediato y se guardan en este navegador.
• El coloreado condicional usa Guardar para almacenar las reglas. Las columnas y las reglas condicionales son preferencias personales de esta cuenta, espacio de trabajo y esquema.
• Los colores de celdas cambian los metadatos compartidos del registro de inmediato. Otras personas con acceso al registro pueden verlos.

Con campos de referencia puedes agregar columnas del esquema relacionado. Definición controla los campos y tipos del esquema; ocultar una columna no elimina su campo ni sus registros. Los filtros guardados conservan su comportamiento y no guardan una vista completa.

Exportar Datos

Exporta tus datos en multiples formatos para compartir, respaldar o integrar con otras herramientas.

Formatos de Exportacion

Como Exportar

1. Abre la cuadricula de datos de un esquema
2. Haz clic en Exportar Datos en la barra de herramientas
3. Selecciona tu formato preferido
4. Las exportaciones pequeñas se crean inmediatamente
5. Las exportaciones mas grandes se procesan en segundo plano y aparecen en la bandeja de exportaciones cuando estan listas
6. Para Google Sheets, la exportacion completada proporciona un enlace a la nueva hoja de calculo

Que se Exporta

• Todas las columnas visibles en tu configuracion de vista actual
• Los campos de referencia se resuelven para mostrar valores reales (ej., nombres de productos en lugar de IDs)
• Los filtros activos y el orden de clasificacion se aplican a la exportacion
• Las exportaciones de reportes respetan la agrupacion y los filtros de origen del reporte
• Los archivos de exportacion en segundo plano estan disponibles desde la bandeja de exportaciones por tiempo limitado

Historial de Edicion

EasyData rastrea todos los cambios en tus entradas:

1. Haz clic en Historial en la barra de herramientas (icono de reloj)
2. Ve una linea de tiempo de todos los cambios
3. Ve que se cambio y cuando
4. Ve valores antes/despues de cada edicion

Para cada cambio, puedes ver:

• Marca de Tiempo — Cuando ocurrio el cambio
• Operacion — Crear, Actualizar o Eliminar
• ID de Entrada — Cual entrada fue afectada
• Campos Cambiados — Cuales campos fueron modificados
• Valores Antes/Despues — Los valores antiguos y nuevos

Validacion de Datos

EasyData valida tus entradas basandose en la definicion del esquema:

• Campos Requeridos — Deben tener un valor antes de guardar
• Validacion de Tipo — Los valores deben coincidir con el tipo de campo (numeros, booleanos, etc.)
• Validacion de Formato — Los formatos de email y URL son verificados

Cuando es posible, EasyData convierte valores automaticamente (ej., cadenas vacias en campos numericos se convierten en null, cadenas “true”/“false” se convierten en booleanos).

Consejos para el Exito

Comienza Simple

Comienza con un esquema basico y agrega complejidad segun sea necesario. Siempre puedes agregar nuevos campos o crear relaciones despues.

Usa la Asistencia de IA

No dudes en usar las funciones de IA! Ya sea creando esquemas o agregando datos, describir cosas en lenguaje natural a menudo ahorra tiempo.

Aprovecha las Referencias

En lugar de escribir valores repetidos (como categorias o estados), crea un esquema separado y usa referencias. Esto previene errores de escritura y facilita las actualizaciones.

Habilita Campos Embebidos

Para esquemas que referenciaras frecuentemente (como Contactos o Categorias), habilita campos embebidos en informacion identificadora. Esto hace que la entrada asistida por IA sea mucho mas poderosa.

Exporta Regularmente

Usa la funcion de Exportar para respaldar tus datos o compartirlos con otros en formato Excel.