Administra proyectos con Google Chat, Vertex AI y Firestore

En este instructivo, se muestra cómo crear una app de Google Chat que un equipo pueda usar para administrar proyectos en tiempo real. La app de Chat usa Vertex AI para ayudar a los equipos a escribir historias de usuarios (que representan funciones de un sistema de software desde el punto de vista de un usuario para que el equipo las desarrolle) y que persista en una base de datos de Firestore.

• 

  Figura 1: Carlos habla con su equipo sobre el desarrollo de funciones en un espacio de Chat. Mencionar la app de Chat de administración de proyectos le indica a esta app que te ofrece ayuda.

• 
  Figura 2: Con el comando de barra /createUserStory, Carlos crea una historia.
• 
  Figura 3: La app de Chat de administración de proyectos usa Vertex AI para escribir la descripción de la historia y, luego, la comparte en el espacio.
• 
  Figura 4: Charlie hace clic en Editar para finalizar los detalles de la historia. La descripción de la IA es precisa, pero Carlos quiere más detalles, así que hace clic en Expandir para que Vertex AI agregue requisitos a la descripción de la historia. Carlos se asigna la historia a sí mismo, establece el estado como Inicio, selecciona la prioridad y el tamaño adecuados y, luego, hace clic en Guardar.
• 
  Figura 5: En cualquier momento, Charlie puede ver y administrar todas las historias de usuario del equipo con el comando de barra /manageUserStories.

Requisitos previos

• Una cuenta de Google Workspace con acceso a Google Chat

• Acceso a los servicios de Google Cloud para hacer lo siguiente:

  • Crea un proyecto de Google Cloud.
  • Vincular una cuenta de Facturación de Google Cloud al proyecto de Cloud A fin de saber si tienes acceso, consulta Permisos necesarios para habilitar la facturación.

  • Usa las invocaciones de funciones de Google Cloud no autenticadas, que puedes verificar si determinas si tu organización de Google Cloud usa uso compartido restringido del dominio.

  Si es necesario, solicita acceso o permiso a tu administrador de Google Cloud.

• Si usas Google Cloud CLI, un entorno de desarrollo de Node.js configurado para funcionar con gcloud CLI. Consulta Configura un entorno de desarrollo de Node.js.

Objetivos

• Compila una app de Chat que administre proyectos de software ágiles.
• Ayuda a los usuarios a escribir historias de usuario con herramientas de escritura de historias asistidas por IA generativa con Vertex AI:
  • Generar y volver a generar descripciones de historias
  • Amplía las descripciones de las historias desde las notas para completar los requisitos.
  • Corrige la gramática para corregir errores tipográficos.
• Mantén el trabajo actualizado escribiendo en una base de datos de Firestore y leyendo desde ella.
• Facilita la colaboración en un espacio de Chat permitiendo a los usuarios crear, editar, asignar e iniciar historias directamente desde la conversación.

Productos usados

La app de administración de proyectos usa los siguientes productos de Google Workspace y Google Cloud:

• API de Chat: Es una API para desarrollar apps de Google Chat que reciben y responden a eventos de interacción de Chat, como mensajes. La app de administración de proyectos de Google Chat usa la API de Chat para recibir y responder eventos de interacción enviados por Chat y configurar atributos que determinan cómo se muestra en Chat, como el nombre y la imagen de avatar.
• API de Vertex AI: Una plataforma de IA generativa. La app de administración de proyectos de Google Chat usa la API de Vertex AI para escribir títulos y descripciones de historias de usuarios.
• Firestore: Una base de datos de documentos sin servidores La app de administración de proyectos de Google Chat usa Firebase para almacenar datos de historias de usuarios.

• Cloud Functions: Es un servicio de procesamiento ligero sin servidores que te permite crear funciones independientes de un solo propósito que pueden responder a eventos de interacción de Chat sin tener que administrar un servidor o entorno de ejecución. La app de administración de proyectos de Google Chat usa Cloud Functions para alojar el extremo HTTP al que Chat envía eventos de interacción y como plataforma de procesamiento para ejecutar una lógica que procesa y responde a esos eventos.

  Cloud Functions usa los siguientes productos de Google Cloud para compilar, procesar eventos de interacción y alojar recursos de procesamiento:

  • Cloud Build: Es una plataforma de integración, implementación y entrega continuas completamente administrada que ejecuta compilaciones automatizadas.
  • Pub/Sub: Un servicio de mensajería escalable y asíncrono que separa los servicios que producen mensajes de aquellos que los procesan.
  • API de Cloud Run Admin: Un entorno completamente administrado para ejecutar apps alojadas en contenedores.

