XOne API Agent

XOne API Agent desarrolla las API de tus aplicaciones en la plataforma XOne. Le describes lo que necesitas, por ejemplo “crea una API para gestionar la tabla de productos” o “añade un endpoint para registrar pedidos con validación”, y el agente se encarga de todo el ciclo: consulta la estructura de la base de datos de la aplicación, escribe el código, lo compila y lo prueba en un entorno aislado, lo despliega en la plataforma y comprueba que responde.

Si la aplicación indicada ya existe, el agente continúa a partir de su versión actual; si no existe, la crea desde cero. Recuerda lo hablado en la conversación, así que puedes ir pidiendo cambios mensaje a mensaje.

Cuándo usarlo

Quieres publicar una API sobre una base de datos que ya tienes sin escribir el código a mano.
Necesitas añadir endpoints nuevos a una aplicación de XOne existente.
Quieres consultar qué aplicaciones tienes en la plataforma y en qué estado están.
Tu equipo quiere iterar sobre una API desde el chat, probando cada cambio.

Configuración

Necesitas una credencial del servicio XOne Platform API con la dirección de tu plataforma XOne y su clave de gestión. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial del servicio XOne Platform API. Elígela con Seleccionar una credencial o crea una con Crear nueva credencial.
Task	Lo que quieres que haga el agente, con tus palabras. Por defecto, `{input}`, que se sustituye por lo que llega a Input. Puedes añadir otras variables entre llaves; cada una aparece como un campo nuevo.
Input	El texto que sustituye a `{input}` en Task, normalmente conectado desde un Chat Input.
Project Slug (obligatorio)	El identificador de la aplicación en la plataforma, en minúsculas, con números y guiones, por ejemplo `tienda-api` o `inventario-v2`.
DB Connection String	Los datos de conexión a la base de datos MariaDB de la aplicación; se muestran ocultos. Es obligatorio cuando la aplicación todavía no existe. Para una aplicación existente, si lo dejas vacío se usan los datos que ya tiene configurados.

Conexión	Qué conectar
Model (obligatorio)	El modelo de IA que dirige al agente, por ejemplo OpenAI o Anthropic. Para tareas de varios pasos, elige un modelo capaz de usar herramientas con soltura.

Opciones avanzadas

Campo	Qué hace
Project Name	El nombre visible de la aplicación cuando el agente tiene que crearla. Si lo dejas vacío, se usa Project Slug.
System Prompt Override	Sustituye las instrucciones internas del agente. Déjalo vacío para usar las de serie.
Max Turns	Cuánto puede trabajar el agente en cada petición antes de detenerse. Súbelo para APIs con muchos endpoints. Por defecto, 50.
Context Compression Threshold (chars)	Cuando la conversación interna supera este tamaño, se resume la parte más antigua para que el agente pueda seguir con tareas largas. Con 0 no se resume. Por defecto, 60000.
Stream Response	Muestra en el chat, en tiempo real, lo que va haciendo el agente. Por defecto, activado.
Stream Thinking	Muestra también el razonamiento del agente mientras trabaja. Si lo desactivas, verás solo los avisos de cada paso y la respuesta final. Por defecto, activado.

Procesamiento por lotes

Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.

Resultado

Message: la respuesta del agente como mensaje de chat, con lo que ha hecho. Conéctala a un Chat Output.
Result: los datos del trabajo para otros componentes: la respuesta final (final_answer), el identificador de la aplicación (slug y app_id) y si se ha creado nueva (new_app). Cuando el agente crea una aplicación, incluye también la clave para usar su API (consumer_api_key): guárdala en un lugar seguro.

También puedes conectar este componente a la entrada Tools de otro agente para que lo use como herramienta.

Ejemplo

Una distribuidora de material de oficina quiere una API para que su tienda online consulte el catálogo.

Crea la credencial XOne Platform API y elígela en Credential.
Escribe catalogo-api en Project Slug y rellena DB Connection String con los datos de la base de datos del catálogo.
Conecta un modelo de IA a Model, un Chat Input a Input y Message a un Chat Output.
En el chat escribe: Crea una API para consultar los productos y sus existencias, con búsqueda por nombre y por categoría.

El agente crea la aplicación, despliega la API y te devuelve la clave para usarla. Después puedes pedirle en el mismo chat, por ejemplo, Añade un endpoint para consultar los productos sin existencias.

Buenas prácticas

Prueba primero con una base de datos de pruebas antes de trabajar sobre la de producción.
Pide los cambios de uno en uno y revisa el resultado de cada paso.

Componentes relacionados

XOne Agent: otro agente de desarrollo para la plataforma XOne.
Agent: el agente general de NappAI.