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 usuario (que representan las funciones de un sistema de software desde el punto de vista de un usuario para que el equipo las desarrolle) y conserva las historias en una base de datos de Firestore.

• 

  Figura 1: Carlos conversa sobre el desarrollo de funciones en un espacio de Chat con su equipo. Mencionar que la app de Chat de administración de proyectos le permite ofrecer ayuda.

• 
  Figura 2: Con el comando slash /createUserStory, Charlie 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, compartirla en el espacio.
• 
  Figura 4: Charlie hace clic en Editar para finalizar los detalles de la historia. La descripción de IA es precisa, pero Charlie desea más detalles, así que hace clic en Expandir para que Vertex AI agregue requisitos a la descripción de la historia. Charlie se asigna la historia, establece el estado como iniciado, selecciona una prioridad y un 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 para empresas o empresas con acceso a Google Chat

• Acceso a los servicios de Google Cloud para realizar las siguientes acciones:

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

  • Usa invocaciones de Google Cloud Function no autenticadas, que puedes verificar determinando si tu organización de Google Cloud usa el 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 potenciadas por Vertex AI:
  • Genera y vuelve a generar descripciones de historias.
  • Expande las descripciones de las historias a partir de 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 que los usuarios creen, editen, asignen o inicien 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: Una API para desarrollar apps de Google Chat que reciben y responden eventos de interacción de Chat, como mensajes. La app de Google Chat para la administración de proyectos usa la API de Chat para recibir y responder a los eventos de interacción que envía Chat, y para configurar atributos que determinan cómo aparece en Chat, como el nombre y la imagen del avatar.
• API de Vertex AI: Una plataforma de IA generativa. La app de Google Chat para la administración de proyectos usa la API de Vertex AI para escribir títulos y descripciones de historias de usuario.
• Firestore: Una base de datos de documentos sin servidores. La app de administración de proyectos de Google Chat usa Firebase para almacenar datos sobre historias de usuarios.

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

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

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

Arquitectura

La arquitectura de la app de administración de proyectos de la app de Google Chat recibe y procesa eventos de interacción de Chat en un extremo HTTP, usa Vertex AI para escribir historias de usuarios 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 que se usan.

La app de administración de proyectos de Google Chat funciona de la siguiente manera:

1. Un usuario envía un mensaje en Chat y, luego, invoca la app de Google Chat de administración de proyectos. Para ello, le envía un mensaje directamente, la menciona en un espacio o ingresa un comando de barra.

2. Chat envía una solicitud HTTP síncrona al extremo HTTP de la Cloud Function.

3. La app de Google Chat de administración de proyectos 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 usuario.

4. Cloud Functions muestra una respuesta HTTP a Chat, que 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 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, haz clic en Explorar para mostrar las posibles ubicaciones de tu 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 descritas en la documentación para desarrolladores de Google Workspace solo están disponibles para los proyectos asociados con una organización.
4. Haz clic en Crear. La consola de Google Cloud navega a la página Panel y se crea tu proyecto 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 gcloud CLI ya configurada, activa Cloud Shell.
  Activar Cloud Shell
• Shell local: Para usar un entorno de desarrollo local, instala e inicializa 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, significa que no tienes los permisos necesarios para realizar este cambio. Si deseas 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 para 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 obtener una lista de las cuentas de facturación disponibles, ejecuta el siguiente comando:

   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 en el que deseas habilitar la facturación.
   • BILLING_ACCOUNT_ID es el ID de la cuenta de facturación que se vinculará al proyecto de Google Cloud.

Habilitación de las API

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.

   Habilitar las API

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 al que creaste con el comando gcloud config set project:

   gcloud config set project PROJECT_ID

   Reemplaza PROJECT_ID por el ID del proyecto 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 es necesario configurar la autenticación y la 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 es necesario configurar. En el contexto de un entorno de producción, por lo general, crearías y adjuntarías 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ó tu 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. Crea una base de datos de Firestore en la que persistir y recuperar historias de usuario.
2. De forma opcional, puedes revisar 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 usuarios, pero no definirás el modelo de datos. Los archivos model/user-story.js y model/user.js configuran el modelo de datos de forma implícita en el código de muestra.

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 Modelo de datos de Firestore.

El siguiente diagrama es una descripción general del modelo de datos de la app de Google Chat para la 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 está representada por un documento de la subcolección userStories, mientras que cada usuario está representado por un documento de la subcolección users.

Visualiza definiciones de colecciones, documentos y campos

spaces

Espacios en los que la app de Chat creó historias