Arquitectura

La arquitectura de la app de administración de proyectos de Google Chat recibe y procesa eventos de interacción de Chat en un extremo HTTP, usa Vertex AI para ayudar a escribir historias de usuario y almacena los detalles de estas en una base de datos de Firestore. En el siguiente diagrama, se muestra la arquitectura de los recursos de Google Workspace y Google Cloud usados.

La app de administración de proyectos de Google Chat funciona así:

1. Un usuario envía un mensaje en Chat y, luego, invoca la app de administración de proyectos de Google Chat, ya sea mediante un mensaje directo, mencionándola en un espacio o ingresando un comando de barra.

2. Chat envía una solicitud HTTP síncrona al extremo HTTP de la función de Cloud Functions.

3. La app de administración de proyectos de Google Chat procesa la solicitud HTTP:

   1. Vertex AI ayuda a escribir o actualizar una historia de usuario.

   2. Una base de datos de Firestore almacena, recupera, actualiza o borra datos de historias de usuarios.

4. Cloud Functions muestra una respuesta HTTP a Chat, que se la muestra al usuario como un mensaje o un diálogo.

Prepare el entorno

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

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, por lo que debes elegir un ID que satisfaga tus necesidades durante todo el ciclo de vida del proyecto.

3. En el campo Ubicación, haz clic en Explorar para mostrar las ubicaciones posibles del 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 proyectos asociados con una organización.
4. Haz clic en Crear. La consola de Google Cloud navega a la página Panel y tu proyecto se crea en unos 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.
  Activar Cloud Shell
• Shell local: Para usar un entorno de desarrollo local, instala e initialize la CLI de gcloud.
  Para crear un proyecto de Cloud, usa el comando “gcloud projects create”:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID mediante la configuración del ID del proyecto que deseas crear.

Habilita la facturación para el proyecto de Cloud

Si no puedes vincular una cuenta de facturación, no tienes los permisos necesarios para realizar este cambio. Si quieres obtener más información, consulta Permisos necesarios para habilitar la facturación.

Consola de Google Cloud

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

   Ir a Facturación de mis proyectos

2. En Selecciona una organización, elige la organización asociada con tu proyecto de Google Cloud.
3. En la fila del proyecto, abre el menú Acciones (), haz clic en Cambiar facturación y elige la cuenta de Facturación de Cloud.
4. Haz clic en Establecer cuenta.

gcloud CLI

1. Para enumerar las cuentas de facturación disponibles, ejecuta

   gcloud billing accounts list

   .
2. Vincula 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 del proyecto de Cloud para el que deseas 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

Consola de Google Cloud

1. En la consola de Google Cloud, habilita la API de Google Chat, la API de Vertex AI, la API de Cloud Functions, la API de Firestore, la API de Cloud Build, la API de Pub/Sub y la API de Cloud Run Admin.

   Habilita las APIs

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

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

gcloud CLI

1. Si es necesario, configura el proyecto de Cloud actual como el que creaste con el comando gcloud config set project:

   gcloud config set project PROJECT_ID
   

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

2. Habilita la API de Google Chat, la API de Vertex AI, la API de Cloud Functions, la API de Firestore, la API de Cloud Build, la API de Pub/Sub y la API de Cloud Run Admin con el comando gcloud services enable:

   gcloud services enable chat.googleapis.com \
   aiplatform.googleapis.com \
   cloudfunctions.googleapis.com \
   firestore.googleapis.com \
   cloudbuild.googleapis.com \
   pubsub.googleapis.com \
   run.googleapis.com
   

   Las APIs de Cloud Build, Pub/Sub y Cloud Run Admin son requisitos previos de Cloud Functions.

Autenticación y autorización

No se necesita configuración de autenticación y autorización para seguir este instructivo.

