Planifica viajes con un agente de IA accesible en todo Google Workspace

Nivel de programación: Avanzado
Duración: 45 minutos
Tipo de proyecto: Complemento de Google Workspace que extiende Chat, Gmail, Calendario, Drive y Documentos, Hojas de cálculo y Presentaciones.

En este instructivo, se muestra cómo publicar agentes de IA en Google Workspace como complementos de Google Workspace con Apps Script o extremos HTTP. Una vez publicado el complemento, los usuarios podrán interactuar con los agentes de IA dentro de sus flujos de trabajo.

Descripción general

En este tutorial, implementará la muestra Travel Concierge del Agent Development Kit (ADK). El Conserje de Viajes es una IA multiagente conversacional que utiliza herramientas como la API de Places de la plataforma de Google Maps, Google Search Grounding y un servidor de Protocolo de Contexto de Modelo (MCP).

De forma predeterminada, el ADK proporciona interfaces de chat y texto para los desarrolladores. En este instructivo, agregarás una interfaz gráfica de usuario (GUI) a las aplicaciones de Google Workspace a la que tus usuarios podrán acceder directamente en Chat, Gmail, Calendario, Drive, Documentos, Hojas de cálculo y Presentaciones.

• 

  Figura 1: Utilizar el agente de IA del chat para generar ideas de viaje.

• 

  Figura 2: Utilizar el agente de IA de Gmail para planificar un viaje a partir del contexto del correo electrónico seleccionado.

Objetivos

• Configura el entorno.
• Implementa el agente de IA.
• Configura el proyecto.
• Implementar en Gmail, Calendar, Drive, Docs, Sheets, Slides.
• Implementar en Chat
• Prueba la solución.

Acerca de esta solución

Esta solución se basa en las siguientes tecnologías principales: el ADK, Google Cloud y las APIs de Google Workspace, Vertex AI Agent Engine y el framework de tarjetas.

Las GUI están diseñadas de manera diferente para las aplicaciones de Chat y las que no son de Chat (Gmail, Calendario, Drive, Documentos, Hojas de cálculo y Presentaciones) para tener en cuenta sus funciones y limitaciones específicas.

Funciones

Las siguientes funciones de la aplicación Travel Concierge son comunes en todas las aplicaciones de Google Workspace:

• Sesiones de usuario persistentes: Vertex AI administra las sesiones para la persistencia. Cada usuario comparte una sesión en todas las aplicaciones de Workspace. Los usuarios pueden restablecer manualmente su sesión para iniciar una conversación nueva.

• Mensajería enriquecida: Los usuarios envían mensajes de texto y reciben respuestas con texto enriquecido y widgets de tarjetas.

• Manejo de errores: Los errores inesperados se manejan de manera elegante mediante reintentos y estados configurables en las respuestas.

La app de Chat tiene las siguientes funciones adicionales:

• Mensajes multimodales para los usuarios: Los usuarios pueden enviar mensajes con archivos adjuntos, incluidos audio y video grabados directamente desde el espacio de Chat.

• Respuestas más avanzadas visualmente: Las respuestas se pueden generar con widgets más avanzados, como carruseles con imágenes, ya que se basan en las funciones exclusivas de Chat del framework de tarjetas y en más espacio de renderización.

Otras aplicaciones tienen estas funciones adicionales:

• Contexto del perfil de Google: Los usuarios pueden enviar mensajes con la información de su perfil (limitado a cumpleaños en este ejemplo).

• Contexto de Gmail: Los usuarios pueden enviar mensajes con correos electrónicos (limitados a un asunto y un cuerpo en este ejemplo).

• Acceso al espacio de chat del agente: Los usuarios pueden abrir el espacio de mensajes directos (MD) de la aplicación de chat en una nueva pestaña con un clic en un botón.

Arquitectura

La aplicación Travel Concierge recibe y procesa eventos de interacción de complementos de Google Workspace desde aplicaciones de Google Workspace, utiliza Vertex AI para activar el agente de IA de ADK y gestionar las sesiones de usuario, y se basa en las API de Google Cloud y Google Workspace para recopilar contexto y mostrar respuestas.