Campos
Document ID	String ID único de un 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 con el Document ID de un userStories en Firebase.
users	Subcollection of Documents (user) Usuarios que crearon historias o a los que se les asignaron historias.
displayName	String Es el nombre visible del espacio en la API de Chat. No se configuró para los 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 del recurso del usuario asignado para completar la historia. Corresponde con el Document ID del documento users y con el nombre de recurso de un usuario en la API de Chat.
description	String Una descripción de la función de software desde el punto de vista del usuario.
priority	Enum La urgencia con la que se debe 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 Es el título de la historia, un breve resumen.

users

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

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

Sigue estos pasos para 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 tu base de datos, deja el ID de la base de datos como (default).

   2. En Tipo de ubicación, especifica una región para tu base de datos, como us-central1. Para obtener el mejor rendimiento, selecciona la misma ubicación o una cercana a la función de Cloud Functions 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 función de Cloud Functions, tómate un momento para revisar y familiarizarte con el código de muestra alojado en GitHub.

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 en este archivo.

package.json y package-lock.json

Parámetros de 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 la administración de las menciones de la app de Chat y los comandos de barra. Para responder a los clics de la tarjeta, llama a app-action-handler.js.

controllers/app-action-handler.js

Lógica de la aplicación para controlar los clics de tarjeta de Eventos de interacción de chat.

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, usuarios y casos de usuario. app.js o app-action-handler.js llaman a las funciones de estos archivos. Para realizar operaciones de base de datos, las funciones de 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 enums que los servicios de la aplicación usan para almacenar y pasar datos entre funciones. Establecen 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 vuelve a enviar 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 contiene las pruebas de unidades para la función, el controlador, el servicio, la vista o el widget correspondiente. Para ejecutar todas las pruebas de unidades, ejecuta npm run test mientras estás 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 comprenda la lógica de la aplicación de la app de Chat de administración de proyectos.

La Cloud Function 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 Function procesa el evento y muestra una respuesta a Chat, que se renderiza como un mensaje, un diálogo o algún otro tipo de interacción del usuario. Si corresponde, la Cloud Function también lee la base de datos de Firestore o escribe en ella.

Sigue estos pasos para 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 Función de Cloud Run.
   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 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 a este bucket y extrae los archivos componentes. Luego, Cloud Functions copia los archivos de componentes en la función de Cloud Functions.

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

    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 desaparezcan y se reemplacen por una marca de verificación, la función se habrá implementado y estará lista.

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

    1. En la página Detalles de la función de Cloud, haz clic en Editar.
    2. Haz clic en Siguiente.
    3. En Código fuente, selecciona Editor directo.
    4. En el editor intercalado, 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 las 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 Console de Google Cloud con información sobre tu app de Chat, incluido el nombre de la app, los comandos de barra compatibles y la URL del activador de la función de Cloud de la app de Chat a la que envía 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.

   Ve 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 de activación Enable Interactive features.

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 del extremo HTTP.

8. En URL de extremo HTTP, 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 función de Cloud 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, haz lo siguiente:

   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. Luego, haz clic en Listo:

      Nombre	ID de comando	Descripción	Abrir un diálogo
      /createUserStory	1	Crea una historia con el título especificado.	Selección anulada
      /myUserStories	2	Muestra todas las historias asignadas al usuario.	Selección anulada
      /userStory	3	Muestra el estado actual de la historia especificada.	Selección anulada
      /manageUserStories	4	Abre un diálogo en el que se pueden editar las historias.	Seleccionado
      /cleanupUserStories	5	Borra todas las historias del espacio.	Selección anulada

10. 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.

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

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

Prueba la app de Chat

Envía un mensaje a la app de Chat de administración de proyectos y usa sus comandos de barra para crear, editar y borrar historias de usuario.

1. Abre Google Chat con la cuenta de Google Workspace que proporcionaste cuando te agregaste como verificador de confianza.

   Ir a Google Chat

2. Haz clic en Nuevo chat.
3. En el campo Agregar 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, revisa la base de datos de Firestore para ver 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.

   Ve a Google Chat

9. De manera opcional, para editar la historia, 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. Para borrar la historia de usuario de prueba, emite el comando barra /cleanupUserStories. Como alternativa, puedes quitar o desinstalar la app. Cuando se quita, la app borra todas las historias de usuario creadas en ese espacio.

Solucionar problemas

Cuando una app o una tarjeta de Google Chat muestran un error, la interfaz de Chat muestra el mensaje “Se produjo un error”. o "No se puede 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 la tarjeta.

Aunque es posible que no se muestre un mensaje de error en la IU de Chat, los mensajes de error descriptivos y los datos de registro están disponibles para ayudarte a corregir errores cuando se activa el registro de errores de las apps de Chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar problemas y corregir errores 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 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 de IA de Gemini
• Responde a incidentes con Google Chat, Vertex AI y Apps Script