Para llamar a las APIs de Firestore y Vertex AI, en este instructivo se usan credenciales predeterminadas de la aplicación con la cuenta de servicio predeterminada conectada a la Cloud Function, que no necesitas configurar. En el contexto de un entorno de producción, por lo general, deberás crear y vincular una cuenta de servicio a la función de Cloud Functions.

Crea e implementa la app de Google Chat

Ahora que se creó y configuró el proyecto de Google Cloud, está todo listo para compilar y, luego, implementar la app de Google Chat. En esta sección, harás lo siguiente:

1. Crear una base de datos de Firestore en la que se conserven y recuperen historias de usuario
2. De manera opcional, revisa el código de muestra.
3. Crea una Cloud Function para alojar y ejecutar el código de la app de Chat en respuesta a los eventos recibidos de Chat como solicitudes HTTP.
4. Crea e implementa una app de Google Chat en la página de configuración de la API de Google Chat.

Crea la base de datos de Firestore

En esta sección, crearás una base de datos de Firestore para conservar y recuperar historias de usuario, pero no definirás el modelo de datos. El modelo de datos se configura de forma implícita en el código de muestra con los archivos model/user-story.js y model/user.js.

La base de datos de la app de Chat de administración de proyectos usa un modelo de datos NoSQL basado en documentos organizados en colecciones . Para obtener más información, consulta el modelo de datos de Firestore.

En el siguiente diagrama, se brinda una descripción general del modelo de datos de la app de Google Chat de administración de proyectos:

La colección raíz es spaces, en la que cada documento representa un espacio en el que la app de Chat creó historias. Cada historia de usuario se representa con un documento de la subcolección userStories y un documento de la subcolección users representa a cada usuario.

Ver definiciones de campos, colecciones y documentos

spaces

Espacios en los que la app de Chat creó historias

Campos
Document ID	String ID único del espacio específico en el que se crean las historias Corresponde al nombre del recurso del espacio en la API de Chat.
userStories	Subcollection of Documents (userStories) Historias creadas por la app de Chat y sus usuarios Corresponde al Document ID de un userStories en Firebase.
users	Subcollection of Documents (user) Usuarios que crearon historias o a quienes se les asignaron las historias
displayName	String El nombre visible del espacio en la API de Chat No está configurado para mensajes directos con los usuarios.

userStories

Historias creadas por la app de Chat y sus usuarios

Campos
Document ID	String ID único de una historia de usuario específica creada por la app de Chat y sus usuarios
assignee	Document (user) El nombre de recurso del usuario asignado para completar la historia. Corresponde al elemento Document ID del documento users y al nombre del recurso de un usuario en la API de Chat.
description	String Es una descripción de la función de software desde el punto de vista del usuario.
priority	Enum La urgencia con la que completar el trabajo. Los valores posibles son Low, Medium o High.
size	Enum La cantidad de trabajo Los valores posibles son Small, Medium o Large.
status	Enum La fase del trabajo Los valores posibles son OPEN, STARTED o COMPLETED.
title	String El título de la historia; un breve resumen

users

Son los usuarios que crearon historias o a quienes se asignaron historias.

Campos
Document ID	String Es el ID único de un usuario específico. Corresponde al assignee de un userStories en Firebase y con el nombre del recurso de un usuario en la API de Chat.
avatarUrl	String URL que aloja la imagen de avatar de Chat del usuario.
displayName	String El nombre visible del usuario en Chat

A continuación, te mostramos cómo crear la base de datos de Firestore:

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Firestore. Haz clic en Menú > Firestore.

   Ir a Firestore

2. Haz clic en Crear base de datos.

3. En Selecciona tu modo de Firestore, haz clic en Modo nativo.

4. Haz clic en Continuar.

5. Configura la base de datos:

   1. En Asigna un nombre a la base de datos, deja el ID de la base de datos como (default).

   2. En Tipo de ubicación, especifica una región para la base de datos, como us-central1. Para obtener el mejor rendimiento, selecciona la misma ubicación o una cercana que la de la Cloud Function de la app de Chat.

6. Haz clic en Crear base de datos.

gcloud CLI

• Crea una base de datos de Firestore en modo nativo con el comando gcloud firestore databases create:

  gcloud firestore databases create \
  --location=LOCATION \
  --type=firestore-native
  

  Reemplaza LOCATION por el nombre de una región de Firestore, como us-central1.