Los siguientes diagramas muestran el flujo principal del usuario: enviar un mensaje al agente de IA.

HTTP

• 

  Figura 3: La aplicación de chat completa el contexto con los archivos adjuntos del mensaje del usuario y envía un conjunto de mensajes con el historial de las interacciones de los subagentes y la respuesta general final en orden cronológico.

• 

  Figura 4: Las aplicaciones que no son de Chat completan el contexto con el perfil de Google del usuario y la selección de elementos, y muestran un conjunto de secciones con el historial de las interacciones del subagente y la respuesta general final en orden cronológico inverso.

Apps Script

• 

  Figura 3: La aplicación de chat completa el contexto con los archivos adjuntos del mensaje del usuario y envía un conjunto de mensajes con el historial de las interacciones de los subagentes y la respuesta general final en orden cronológico.

• 

  Figura 4: Las aplicaciones que no son de chat completan el contexto con el perfil de Google del usuario y la selección de elementos, y muestran un conjunto de secciones con el historial de las interacciones de los subagentes y la respuesta general final en orden cronológico inverso.

Requisitos previos

• Una cuenta de Google Workspace para empresas o Enterprise con acceso a Google Chat

• Un navegador web con acceso a Internet

• Requisitos previos específicos del agente de IA de Travel Concierge ADK

  • Python 3.10+: Para la instalación, siga las instrucciones en el sitio web oficial de Python.
  • uv: Para la instalación, siga las instrucciones en el sitio web oficial uv.
  • Google Cloud CLI: Para la instalación, sigue las instrucciones del sitio web oficial de Google Cloud.

Prepare el entorno

En esta sección, se muestra cómo crear y configurar un proyecto de Google Cloud.

Crea un proyecto de Google Cloud

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Crear un proyecto.

   Ir a Crear un proyecto

2. En el campo Nombre del proyecto, ingresa un nombre descriptivo para tu proyecto.

   Opcional: Para editar el ID del proyecto, haz clic en Editar. El ID del proyecto no se puede cambiar después de que se crea el proyecto. Por lo tanto, elige un ID que abarque tus necesidades durante todo el ciclo de vida del proyecto.

3. En el campo Ubicación, haga clic en Examinar para mostrar posibles ubicaciones para su proyecto. Luego, haga clic en Seleccionar.
   Precaución: ¿No encuentras tu organización de Google Workspace?
   Esto significa que no accediste a una cuenta de Google Workspace. Algunas de las funciones que se describen en la documentación para desarrolladores de Google Workspace solo están disponibles para los proyectos asociados a una organización.
4. Haz clic en Crear. La consola de Google Cloud te lleva a la página del Panel de control y tu proyecto se crea en pocos minutos.

gcloud CLI

En uno de los siguientes entornos de desarrollo, accede a Google Cloud CLI (gcloud):

• Cloud Shell: Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.
  Activa Cloud Shell
• Shell local: Para usar un entorno de desarrollo local, instala e inicializa la CLI de gcloud.
  Para crear un proyecto en la nube, utilice el comando gcloud projects create:

  gcloud projects create PROJECT_ID

  Reemplace PROJECT_ID estableciendo el ID del proyecto que desea crear.

Habilitar la facturación para el proyecto en la nube

Si no puede vincular una cuenta de facturación, no tiene los permisos necesarios para realizar este cambio. Para obtener más información, consulte Permisos necesarios para habilitar la facturación.

Consola de Google Cloud

1. En la consola de Google Cloud, vaya a Billing. Haga clic en Menú > Facturación > Mis proyectos.

   Ir a Facturación para Mis Proyectos

2. En Seleccione una organización, elija la organización asociada con su proyecto de Google Cloud.
3. En la fila del proyecto, abra el menú Acciones (), haga clic en Cambiar facturación y elija la cuenta de facturación en la nube.
4. Haz clic en Establecer cuenta.

gcloud CLI

1. Para listar las cuentas de facturación disponibles, ejecute:

   gcloud billing accounts list

