Endpoint Response Model Generator: de la respuesta de una API a un modelo
Conectar un sistema externo suele empezar con una respuesta JSON y una página en blanco. ¿Qué campos se convierten en columnas? ¿Qué haces con las listas anidadas? Endpoint Response Model Generator lee la respuesta de una prueba de endpoint y propone las dos partes de la solución: un modelo de datos para los registros y las asignaciones de campos para un workflow de sincronización. Aparece donde configuras y pruebas los endpoints de API, en los ajustes de integración.
Worknano es personalizable con IA y se centra en la funcionalidad principal. Los datos sincronizados acaban en un modelo normal, con la misma UI, UX y base de datos que todo lo demás, y no en un almacén de datos especial.
Qué hace
- Lee el cuerpo de respuesta de un endpoint probado, además de su nombre, ruta, método y slug cuando los proporcionas.
- Propone un modelo plano. Los valores individuales útiles se convierten en columnas reales, sobre todo los que vas a informar o filtrar.
- Recomienda cómo sincronizar. Una respuesta con un objeto sugiere actualizar un registro existente. Una lista, o un contenedor habitual que envuelve una lista, sugiere crear registros.
- Guarda listas u objetos anidados como texto JSON solo cuando no hay una opción mejor.
- Empieza el modelo con un id y lo termina con una marca de fecha y hora de sincronización, y solo asigna los campos que ha generado.
- Gestiona los campos personalizados que el proveedor envía como entradas de nombre, tipo y valor, cuando el modelo de destino tiene dónde guardarlos. La importación añade entonces las definiciones al registro padre y los valores a cada fila.
Cuándo ayuda
- Una importación de CRM. Pruebas el endpoint que lista las oportunidades de otra herramienta. El agente propone un modelo de oportunidades con importe, fase y fecha de cierre como columnas reales.
- Un objeto de ajustes único. Un endpoint devuelve un solo objeto con los datos de tu plan. El agente sugiere un modelo y una regla de actualización, no una fila nueva cada vez.
- Una herramienta de proyectos con campos personalizados. Cada proyecto del origen define sus propios campos. El agente los asigna para que los valores lleguen con sus definiciones.
Cómo funciona con tus datos
Este agente no tiene herramientas. No llama al endpoint por sí mismo y no escribe registros. La prueba del endpoint ya se ha ejecutado, y la respuesta se le pasa. El agente devuelve un borrador de modelo y una sugerencia de asignación, y tú revisas ambos antes de que se guarde nada. Aplicar un modelo es un cambio de configuración, así que se queda en manos de quien puede editar la configuración. Las credenciales y los secretos de conexión nunca forman parte de lo que ve el agente.
Usa un modelo rápido. La entrada es un cuerpo de respuesta y la salida es estructurada, así que la velocidad importa más que la profundidad.
Lo que no hace
- No prueba ni llama al endpoint. Pruébalo tú primero, porque una respuesta sin campos útiles da una propuesta pobre.
- No adivina un significado que la respuesta no muestra. Revisa nombres y tipos, sobre todo en fechas e importes.
- No ejecuta la sincronización. La ejecuta el workflow, una vez que hayas aceptado la asignación.
Para un modelo escrito a mano a partir de una descripción, usa Model Designer. Para el propio paso de sincronización, consulta Workflow Creator.
Hazlo tuyo
Este agente es un registro del módulo Agents. Puedes editar sus instrucciones para que coincidan con tus reglas de nombres, cambiar el modelo o la temperatura, duplicarlo para un proveedor concreto o empezar desde un agente en blanco.
Empieza con Crea tu propio agente, consulta Cómo editar el asistente de página y un agente reutilizable para los pasos del editor, o mira el panorama general en Agentes IA y Asistente IA.