Creación de flujos de trabajo con agentes en una aplicación con backend en la nube y ADK

  • PublicPublic
  • 29 Sep, 2026
Creación de flujos de trabajo con agentes en una aplicación con backend en la nube y ADK

Algunas tareas son demasiado complejas para completarse en una sola sesión en el dispositivo. Organizar un viaje completo implica coordinar los horarios de los vuelos, elegir habitaciones de hotel, reservar entradas para museos y planificar los restaurantes. Si se ejecuta un proceso de varios pasos como este directamente en el teléfono, se corre el riesgo de perder el progreso cuando se cierre la aplicación, y manejar tantos pasos junto con las credenciales de API en un dispositivo portátil se complica rápidamente. Para estos flujos de trabajo largos, es más adecuado un backend propio self-hosted: ejecuta los agentes de reservas en segundo plano mientras la aplicación Android permanece conectada a la sesión, muestra el progreso y solicita datos al usuario solo cuando realmente hacen falta.

La base de todo es el Agent Development Kit (ADK). En un ejemplo en Python se define un agente especializado flight_agent mediante Agent(name="Flight Booker", model="gemini-3.1-flash-lite",...) con dos herramientas de función: search_flights(destination, date) y reserve_flight(flight_time). Cabe destacar que en reserve_flight se define require_confirmation=True, por lo que ADK se detiene y espera la aprobación explícita del usuario antes de ejecutar ese paso irreversible. El agente se ejecuta mediante un InMemoryRunner, donde run_async(user_id, session_id) dirige el bucle. ADK se encarga internamente de la ejecución: realiza el seguimiento del contexto de la conversación, enruta los mensajes entre el usuario y el modelo e invoca las herramientas registradas cuando el modelo las solicita, de modo que usted solo tiene que escribir la lógica procedimental, mientras que el framework gestiona la orquestación.

Para transmitir actualizaciones del backend al dispositivo en tiempo real, el servidor usa AG-UI, un protocolo de transporte bidireccional que estandariza los tipos de mensajes entre los agentes y los clientes de UI. El agente puede notificar al cliente eventos del ciclo de vida, mensajes de texto, llamadas a herramientas y cambios de estado, mientras que el cliente envía de vuelta mensajes del usuario, resultados de herramientas y eventos de acción personalizados. En el servidor, AG-UI emite las actualizaciones como Server-Sent Events (por ejemplo, event: TEXT_MESSAGE_CONTENT, que transporta un delta en JSON). En Android, un SDK de Kotlin escucha ese flujo y asigna las cargas útiles a eventos de cliente con tipado seguro: HttpAgent se configura con HttpAgentConfig, RunAgentInput lleva el hilo y un UserMessage, y runAgentObservable(input).collect {... } permite bifurcar según TextMessageStartEvent, TextMessageContentEvent y TextMessageEndEvent.

La renderización de solo estos eventos de texto produce un chatbot básico. Para mostrar componentes interactivos de forma nativa, A2UI permite a los agentes describir elementos de la interfaz de forma dinámica. El cliente declara un catálogo de componentes compatibles, y el servidor envía un JSON con el diseño y las propiedades, por ejemplo, una superficie Flight Reservation, que contiene InteractiveOptionPicker con un mensaje, opciones como "10:00 AM" y "2:00 PM" y un botón de confirmación. En el backend, la integración de A2UI en ADK utiliza A2uiSchemaManagerpara compilar los esquemas JSON de los componentes y las instrucciones de diseño en el prompt del sistema mediante generate_system_prompt(...), de modo que el modelo aprende la estructura exacta que debe generar para producir payloads A2UI válidos que el cliente pueda renderizar.

En el cliente, añadir A2UI comienza con dependencias de Gradle como androidx.a2ui:a2ui-model, androidx.a2ui.compose:compose-runtime, compose-ui y androidx.compose.material3:material3-a2ui todas las versiones 1.0.0-alpha01. Cada clase de componente del catálogo asigna las propiedades JSON a un composable de Jetpack Compose, y un A2uiCatalogpersonalizado, registrado con un catalogId, lo vincula con la definición del servidor. Para los elementos estándar (texto, botones, casillas de verificación y selectores de fecha y hora), las implementaciones listas de Material 3 las proporciona materialA2uiBasicCatalogV1(...), sin necesidad de escribir código propio. BookingAssistantViewModel envía mensajes a A2uiMessageProcessor, cuyo StateFlow activeSurfaces la pantalla lo renderiza con el composable A2uiSurface, que se encarga del seguimiento del estado, los indicadores de carga, el manejo de errores y las transiciones animadas. Ambos lados deben usar el mismo ID de definición del catálogo; si añades o cambias propiedades, hay que subir el número de versión y actualizar la clase de componente correspondiente en Kotlin para no obtener errores de análisis.