2. Vincular una cuenta de facturación con un proyecto de Google Cloud:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   Reemplaza lo siguiente:

   • PROJECT_ID es el ID de proyecto para el proyecto en la nube para el que desea habilitar la facturación.
   • BILLING_ACCOUNT_ID es el ID de la cuenta de facturación que se vinculará con el proyecto de Google Cloud.

Habilita las APIs de Google Cloud

HTTP

1. En la consola de Google Cloud, habilite las API de Vertex AI, Places, People, Google Chat, Gmail, Cloud Build, Cloud Functions, Cloud Pub/Sub, Cloud Logging, Artifact Registry, Cloud Run y los complementos de Google Workspace.

   Habilitar las API

2. Confirma que habilitarás las APIs en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.

3. Confirma que habilitarás las APIs correctas y, luego, haz clic en Habilitar.

Apps Script

1. En la consola de Google Cloud, habilita las APIs de Vertex AI, Places, People y Google Chat.

   Habilitar las API

2. Confirma que habilitarás las APIs en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.

3. Confirma que estás habilitando las API correctas y luego haz clic en Habilitar.

Obtén una clave de la API de Places de Google Maps Platform

1. En la consola de Google Cloud, ve a la página Google Maps Platform > Keys & Credentials.

   Ir a Claves y credenciales

2. En el diálogo Comienza a usar Google Maps Platform, se muestra la clave de API que acabas de crear, una cadena alfanumérica. Necesitarás esta cadena en las siguientes secciones.

Nota: Si ya tienes una clave de API adecuada, se mostrará la lista de claves de API, no el diálogo Comienza a usar Google Maps Platform. Selecciona Mostrar clave para que se muestre la clave.

Crea una cuenta de servicio en la consola de Google Cloud

Cree una nueva cuenta de servicio con el rol Vertex AI User siguiendo estos pasos:

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Haga clic en Crear cuenta de servicio.
3. Completa los detalles de la cuenta de servicio y, luego, haz clic en Crear y continuar.
   Nota: De forma predeterminada, Google crea un ID de cuenta de servicio único. Si quieres cambiar el ID, modifícalo en el campo ID de cuenta de servicio.
4. Opcional: Asigna roles a tu cuenta de servicio para otorgar acceso a los recursos de tu proyecto de Google Cloud. Para obtener más detalles, consulta Otorga, cambia y revoca el acceso a los recursos.
5. Haz clic en Continuar.
6. Opcional: Ingresa los usuarios o grupos que pueden administrar esta cuenta de servicio y realizar acciones con ella. Para obtener más detalles, consulta Administra la suplantación de identidad de cuentas de servicio.
7. Haz clic en Listo. Toma nota de la dirección de correo electrónico de la cuenta de servicio.

gcloud CLI

1. Crea la cuenta de servicio:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Opcional: Asigna roles a tu cuenta de servicio para otorgar acceso a los recursos de tu proyecto de Google Cloud. Para obtener más detalles, consulta Otorga, cambia y revoca el acceso a los recursos.

La cuenta de servicio aparecerá en la página de cuentas de servicio. A continuación, crea una clave privada para la cuenta de servicio.

Crea una clave privada

Advertencia: Este ejemplo usa una clave de cuenta de servicio exportada para mayor simplicidad. No se recomienda exportar una clave privada en producción porque no debe almacenarse en una ubicación insegura, como el control de origen.

Para obtener más información sobre las implementaciones seguras de cuentas de servicio y las prácticas recomendadas, consulta Elige cuándo usar cuentas de servicio.

Para crear y descargar una clave privada para la cuenta de servicio, sigue estos pasos:

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Selecciona tu cuenta de servicio.
3. Haz clic en Claves > Agregar clave > Crear clave nueva.
4. Selecciona JSON y, luego, haz clic en Crear.

   Se generará y descargará el nuevo par de claves pública/privada en tu equipo como un archivo nuevo. Guarda el archivo JSON descargado como credentials.json en tu directorio de trabajo. Este archivo es la única copia de esta clave. Para obtener información sobre cómo almacenar tu clave de forma segura, consulta Cómo administrar claves para cuentas de servicio.

5. Haz clic en Cerrar.

Para obtener más información sobre las cuentas de servicio, consulta Cuentas de servicio en la documentación de IAM de Google Cloud.