Revisa el código de muestra

De manera opcional, antes de crear la Cloud Function, tómate un momento para revisar el código de muestra alojado en GitHub y familiarizarte con él.

Ver en GitHub

A continuación, se incluye una descripción general de cada archivo:

env.js

Variables de configuración del entorno para implementar la app de Chat en un proyecto y una región de Google Cloud especificados. Debes actualizar las variables de configuración de este archivo.

package.json y package-lock.json

Configuración y dependencias del proyecto de Node.js.

index.js

Punto de entrada de la Cloud Function de la app de Chat. Lee el evento de Chat de la solicitud HTTP, llama al controlador de la app y publica la respuesta HTTP como un objeto JSON.

controllers/app.js

La lógica principal de la aplicación. Procesa los eventos de interacción mediante el control de las menciones de la app de Chat y los comandos de barra. Para responder a los clics en tarjetas, llama a app-action-handler.js.

controllers/app-action-handler.js

Lógica de la aplicación para controlar los eventos de interacción de chat en tarjetas de clic.

services/space-service.js, services/user-service.js y services/user-story-service.js

Estos archivos contienen las partes de la lógica de la aplicación específicas para trabajar con espacios de Chat, historias de usuario y usuarios. app.js o app-action-handler.js llaman a las funciones de estos archivos. Para realizar operaciones de la base de datos, las funciones en estos archivos llaman a funciones en firestore-service.js.

services/firestore-service.js

Controla las operaciones de la base de datos. services/space-service.js, services/user-service.js y services/user-story-service.js llaman a las funciones de este archivo.

services/aip-service.js

Llama a la API de Vertex AI para la predicción de texto de IA generativa.

model/*.js

Estos archivos contienen la definición de clases y enumeraciones que los servicios de la aplicación usan para almacenar y pasar datos entre funciones. Se configura el modelo de datos para la base de datos de Firestore.

views/*.js

Cada archivo de este directorio crea una instancia de un objeto de tarjeta que la app de Chat luego envía de vuelta a Chat como un mensaje de tarjeta o una respuesta de acción de diálogo.

views/widgets/*.js

Cada archivo crea una instancia de un tipo de objeto widget que la app usa para compilar las tarjetas en el directorio views/.

test/**/*.test.js

Cada archivo de este directorio y sus subdirectorios contienen las pruebas de unidades para la función, el controlador, el servicio, la vista o el widget correspondientes. Puedes ejecutar todas las pruebas de unidades mediante la ejecución de npm run test mientras te encuentras en el directorio raíz del proyecto.

Crea e implementa la Cloud Function

En esta sección, crearás e implementarás una Cloud Function que comprende la lógica de la aplicación de Chat de administración de proyectos.

La función de Cloud Functions se ejecuta en respuesta a una solicitud HTTP de Chat que contiene un evento de interacción de Chat. Cuando se ejecuta, el código de Cloud Functions procesa el evento y muestra una respuesta a Chat que Chat procesa como un mensaje, un diálogo o algún otro tipo de interacción del usuario. Si corresponde, la Cloud Function también lee o escribe en la base de datos de Firestore.

A continuación, te mostramos cómo crear la Cloud Function:

Consola de Google Cloud

1. Descarga el código de GitHub como un archivo ZIP.

   Descargar el archivo ZIP

2. Extraiga el archivo ZIP que se descargó.

   La carpeta extraída contiene todo el repositorio de muestras de Google Workspace.

3. En la carpeta extraída, navega a google-chat-samples-main/node/project-management-app/ y, luego, comprime la carpeta project-management-app en un archivo ZIP.

   El directorio raíz del archivo ZIP debe contener los siguientes archivos y carpetas:

   • env.js
   • README.md
   • gcloudignore.text
   • package-lock.json
   • package.json
   • index.js
   • model/
   • controllers/
   • views/
   • services/

4. En la consola de Google Cloud, ve a la página Cloud Functions:

   Ir a Cloud Functions

   Asegúrate de que el proyecto de Google Cloud para tu app de Chat esté seleccionado.

5. Haz clic en Crear función.

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

   1. En Entorno, selecciona 2a gen..
   2. En Nombre de la función, ingresa project-management-tutorial.
   3. En Región, selecciona una región.
   4. En Autenticación, selecciona Permitir invocaciones no autenticadas.
   5. Haz clic en Siguiente.

