XOne AgentV2
XOne AgentV2 es la versión nueva del agente de IA experto en XOne, la plataforma para crear aplicaciones móviles nativas para Android e iOS. Responde preguntas sobre la documentación de XOne y sobre tu proyecto abierto, planifica las tareas de desarrollo y comprueba cada una con el simulador de XOne antes de subirla a CloudStudio.
Cada mensaje pasa primero por una clasificación: si es una pregunta sobre XOne, sobre el proyecto, una tarea de desarrollo o una consulta que necesita información de fuera de XOne, como la forma de integrar la API de otro servicio. En las tareas de desarrollo el agente escribe un plan; en las más complejas te lo enseña para que lo apruebes. Después lo ejecuta y un revisor comprueba que se ha hecho lo que decía el plan.
Convive con la primera versión, XOne Agent: los flujos que ya la usan no cambian.
Cuándo usarlo
- Quieres que el agente desarrolle una funcionalidad en tu proyecto, pero revisando antes el plan de trabajo.
- Un desarrollador pregunta cómo funciona una parte de su proyecto o de la documentación de XOne.
- Necesitas integrar tu aplicación con la API de otro servicio y quieres que el agente investigue cómo hacerlo.
- Quieres que cada cambio se pruebe en el simulador, o en el dispositivo real de CloudStudio, antes de darlo por bueno.
- Necesitas que el agente genere iconos para la aplicación.
Configuración
Necesitas una credencial XOne WebStudio con los datos de acceso a CloudStudio que te da XOne. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial XOne WebStudio con la que el agente accede a CloudStudio. |
| Model (obligatorio) | Conector para el modelo de lenguaje principal, el que responde y hace la mayor parte del trabajo. |
| User Prompt | La petición del usuario. Por defecto, {input}: el mensaje que llega del chat. |
| CloudStudio Project | El proyecto de XOne sobre el que trabaja el agente. Rellénalo siempre: el agente nunca trabaja fuera de un proyecto y, sin él, el mensaje falla. |
| CloudStudio Email | El correo de tu usuario de CloudStudio. El agente trabaja en tu nombre con ese usuario y guarda su memoria de largo plazo para él. |
| Fast Model | Conector opcional para un modelo ligero que usa solo el especialista en la documentación de XOne, que es el que más consultas hace. Si no lo conectas, se usa el de Model. |
| Developer Model | Conector opcional para el modelo que programa los cambios en el proyecto. Si no lo conectas, se usa el de Model. |
| Planner Model | Conector opcional para el modelo que escribe el plan y lo divide en tareas. Si no lo conectas, se usa el de Model. |
| Vision Model | Conector opcional para un modelo capaz de leer imágenes, que compara las pantallas construidas y los iconos generados con su diseño. |
| Tools (executor) | Conector opcional para dar herramientas adicionales a la parte que edita el proyecto. |
| Web Search | Conector opcional para un componente de búsqueda web. Lo usa el agente cuando la respuesta está fuera de XOne. |
Pestañas Prompts y Development
- En la pestaña Prompts están las instrucciones de cada parte del agente, por ejemplo Voice Prompt (responder), la que redacta la respuesta que lees, o Planner Prompt (task breakdown), la que divide el trabajo en tareas. Vienen preparadas; cámbialas solo si quieres ajustar cómo trabaja alguna.
- En la pestaña Development está el conector Sandbox: conecta un componente de sandbox para que el agente pueda generar iconos en SVG, PNG o JPG. Sin él, el agente funciona igual pero no genera imágenes, y te lo dice.
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Auto-approve plans | Si está activado, el agente ejecuta los planes sin pedirte aprobación. Úsalo solo en flujos sin una persona al otro lado. Desactivado por defecto. |
| Auto-resume unfinished work | Qué pasa si llega una petición nueva cuando un plan anterior tiene trabajo pendiente. Desactivado, el agente te pregunta; activado, sigue con el trabajo anterior sin preguntar y deja la petición nueva para después. Desactivado por defecto. |
| Test on the real device (live-simulator) | Si está activado, antes de dar por buena una tarea el agente la prueba en el dispositivo real de CloudStudio: sube los cambios, abre la aplicación y recorre la pantalla. Es más lento. Desactivado por defecto. |
| Live-simulator navigation route | El camino hasta la pantalla que se prueba, en una línea con pasos separados por →, por ejemplo pulsa "Carrito" → espera "Listado". Los pasos posibles son pulsa "Texto", rellena "Campo" = "valor", espera "Texto" y tecla BACK o tecla ENTER. Vacío, se prueba solo la pantalla de inicio. |
| Live-simulator login user | El usuario para entrar en la aplicación si el camino pasa por una pantalla de acceso. Se guarda oculto. |
| Live-simulator login password | La contraseña de ese usuario. Se guarda oculta. |
| Use memory | Si está activado, el agente recuerda la conversación entre mensajes. Desactivado por defecto. |
| Stream | Si está activado, la respuesta se muestra a medida que se escribe. Desactivado por defecto. |
Resultado
La salida Response es la respuesta del agente: la explicación, el plan que te propone para aprobar o el resumen de lo que ha hecho y comprobado. Cuando el agente necesita tu aprobación o una decisión, el mensaje termina ahí y espera a que respondas en el chat. Conéctala a la salida del chat.
La salida Agent entrega el propio agente, para conectarlo a otro componente que lo dirija. Cuando conectas una de las dos salidas, la otra se oculta.
Ejemplo
Un equipo quiere que el agente desarrolle sobre su aplicación de pedidos con revisión previa.
- Añade un componente de entrada de chat y conéctalo a User Prompt.
- Conecta un componente de modelo a Model y, si quieres un plan más cuidado, otro más capaz a Planner Model.
- En Credential elige la credencial XOne WebStudio, en CloudStudio Project escribe el nombre del proyecto y en CloudStudio Email el correo del desarrollador.
- Activa Use memory para que el agente recuerde el plan entre mensajes.
- Conecta Response a la salida del chat y pide “Añade al carrito un botón para vaciarlo”. Revisa el plan que te propone y apruébalo.
Buenas prácticas
- Deja Auto-approve plans desactivado en los flujos de chat: revisar el plan es la mejor forma de evitar cambios que no querías.
- Activa Test on the real device (live-simulator) solo en las tareas que lo necesiten, porque alarga cada tarea.
- Conecta un Web Search si tu equipo pregunta a menudo por integraciones con otros servicios.
Componentes relacionados
- XOne Agent: la primera versión del agente.