Cómo configurar la pantalla de consentimiento de OAuth

Los complementos de Google Workspace requieren una configuración de pantalla de consentimiento. Configurar la pantalla de consentimiento de OAuth de tu complemento define lo que Google muestra a los usuarios.

1. En el menú de la consola de Google Cloud, ve a > Google Auth platform > Branding.

   Ir a Desarrollo de la marca

2. Si ya configuraste el Google Auth platform, puedes configurar los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Branding, Audience y Data Access. Si ves un mensaje que dice Google Auth platform aún no se configuró, haz clic en Comenzar:
1. En Información de la app, en Nombre de la app, ingresa un nombre para la app.
2. En Correo electrónico de asistencia del usuario, elige una dirección de correo electrónico de asistencia a la que los usuarios puedan comunicarse contigo si tienen preguntas sobre su consentimiento.
3. Haz clic en Siguiente.
4. En Público, selecciona Interno.
5. Haz clic en Siguiente.
6. En Información de contacto, ingresa una dirección de correo electrónico en la que puedas recibir notificaciones sobre cualquier cambio en tu proyecto.
7. Haz clic en Siguiente.
8. En Finalizar, revisa la Política de Datos del Usuario de los Servicios de las APIs de Google y, si la aceptas, selecciona Acepto la Política de Datos del Usuario de los Servicios de las APIs de Google.
9. Haz clic en Continuar.
10. Haz clic en Crear.
3. Por el momento, puedes omitir la adición de permisos. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, deberás cambiar el Tipo de usuario a Externo. Luego, agrega los permisos de autorización que requiere tu app. Para obtener más información, consulta la guía completa Configura el consentimiento de OAuth.

Implementa el agente de IA del ADK de Travel Concierge

1. Si aún no lo hiciste, autentícate con tu cuenta de Google Cloud y configura Google Cloud CLI para usar tu proyecto de Google Cloud.

   gcloud auth application-default login
   gcloud config set project PROJECT_ID
   gcloud auth application-default set-quota-project PROJECT_ID

   Reemplaza PROJECT_ID por el ID del proyecto de Cloud que creaste.

2. Descarga este repositorio de GitHub

   Descargar

3. En tu entorno de desarrollo local preferido, extrae el archivo descargado y abre el directorio adk-samples/python/agents/travel-concierge.

   unzip adk-samples-main.zip
   cd adk-samples-main/python/agents/travel-concierge

4. Crea un nuevo bucket de Cloud Storage dedicado al agente de IA del ADK.

   gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

   Reemplaza lo siguiente:

   1. CLOUD_STORAGE_BUCKET_NAME con un nombre de bucket único que desees usar.
   2. PROJECT_ID con el ID del proyecto en la nube que creó.
   3. PROJECT_LOCATION con la ubicación del proyecto de Cloud que creaste.

5. Configura las siguientes variables de entorno:

   export GOOGLE_GENAI_USE_VERTEXAI=1
   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
   export GOOGLE_PLACES_API_KEY=PLACES_API_KEY
   export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME
   export TRAVEL_CONCIERGE_SCENARIO=travel_concierge/profiles/itinerary_empty_default.json

   Reemplaza lo siguiente:

   1. PROJECT_ID por el ID del proyecto de Cloud que creaste.
   2. PROJECT_LOCATION con la ubicación del proyecto de Cloud que creaste.
   3. PLACES_API_KEY con la cadena de la clave API que creó.
   4. CLOUD_STORAGE_BUCKET_NAME con el nombre del bucket que creó.

6. Instala e implementa el agente de IA del ADK.

   uv sync --group deployment
   uv run python deployment/deploy.py --create

7. Recupera el número de proyecto y el ID del motor del último registro impreso como PROJECT_NUMBER y ENGINE_ID, respectivamente. Necesitarás ambos más adelante para configurar tu proyecto.

   Created remote agent: projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/ENGINE_ID

Revisa el código de muestra

De manera opcional, antes de configurar el proyecto, tómate un momento para revisar y familiarizarte con el código de muestra alojado en GitHub.

Python