7. En Entorno de ejecución, selecciona Node.js 20.

8. En Punto de entrada, borra el texto predeterminado y, luego, ingresa projectManagementChatApp.

9. En Código fuente, selecciona Carga de archivos ZIP.

10. En Bucket de destino, crea o selecciona un bucket:

    1. Haz clic en Explorar.
    2. Elige un bucket.
    3. Haz clic en Seleccionar.

    Google Cloud sube el archivo ZIP y extrae los archivos componentes en este bucket. Luego, Cloud Functions copia los archivos de componentes en Cloud Function.

11. En Archivo ZIP, sube el archivo ZIP que descargaste de GitHub, que extrajiste y volviste a comprimir:

    1. Haz clic en Explorar.
    2. Navega hasta el archivo ZIP y selecciónalo.
    3. Haz clic en Abrir.

12. Haz clic en Implementar.

    Se abrirá la página Detalles de Cloud Functions, y tu función aparecerá con dos indicadores de progreso: uno para la compilación y otro para el servicio. Cuando ambos indicadores de progreso desaparecen y se reemplazan por una marca de verificación, la función está implementada y lista.

13. Edita el código de muestra para establecer constantes:

    1. En la página Detalles de Cloud Function, haz clic en Editar.
    2. Haz clic en Siguiente.
    3. En Código fuente, selecciona Editor directo.
    4. En el editor directo, abre el archivo env.js.
    5. Reemplaza project-id por tu ID del proyecto de Cloud.
    6. Opcional: Actualiza us-central1 con una ubicación compatible para tu Cloud Function.

14. Haz clic en Implementar.

15. Cuando la función termine de implementarse, copia la URL del activador:

    1. En la página Detalles de la función, haz clic en Activador.
    2. Copia la URL. La necesitarás para configurar la app de Chat en la siguiente sección.

gcloud CLI

1. Clona el código desde GitHub:

   git clone https://github.com/googleworkspace/google-chat-samples.git
   

2. Cambia al directorio que contiene el código de esta app de Chat de administración de proyectos:

   cd google-chat-samples/node/project-management-app
   

3. Edita el archivo env.js para establecer variables de entorno:

   1. Reemplaza project-id por el ID del proyecto de Google Cloud.
   2. Reemplaza us-central1 por la ubicación de tu proyecto de Google Cloud.

4. Implementa la Cloud Function en Google Cloud:

   gcloud functions deploy project-management-tutorial \
   --gen2 \
   --region=REGION \
   --runtime=nodejs20 \
   --source=. \
   --entry-point=projectManagementChatApp \
   --trigger-http \
   --allow-unauthenticated
   

   Reemplaza REGION por una ubicación de Cloud Function en la que se aloje su infraestructura, como us-central1.

1. Cuando la función termine de implementarse, copia la propiedad url de la respuesta. Esta es la URL del activador que usarás en la siguiente sección para configurar la app de Google Chat.

Configura la app de Google Chat en la consola de Google Cloud

En esta sección, se muestra cómo configurar la API de Chat en la consola de Google Cloud con información sobre tu app de Chat, incluido el nombre de la app de Chat, los comandos de barra compatibles y la URL del activador de la Cloud Function de la app de Chat a la que envía los eventos de interacción de Chat.

1. En la consola de Google Cloud, haz clic en Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat > Administrar > Configuración.

   Ir a la configuración de la API de Chat

2. En Nombre de la app, escribe Project Manager.

3. En URL del avatar, escribe https://developers.google.com/chat/images/quickstart-app-avatar.png.

4. En Descripción, escribe Manages projects with user stories..

5. Haz clic en el botón Enable Interactive features para que se active.

6. En Funcionalidad, selecciona Recibir mensajes 1:1 y Unirse a espacios y conversaciones grupales.

7. En Configuración de la conexión, selecciona URL de la app.

8. En URL de la app, pega la URL del activador que copiaste de la implementación de Cloud Functions con el formato https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Si implementaste la Cloud Function con la CLI de gcloud, esta es la propiedad url.