Ver en GitHub

Apps Script

Ver en GitHub

Crea y configura el proyecto

Python

1. Descarga este repositorio de GitHub

   Descargar

2. En tu entorno de desarrollo local preferido, extrae el archivo descargado y abre el directorio add-ons-samples/python/travel-adk-ai-agent.

   unzip add-ons-samples-main.zip
   cd add-ons-samples-main/python/travel-adk-ai-agent

3. Mueve el archivo de claves JSON credentials.json de la cuenta de servicio que descargaste en los pasos anteriores al directorio del proyecto.

4. En la consola de Google Cloud, ve a Cloud Run:

   Ir a Cloud Run

5. Haz clic en Escribe una función.

6. En la página Crear servicio, configura tu función:

   1. En el campo Nombre del servicio, ingresa travel-concierge-app.
   2. En la lista Región, seleccione la ubicación del proyecto en la nube que creó, PROJECT_LOCATION.
   3. Debajo de URL del punto final, haga clic en .
   4. En la lista Entorno de ejecución, selecciona la versión más reciente de Python.
   5. En la sección Autenticación, seleccione Permitir acceso público.
   6. En la sección Contenedores, volúmenes, redes, seguridad, bajo Recursos:
      1. En el campo Memoria, seleccione 1 GiB.
      2. En el campo CPU, selecciona 2.
   7. Haz clic en Crear y espera a que Cloud Run cree el servicio. La consola te redireccionará a la pestaña Fuente.

7. En tu entorno de desarrollo local preferido, despliega el código fuente del proyecto:

   gcloud run deploy travel-concierge-app --quiet --source . \
       --region PROJECT_LOCATION  \
       --function adk_ai_agent  \
       --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

   Reemplaza lo siguiente:

   1. PROJECT_LOCATION con la ubicación de la función de Cloud Run que creó anteriormente.
   2. LOCATION con la ubicación del proyecto de Google Cloud creado en pasos anteriores, PROJECT_LOCATION.
   3. PROJECT_NUMBER con el número de proyecto del agente de IA de Travel Concierge ADK implementado en pasos anteriores.
   4. ENGINE_ID con el ID del motor del agente de IA del ADK de Travel Concierge implementado en los pasos anteriores.
   5. BASE_URL con la URL del punto de conexión que copió anteriormente.

Apps Script

Para crear un proyecto de Apps Script y configurarlo para usar el agente de IA de Travel Concierge ADK implementado:

1. Haz clic en el siguiente botón para abrir el proyecto de Apps Script del agente de IA del ADK de Travel Concierge.
   Abre el proyecto

2. Haz clic en Resumen y, luego, en Crear una copia.

3. Asigna un nombre a tu copia del proyecto de Apps Script:

   1. Haz clic en Copia del agente de IA del ADK de asistente de viajes.
   2. En Título del proyecto, escribe Travel Concierge ADK AI Agent.
   3. Haga clic en Cambiar nombre.

4. En tu proyecto de Apps Script, haz clic en Editor y mueve el archivo VertexAi.gs hacia arriba hasta que quede sobre el archivo AgentHandler.gs con la acción de archivo Mover archivo hacia arriba.

5. En tu proyecto de Apps Script, haz clic en Configuración del proyecto, luego en Editar propiedades de la secuencia de comandos y, por último, en Agregar propiedad de la secuencia de comandos para agregar las siguientes propiedades de la secuencia de comandos:

6. ENGINE_ID con el ID del motor del agente de IA del ADK de Travel Concierge implementado en los pasos anteriores, ENGINE_ID.

7. LOCATION con la ubicación del proyecto de Google Cloud creado en los pasos anteriores, PROJECT_LOCATION.

8. PROJECT_NUMBER con el número de proyecto del agente de IA del ADK de Travel Concierge implementado en los pasos anteriores, PROJECT_NUMBER.

9. SERVICE_ACCOUNT_KEY con la clave JSON de la cuenta de servicio que se descargó en los pasos anteriores, como { ... }.

10. Haz clic en Guardar las propiedades de las secuencias de comandos.

11. En tu proyecto de Apps Script, haz clic en Configuración del proyecto.

12. En Proyecto de Google Cloud, haz clic en Cambiar proyecto.

13. En Número de proyecto de GCP, pega el número de proyecto del agente de IA del ADK de Travel Concierge que implementaste en los pasos anteriores, PROJECT_NUMBER.

14. Haz clic en Establecer el proyecto. Ahora, el proyecto de Cloud y el proyecto de Apps Script están conectados.

Implementa en Gmail, Calendario, Drive, Documentos, Hojas de cálculo y Presentaciones

Python

Usa una implementación de complemento de Google Workspace para instalar el proyecto de ejemplo en todas las aplicaciones de Google Workspace (excepto Google Chat) y habilitar las pruebas.

1. En tu entorno de desarrollo local preferido, abre el archivo deployment.json del código fuente del proyecto y reemplaza todas las ocurrencias de $BASE_URL por el valor de BASE_URL, la URL del extremo que copiaste en los pasos anteriores.

2. Crea una implementación de complemento de Google Workspace llamada travel-concierge-addon:

   gcloud workspace-add-ons deployments create travel-concierge-addon \
       --deployment-file=deployment.json

3. Instala la implementación del complemento de Google Workspace:

   gcloud workspace-add-ons deployments install travel-concierge-addon

Apps Script

Instala el proyecto de Apps Script en todas las aplicaciones de Google Workspace (excepto Google Chat) para habilitar las pruebas.

1. En tu proyecto de Apps Script, haz clic en Implementar > Implementaciones de prueba y, luego, en Instalar.

Ahora se puede acceder al complemento desde las barras laterales de las aplicaciones de Google Workspace.

Implementar en Chat

Python

Instala el proyecto de ejemplo en Chat usando la URL del punto de conexión para habilitar las pruebas.

1. En la consola, busca Google Chat API, haz clic en API de Google Chat, luego en Administrar y, por último, en Configuración.

   Ir a la página de configuración de la API de Google Chat

2. Configura la app de Chat:

   1. En el campo Nombre de la app, ingresa Travel ADK AI Agent.
   2. En el campo URL del avatar, ingresa https://goo.gle/3SfMkjb.
   3. En el campo Descripción, ingresa Travel ADK AI Agent.
   4. En Configuración de la conexión, selecciona URL del extremo HTTP.
   5. En Disparadores, seleccione Usar una URL de punto final HTTP común para todos los disparadores.
   6. En el campo URL del extremo HTTP, pega la URL del extremo que copiaste anteriormente, BASE_URL.
   7. Registrar un Comando rápido que utilice la aplicación de chat totalmente implementada:
      1. Debajo de Comandos, haga clic en Agregar un comando.
      2. En ID de comando, escribe 1.
      3. En Descripción, escribe Reset session.
      4. En Tipo de comando, selecciona Comando rápido.
      5. En Nombre, escribe Reset session.
      6. Haz clic en Listo. El comando rápido está registrado y listado.
   8. En Visibilidad, selecciona Hacer que esta app de Chat esté disponible para personas y grupos específicos de Tu dominio de Workspace y escribe tu dirección de correo electrónico.
   9. En Registros, selecciona Registrar errores en Logging.
   10. Haz clic en Guardar.

Apps Script

Instala el proyecto de Apps Script en Chat con el ID de implementación principal para habilitar las pruebas.

1. En tu proyecto de Apps Script, haz clic en Implementar > Implementaciones de prueba y, luego, en Copiar en ID de implementación principal.

2. En la consola, busca Google Chat API, haz clic en API de Google Chat, luego en Administrar y, por último, en Configuración.

   Ir a la página de configuración de la API de Google Chat