9. Registra los comandos de barra de la app de Chat. Para registrar un comando de barra, sigue estos pasos:

   1. En Comandos de barra, haz clic en Agregar un comando de barra.

   2. Para cada comando de barra que se detalla en la siguiente tabla, ingresa el Nombre, el ID de comando y la Descripción, y selecciona si el comando de barra Abre un diálogo y, luego, haz clic en Listo:

      Nombre	ID del comando	Descripción	Abrir un diálogo
      /createUserStory	1	Crea una historia con el título especificado.	No seleccionados
      /myUserStories	2	Muestra una lista de todas las historias asignadas al usuario.	No seleccionados
      /userStory	3	Muestra el estado actual de la historia especificada.	No seleccionados
      /manageUserStories	4	Abre un diálogo donde se pueden editar las historias.	Seleccionados
      /cleanupUserStories	5	Se borran todas las noticias del espacio.	No seleccionados

10. En Visibilidad, selecciona Hacer que esta app de Chat esté disponible para personas y grupos específicos de tu dominio de Workspace y, luego, ingresa tu dirección de correo electrónico.

11. De forma opcional, en Registros, selecciona Registrar errores en Logging.

12. Haz clic en Guardar. Aparecerá un mensaje de configuración guardada, lo que significa que la app de Chat está lista para probarla.

Prueba la app de Chat

Prueba la app de Chat de administración de proyectos. Para ello, envíale mensajes y usa sus comandos de barra para crear, editar y borrar historias de usuarios.

1. Abre Google Chat con la cuenta de Google Workspace que proporcionaste al agregarte como verificador de confianza.

   Ir a Google Chat

2. Haz clic en Nuevo chat.
3. En el campo Add 1 or more people (Agrega 1 o más personas), escribe el nombre de tu app de Chat.

4. Selecciona tu app de Chat en los resultados. Se abrirá un mensaje directo.

   Nota: Si no ves tu app de Chat en la lista de resultados, asegúrate de haber incluido tu cuenta de Google Workspace en la configuración de Visibilidad de la página Configuración de la API de Chat en la consola de Google Cloud.
5. En el nuevo mensaje directo con la app, escribe Hello y presiona enter. La app de Chat de administración de proyectos responde con un menú de ayuda que detalla lo que puede hacer.
6. Para crear una historia, escribe /createUserStory Test story en la barra de mensajes y envíala. La app de Chat de administración de proyectos responde con un mensaje de tarjeta que detalla la historia de usuario que crea para ti con la IA generativa de Vertex AI.

7. En la consola, verifica la base de datos de Firestore para revisar los registros que creó sobre el espacio al que agregaste la app de Chat, los usuarios que interactuaron con ella y la historia de usuario que creaste.

   Ir a Firestore

8. Vuelve a Google Chat.

   Ir a Google Chat

9. De manera opcional, si quieres editarla, haz clic en Editar. Cuando estés conforme con la historia, haz clic en Guardar.
10. Prueba cada comando de barra compatible con la app. Para verlos, escribe / o menciona la app de Chat.
11. Borra la historia de usuario de prueba mediante el comando de barra /cleanupUserStories. Como alternativa, quita o desinstala la app. Cuando se quita, la app borra todas las historias de usuario creadas en ese espacio.

Solucionar problemas

Cuando una app de Google Chat o una tarjeta devuelve un error, la interfaz de Chat muestra un mensaje que dice “Se produjo un error” o “No se pudo procesar tu solicitud”. A veces, la IU de Chat no muestra ningún mensaje de error, pero la app o la tarjeta de Chat producen un resultado inesperado; por ejemplo, es posible que no aparezca un mensaje de tarjeta.

Si bien es posible que no se muestre un mensaje de error en la IU de Chat, hay mensajes de error descriptivos y datos de registro disponibles que te ayudarán a corregir errores cuando se activa el registro de errores para las apps de Chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar problemas de Google Chat.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en este instructivo, te recomendamos que borres el proyecto de Cloud.

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• 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 URLs que usan el ID del proyecto, como una URL en appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varios instructivos y guías de inicio rápido, la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

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

   Ir a Resource Manager

2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.

Temas relacionados

• Responde preguntas basadas en conversaciones de chat con una app de chat con IA de Gemini
• Responde a incidentes con Google Chat, Vertex AI y Apps Script