3. Configura la app de Chat:

   1. En el campo Nombre de la app, ingresa Travel ADK AI Agent.
   2. En el campo URL del avatar, ingresa https://goo.gle/3SfMkjb.
   3. En el campo Descripción, ingresa Travel ADK AI Agent.
   4. En Configuración de conexión, seleccione Apps Script.
   5. En el campo ID de implementación, pega el ID de implementación principal que copiaste antes.
   6. Registra un comando rápido que usa la app de Chat completamente implementada:
      1. En Comandos, haz clic en Agregar un comando.
      2. En ID de comando, escribe 1.
      3. En Descripción, escribe Reset session.
      4. En Tipo de comando, selecciona Comando rápido.
      5. En Nombre, escribe Reset session.
      6. Haz clic en Listo. El comando rápido está registrado y listado.
   7. En Visibilidad, selecciona Hacer que esta app de Chat esté disponible para personas y grupos específicos de Tu dominio de Workspace y escribe tu dirección de correo electrónico.
   8. En Registros, selecciona Registrar errores en Logging.
   9. Haz clic en Guardar.

Ahora se puede acceder a la app desde Google Chat.

1. Abre Google Chat.

   Ir a Google Chat

2. Crea el espacio de MD de Chat:

   1. Haz clic en Nuevo chat.
   2. Escribe y selecciona la app Travel ADK AI Agent en la búsqueda.
   3. En el cuadro de diálogo Install app, haz clic en Instalar la app.
   4. Se cierra el diálogo Install app y se selecciona el espacio de MD de chat recién creado.

La app de Chat está lista para responder mensajes.

Prueba el agente

1. Abre Gmail.

   Ir a Gmail

2. Envía el siguiente correo electrónico a tu dirección:

   • Asunto: You need to travel to Paris
   • Body: Please be there between 11/25/2025 and 11/30/2025!

3. Abre el complemento Agente de IA del ADK de viajes desde la barra lateral.

4. Haz clic en Otorgar permisos para completar la configuración del complemento.

5. Haz clic en Enviar después de configurar la siguiente solicitud al agente:

   • Mensaje: Please help me plan this travel!
   • Contexto: Selecciona Correo electrónico actual

   La barra lateral se actualiza con la respuesta del agente.

   

6. Haz clic en Abrir chat para ser redirigido al espacio de mensajes directos de chat.

7. Haz clic en + > Restablecer sesión.

   Recibes un nuevo mensaje que confirma que se ha realizado: OK, let's start from the beginning, what can I help you with?

8. Enviar el mensaje Give me ideas.

   Recibirás mensajes nuevos con la respuesta del agente.

   

9. Envía el mensaje I want to go there! después de subir una foto de cualquier ubicación, como la Torre Eiffel.

   Recibirás mensajes nuevos con la respuesta del agente.

   

Nota: El complemento Travel ADK AI Agent también se puede abrir desde la barra lateral en Calendario, Drive, Documentos, Hojas de cálculo y Presentaciones, de forma similar a como se hace en Gmail.

Limitaciones

HTTP

En las aplicaciones de Google Workspace distintas de Chat, el agente de IA tiene las siguientes limitaciones:

• Es síncrono: Las barras laterales solo se pueden actualizar en respuesta a las interacciones del usuario, por lo que las respuestas del agente de IA se muestran solo después de una finalización completa (sin transmisión).

• Puede agotarse el tiempo de espera: Las actualizaciones de la barra lateral se agotan cuando tardan más de unos minutos en completarse.

Estas limitaciones no existen en el chat.

Apps Script

En todas las aplicaciones de Google Workspace, el agente de IA llama a las API REST de Vertex AI usando UrlFetchApp, lo que provoca las siguientes limitaciones:

• Es síncrono: Las respuestas del agente de IA se devuelven solo después de la finalización completa (sin transmisión).

• Puede agotarse el tiempo de espera: El agente de IA solicita que se agote el tiempo de espera cuando tarda aproximadamente más de un minuto en completarse.

Personalización

Esta solución admite agentes de IA del ADK alojados en Vertex AI Agent Engine, un subconjunto de las IU de las aplicaciones de Google Workspace y renderizaciones de respuestas específicas para las respuestas de la muestra de Travel Concierge. La solución usa un framework extensible, por lo que puedes personalizarla modificando los siguientes archivos:

Python

• main.py: Define la lógica principal de las IU y las interacciones del usuario (controladores de eventos de Google Workspace). Una extensión típica sería habilitar los documentos de Drive como función de contexto para la aplicación de Drive, de manera similar a lo que se hace con los mensajes de Gmail para la aplicación de Gmail.

• vertex_ai.py: Administra las sesiones, las respuestas y los errores del agente de IA, y define interfaces específicas de Vertex AI para implementar la compatibilidad con las interacciones del agente y la renderización de respuestas. Las extensiones típicas serían agregar compatibilidad con varias sesiones para conversaciones de usuarios independientes y otras plataformas de administración de agentes de IA.

• agent_handler.py: Implementa interfaces específicas de Vertex AI definidas en vertex_ai.py en los casos específicos de aplicaciones de chat y que no son de chat. Una extensión típica sería agregar botones para que los usuarios envíen comentarios sobre las respuestas de los agentes de IA.

• google_workspace.py: Implementa interacciones de plataforma de gestión de agentes no IA mediante llamadas a la API. En este ejemplo, solo se usan las APIs de Google Workspace para recopilar detalles del contexto y realizar acciones. Una extensión típica consistiría en agregar funciones para recuperar datos comerciales de Google Calendar o de un sistema de gestión de relaciones con el cliente (CRM).

• travel_agent_ui_render.gs: Implementa renderizaciones de respuestas específicas del asistente de viajes para los subagentes y las aplicaciones de Workspace. Las extensiones típicas consistirían en agregar compatibilidad con nuevas renderizaciones de respuestas para mostrar gráficamente las opciones de vuelos y otros agentes de IA.

Apps Script

• Code.gs: Define las principales IU y la lógica de las interacciones del usuario (controladores de eventos de Google Workspace). Una extensión típica sería habilitar los documentos de Drive como función de contexto para la aplicación de Drive, de manera similar a lo que se hace con los mensajes de Gmail para la aplicación de Gmail.

• VertexAi.gs: Administra las sesiones, las respuestas y los errores del agente de IA, y define interfaces específicas de Vertex AI que se deben implementar para admitir las interacciones del agente y la renderización de respuestas. Las extensiones típicas serían agregar compatibilidad con varias sesiones para conversaciones de usuarios independientes y otras plataformas de administración de agentes de IA.

• AgentHandler.gs: Implementa interfaces específicas de Vertex AI definidas en VertexAi.gs en los casos específicos de aplicaciones de chat y no de chat. Una extensión típica sería agregar botones para que los usuarios envíen comentarios sobre las respuestas de los agentes de IA.

• GoogleWorkspace.gs: Implementa interacciones de plataforma de gestión de agentes no IA mediante llamadas a la API. En este ejemplo, solo se utilizan las API de Google Workspace para recopilar detalles de contexto y realizar acciones. Una extensión típica consistiría en agregar funciones para recuperar datos comerciales de Google Calendar o de un sistema de gestión de relaciones con el cliente (CRM).

• TravelAgentUiRender.gs: Implementa representaciones de respuesta específicas de Travel Concierge para los subagentes y las aplicaciones de Workspace. Las extensiones típicas consistirían en agregar soporte para nuevas representaciones de respuesta para mostrar gráficamente las opciones de vuelo y otros agentes de IA.

Limpia

Para evitar cargos en su cuenta de Google Cloud por los recursos utilizados en este tutorial, le recomendamos que elimine el proyecto de Cloud.

Precaución: Eliminar un proyecto tiene los siguientes efectos:

• Se borra todo en el proyecto. Si utilizaste un proyecto existente para este instructivo, cuando lo borres, también borrarás cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL en appspot.com, elimine los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.

Si planeas explorar varios tutoriales y guías de inicio rápido, reutilizar proyectos puede ayudarte a evitar exceder los límites de cuota de proyectos.

1. En la consola de Google Cloud, ve a la página Administrar recursos. Haga clic en Menú > IAM y administración > Administrar recursos.

   Ir al Administrador de recursos

2. En la lista de proyectos, seleccione el proyecto que desea eliminar y luego haga clic en Eliminar .
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.

Temas relacionados

• Verifica la veracidad de las declaraciones con un agente de IA del ADK y un modelo de Gemini
• Integra conceptos fundamentales de la IA en las apps de Chat
• Compila una app de Chat como complemento de Google Workspace con Apps Script