Gerenciar projetos com o Google Chat, a Vertex AI e o Firestore

Neste tutorial, mostramos como criar um app do Google Chat que uma equipe pode usar para gerenciar projetos em tempo real. O app Chat usa a Vertex AI para ajudar as equipes a escrever histórias de usuários (que representam recursos de um sistema de software do ponto de vista de um usuário para que a equipe desenvolva) e manter as histórias em um banco de dados do Firestore.

• 

  Figura 1. Carlos conversa com a equipe sobre o desenvolvimento de recursos em um espaço do Chat. Mencionar o app do Chat de gerenciamento de projetos solicita que o app ofereça ajuda.

• 
  Figura 2. Usando o comando de barra /createUserStory, Carlos cria uma história.
• 
  Figura 3. O app Chat de gerenciamento de projetos usa a Vertex AI para escrever a descrição da história e depois a compartilha no espaço.
• 
  Figura 4. Carlos clica em Editar para finalizar os detalhes da história. A descrição da IA é precisa, mas Carlos quer mais detalhes, então Carlos clica em Expandir para que a Vertex AI adicione requisitos à descrição da história. Carlos atribui a história a si mesmo, define o status como iniciada, seleciona uma prioridade e um tamanho adequados e clica em Salvar.
• 
  Figura 5. A qualquer momento, Carlos pode ver e gerenciar todas as histórias de usuário da equipe com o comando de barra /manageUserStories.

Pré-requisitos

• Uma conta do Google Workspace com acesso ao Google Chat.

• Acesso aos serviços do Google Cloud para fazer o seguinte:

  • Criar um projeto do Google Cloud.
  • Vincular uma conta de faturamento do Google Cloud ao projeto do Cloud. Para saber se você tem acesso, consulte Permissões necessárias para ativar o faturamento.

  • Usar invocações não autenticadas da função do Google Cloud, que podem ser verificadas determinando se sua organização do Google Cloud usa o compartilhamento restrito de domínio.

  Se necessário, solicite acesso ou permissão ao administrador do Google Cloud.

• Se estiver usando a Google Cloud CLI, um ambiente de desenvolvimento em Node.js configurado para funcionar com a CLI gcloud. Consulte Como configurar um ambiente de desenvolvimento em Node.js.

Objetivos

• Crie um app de chat que gerencie projetos de software ágeis.
• Ajude os usuários a escrever histórias de usuários com ferramentas de escrita de histórias assistidas por IA generativa com a tecnologia da Vertex AI:
  • Gerar e regenerar descrições de histórias.
  • Expanda as descrições da história em notas para atender aos requisitos.
  • Corrija a gramática para corrigir erros de digitação.
• Mantenha o trabalho atualizado gravando e lendo em um banco de dados do Firestore.
• Facilite a colaboração em um espaço do Chat permitindo que os usuários criem, editem, atribuam e iniciem histórias diretamente na conversa.

Produtos usados

O app de gerenciamento de projetos usa os seguintes produtos do Google Workspace e do Google Cloud:

• API Chat: uma API para desenvolver apps do Google Chat que recebem e respondem a eventos de interação do Chat, como mensagens. O app Google Chat de gerenciamento de projetos usa a API Chat para receber e responder a eventos de interação enviados e configurar atributos que determinam como ele aparece no Chat, como nome e imagem do avatar.
• API Vertex AI: uma plataforma de IA generativa. O app de gerenciamento de projetos do Google Chat usa a API Vertex AI para escrever títulos e descrições de histórias de usuários.
• Firestore: um banco de dados de documentos sem servidor. O app de gerenciamento de projetos do Google Chat usa o Firebase para armazenar dados sobre histórias de usuários.

• Cloud Functions: um serviço de computação leve e sem servidor que permite criar funções independentes de finalidade única que podem responder a eventos de interação do Chat sem a necessidade de gerenciar um servidor ou um ambiente de execução. O app de gerenciamento de projetos do Google Chat usa o Cloud Functions para hospedar o endpoint HTTP ao qual o Chat envia eventos de interação e como uma plataforma de computação para executar a lógica que processa e responde a esses eventos.

  O Cloud Functions usa os seguintes produtos do Google Cloud para criar, processar eventos de interação e hospedar recursos de computação:

  • Cloud Build: uma plataforma de integração, entrega e implantação contínuas totalmente gerenciada que executa builds automatizados.
  • Pub/Sub: um serviço de mensagens assíncrono e escalonável que separa os serviços que produzem mensagens dos que as processam.
  • API Cloud Run Admin: um ambiente totalmente gerenciado para executar aplicativos conteinerizados.

Arquitetura

A arquitetura do app Google Chat de gerenciamento de projetos recebe e processa eventos de interação do Chat em um endpoint HTTP, usa a Vertex AI para ajudar a escrever histórias de usuários e armazena os detalhes da história em um banco de dados do Firestore. O diagrama a seguir mostra a arquitetura dos recursos do Google Workspace e do Google Cloud usados.

O app Google Chat de gerenciamento de projetos funciona da seguinte forma:

1. Um usuário envia uma mensagem no Chat e invoca o app de gerenciamento de projetos do Google Chat enviando uma mensagem diretamente, mencionando-o em um espaço ou inserindo um comando de barra.

2. O Chat envia uma solicitação HTTP síncrona para o endpoint HTTP da função do Cloud.

3. O app Google Chat de gerenciamento de projetos processa a solicitação HTTP:

   1. A Vertex AI ajuda a escrever ou atualizar uma história de usuário.

   2. Um banco de dados do Firestore armazena, recupera, atualiza ou exclui dados da história do usuário.

4. O Cloud Functions retorna uma resposta HTTP para o Chat que a exibe ao usuário como uma mensagem ou uma caixa de diálogo.

prepare o ambiente

Nesta seção, mostramos como criar e configurar um projeto do Google Cloud para o app do Chat.

Criar um projeto do Google Cloud

Console do Google Cloud

1. No console do Google Cloud, acesse Menu > IAM e administrador > Criar um projeto.

   Acessar "Criar um projeto"

2. No campo Nome do projeto, digite um nome descritivo para o projeto.

   Opcional: para mudar o ID do projeto, clique em Editar. O ID do projeto não pode ser alterado após a criação dele. Portanto, escolha um ID que atenda às suas necessidades durante a vida útil do projeto.

3. No campo Local, clique em Procurar para exibir possíveis locais para seu projeto. Em seguida, clique em Selecionar.
   Atenção: não consegue encontrar sua organização do Google Workspace?
   Isso significa que você não fez login em uma conta do Google Workspace. Alguns dos recursos descritos na documentação do desenvolvedor do Google Workspace estão disponíveis apenas para projetos associados a uma organização.
4. Clique em Criar. O console do Google Cloud navega até a página "Painel", e seu projeto é criado em alguns minutos.

CLI da gcloud

Em um dos seguintes ambientes de desenvolvimento, acesse a CLI do Google Cloud ("gcloud"):

• Cloud Shell: para usar um terminal on-line com a CLI gcloud já configurada, ative o Cloud Shell.
  Ative o Cloud Shell
• Shell local: para usar um ambiente de desenvolvimento local, instale e initialize a CLI gcloud.
  Para criar um projeto do Cloud, use o comando "gcloud projects create":

  gcloud projects create PROJECT_ID

  Substitua PROJECT_ID definindo o ID do projeto que você quer criar.

Ativar o faturamento para o projeto do Cloud

Se não for possível vincular uma conta de faturamento, você não tem as permissões necessárias para fazer essa alteração. Para mais informações, consulte Permissões necessárias para ativar o faturamento.

Console do Google Cloud

1. No console do Google Cloud, acesse Faturamento. Clique em Menu > Faturamento > Meus projetos.

   Acessar "Faturamento" dos meus projetos

2. Em Selecionar uma organização, escolha a organização associada ao seu projeto do Google Cloud.
3. Na linha do projeto, abra o menu Ações (), clique em Alterar faturamento e escolha a conta do Cloud Billing.
4. Clique em Definir conta.

CLI da gcloud

1. Para listar as contas de faturamento disponíveis, execute:

   gcloud billing accounts list

2. Vincule uma conta de faturamento a um projeto do Google Cloud:

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

   Substitua:

   • PROJECT_ID é o ID do projeto do Cloud em que você quer ativar o faturamento.
   • BILLING_ACCOUNT_ID é o ID da conta de faturamento que será vinculada ao projeto do Google Cloud.

Ativar as APIs

Console do Google Cloud

1. No Console do Google Cloud, ative a API Google Chat, a API Vertex AI, a API Cloud Functions, a API Firestore, a API Cloud Build, a API Pub/Sub e a API Cloud Run Admin.

   Ativar as APIs

2. Confirme se você está ativando as APIs no projeto correto do Cloud e clique em Próxima.

3. Confirme se você ativou as APIs corretas e clique em Ativar.

CLI da gcloud

1. Se necessário, defina o projeto atual do Cloud para aquele que você criou com o comando gcloud config set project:

   gcloud config set project PROJECT_ID
   

   Substitua PROJECT_ID pelo ID do projeto do projeto do Cloud que você criou.

2. Use o comando gcloud services enable para ativar as APIs Google Chat, Vertex AI, Cloud Functions, Firestore, Cloud Build, Pub/Sub e Cloud Run Admin:

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

   As APIs Cloud Build, Pub/Sub e Cloud Run Admin são pré-requisitos do Cloud Functions.

Autenticação e autorização

Nenhuma configuração de autenticação e autorização é necessária para seguir este tutorial.

Para chamar as APIs Firestore e Vertex AI, este tutorial usa o Application Default Credentials com a conta de serviço padrão anexada à função do Cloud, que você não precisa configurar. No contexto de um ambiente de produção, você normalmente criaria e anexaria uma conta de serviço à função do Cloud.

Criar e implantar o app Google Chat

Agora que seu projeto do Google Cloud foi criado e configurado, você está pronto para criar e implantar o app do Google Chat. Nesta seção, você fará o seguinte:

1. Crie um banco de dados do Firestore para armazenar e recuperar histórias de usuários.
2. Se quiser, revise o exemplo de código.
3. Criar uma função do Cloud para hospedar e executar o código do app do Chat em resposta a eventos recebidos do Chat como solicitações HTTP.
4. Criar e implantar um app do Google Chat na página de configuração da API Google Chat.

Crie o banco de dados do Firestore

Nesta seção, você criará um banco de dados do Firestore para manter e recuperar histórias de usuários, mas não definirá o modelo de dados. O modelo de dados é definido implicitamente no código de amostra pelos arquivos model/user-story.js e model/user.js.

O banco de dados do app Chat de gerenciamento de projetos usa um modelo de dados NoSQL com base em documentos organizados em coleções . Para saber mais, consulte Modelo de dados do Firestore.

O diagrama a seguir é uma visão geral do modelo de dados do app Google Chat de gerenciamento de projetos:

A coleção raiz é spaces, em que cada documento representa um espaço em que o app do Chat criou histórias. Cada história de usuário é representada por um documento na subcoleção userStories, e cada usuário é representado por um documento na subcoleção users.

Ver definições de coleção, documento e campo

spaces

Espaços em que o app do Chat criou histórias.

Campos
Document ID	String ID exclusivo de um espaço específico onde as histórias são criadas. Corresponde ao nome do recurso do espaço na API Chat.
userStories	Subcollection of Documents (userStories) Histórias criadas pelo app do Chat e pelos usuários dele. Corresponde ao Document ID de uma userStories no Firebase.
users	Subcollection of Documents (user) Usuários que criaram histórias ou que foram atribuídas a eles.
displayName	String O nome de exibição do espaço na API Chat. Não definido para mensagens diretas com usuários.

userStories

Histórias criadas pelo app do Chat e pelos usuários dele.

Campos
Document ID	String ID exclusivo de uma história de usuário específica criada pelo app Chat e pelos usuários dele.
assignee	Document (user) O nome do recurso do usuário designado para concluir a história. Corresponde ao Document ID do documento users e ao nome do recurso de um usuário na API Chat.
description	String Uma descrição do recurso do software do ponto de vista do usuário.
priority	Enum A urgência com que o trabalho deve ser concluído. Os valores possíveis são Low, Medium ou High.
size	Enum A quantidade de trabalho. Os valores possíveis são Small, Medium ou Large.
status	Enum A fase do trabalho. Os valores possíveis são OPEN, STARTED ou COMPLETED.
title	String O título da história: um breve resumo.

users

Usuários que criaram ou receberam histórias.

Campos
Document ID	String ID exclusivo de um usuário específico. Corresponde ao assignee de um userStories no Firebase e ao nome do recurso de um usuário na API Chat.
avatarUrl	String URL que hospeda a imagem de avatar do Chat do usuário.
displayName	String O nome de exibição do Chat do usuário.

Veja como criar o banco de dados do Firestore:

Console do Google Cloud

1. No Console do Google Cloud, acesse o Firestore. Clique em Menu > Firestore.

   Acessar o Firestore

2. Clique em Criar banco de dados.

3. Em Selecionar o modo Firestore, clique em Modo nativo.

4. Clique em Continuar.

5. Configure o banco de dados:

   1. Em Nomear seu banco de dados, deixe o ID do banco de dados como (default).

   2. Em Tipo de local, especifique uma região para seu banco de dados, como us-central1. Para ter o melhor desempenho, selecione o mesmo local ou um local próximo da função do Cloud do app do Chat.

6. Clique em Criar banco de dados.

CLI da gcloud

• Crie um banco de dados do Firestore no modo nativo com o comando gcloud firestore databases create:

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

  Substitua LOCATION pelo nome de uma região do Firestore, como us-central1.

Analisar o exemplo de código

Opcionalmente, antes de criar a função do Cloud, reserve um momento para analisar e se familiarizar com o exemplo de código hospedado no GitHub.

Ver no GitHub

Aqui está uma visão geral de cada arquivo:

env.js

Variáveis de configuração de ambiente para implantar o app do Chat em um projeto e uma região especificados do Google Cloud. Você precisa atualizar as variáveis de configuração nesse arquivo.

package.json e package-lock.json

Configurações e dependências do projeto Node.js.

index.js

Ponto de entrada para a função do Cloud do app do Chat. Ele lê o evento do Chat da solicitação HTTP, chama o gerenciador do app e publica a resposta HTTP como um objeto JSON.

controllers/app.js

A lógica principal do aplicativo. processa os eventos de interação processando os comandos de barra e menções do app do Chat. Para responder aos cliques no card, ele chama app-action-handler.js.

controllers/app-action-handler.js

Lógica do aplicativo para processar o clique no card Eventos de interação do chat.

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

Esses arquivos contêm as partes da lógica do aplicativo específicas para trabalhar com espaços, usuários e histórias de usuários do Chat. As funções nesses arquivos são chamadas por app.js ou app-action-handler.js. Para executar operações de banco de dados, as funções nesses arquivos chamam funções em firestore-service.js.

services/firestore-service.js

Processa as operações do banco de dados. As funções nesse arquivo são chamadas por services/space-service.js, services/user-service.js e services/user-story-service.js.

services/aip-service.js

Chama a API Vertex AI para previsão de texto de IA generativa.

model/*.js

Esses arquivos contêm a definição de classes e tipos enumerados que os serviços de aplicativo usam para armazenar e transmitir dados entre funções. Eles definem o modelo de dados do banco de dados do Firestore.

views/*.js

Cada arquivo nesse diretório instancia um objeto de card que o app do Chat envia de volta ao Chat como uma mensagem de card ou uma resposta de ação de caixa de diálogo.

views/widgets/*.js

Cada arquivo instancia um tipo de objeto widget que o app usa para criar os cards no diretório views/.

test/**/*.test.js

Cada arquivo nesse diretório e nos subdiretórios dele contém os testes de unidade para a função, controlador, serviço, visualização ou widget correspondente. É possível executar todos os testes de unidade executando npm run test no diretório raiz do projeto.

Criar e implantar a função do Cloud

Nesta seção, você cria e implanta uma função do Cloud que compreende a lógica do aplicativo do Chat de gerenciamento de projetos.

O Cloud Functions é executado em resposta a uma solicitação HTTP do Chat que contém um evento de interação do Chat. Quando executado, o código da função do Cloud processa o evento e retorna uma resposta ao Chat, que é renderizada como uma mensagem, caixa de diálogo ou outro tipo de interação do usuário. Se aplicável, a função do Cloud também lê ou grava no banco de dados do Firestore.

Veja como criar a função do Cloud:

Console do Google Cloud

1. Faça o download do código do GitHub como um arquivo ZIP.

   Fazer o download do arquivo ZIP

2. Extraia o arquivo ZIP salvo.

   A pasta extraída contém todo o repositório de amostras do Google Workspace.

3. Na pasta extraída, navegue até google-chat-samples-main/node/project-management-app/ e compacte a pasta project-management-app em um arquivo ZIP.

   O diretório raiz do arquivo ZIP precisa conter os seguintes arquivos e pastas:

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

4. No console do Google Cloud, acesse a página do Cloud Functions:

   Acesse o Cloud Functions

   Verifique se o projeto do Google Cloud do seu app do Chat está selecionado.

5. Clique em Criar função.

6. Na página Criar função, configure a função:

   1. Em Ambiente, selecione 2a geração.
   2. Em Nome da função, insira project-management-tutorial.
   3. Em Região, selecione uma região.
   4. Em Autenticação, selecione Permitir invocações não autenticadas.
   5. Clique em Próxima.

7. Em Ambiente de execução, selecione Node.js 20.

8. Em Ponto de entrada, exclua o texto padrão e digite projectManagementChatApp.

9. Em Código-fonte, selecione Upload do ZIP.

10. Em Bucket de destino, crie ou selecione um bucket:

    1. Clique em Browse.
    2. Escolha um bucket.
    3. Clique em Selecionar.

    O Google Cloud faz upload do arquivo ZIP e extrai os arquivos de componentes nesse bucket. O Cloud Functions copia os arquivos do componente para ela.

11. Em Arquivo ZIP, faça upload do arquivo ZIP que você baixou do GitHub, extraiu e recompactou:

    1. Clique em Browse.
    2. Navegue até o arquivo ZIP e selecione-o.
    3. Clique em Abrir.

12. Selecione Implantar.

    A página Detalhes do Cloud Functions é aberta e sua função aparece com dois indicadores de progresso: um para a versão e outro para o serviço. Quando os dois indicadores de progresso desaparecem e são substituídos por uma marca de seleção, a função é implantada e fica pronta.

13. Edite o exemplo de código para definir constantes:

    1. Na página Detalhes da função do Cloud, clique em Editar.
    2. Clique em Próxima.
    3. Em Código-fonte, selecione Editor in-line.
    4. No editor in-line, abra o arquivo env.js.
    5. Substitua project-id pelo código do projeto.
    6. Opcional: atualize us-central1 com um local compatível com a função do Cloud.

14. Selecione Implantar.

15. Quando a implantação da função for concluída, copie o URL do gatilho:

    1. Na página Detalhes da função, clique em Acionador.
    2. Copie o URL. Você precisa dele para configurar o app do Chat na próxima seção.

CLI da gcloud

1. Clone o código do GitHub:

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

2. Mude para o diretório que contém o código desse app do Chat de gerenciamento de projetos:

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

3. Edite o arquivo env.js para definir as variáveis de ambiente:

   1. Substitua project-id pelo ID do projeto do Google Cloud.
   2. Substitua us-central1 pelo local do projeto do Google Cloud.

4. Implante a função do Cloud no Google Cloud:

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

   Substitua REGION por um local da Função do Cloud em que a infraestrutura esteja hospedada, como us-central1.

1. Quando a implantação da função for concluída, copie a propriedade url da resposta. Esse é o URL do gatilho que você vai usar na seção a seguir para configurar o app Google Chat.

Configurar o app Google Chat no console do Google Cloud

Nesta seção, mostramos como configurar a API do Chat no console do Google Cloud com informações sobre seu app do Chat, incluindo o nome do app do Chat, comandos de barra aceitos e o URL de gatilho da função do Cloud do app do Chat para a qual ele envia eventos de interação do Chat.

1. No console do Google Cloud, clique em Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat > Gerenciar > Configuração.

   Acessar a configuração da API Chat

2. Em Nome do app, digite Project Manager.

3. No URL do avatar, digite https://developers.google.com/chat/images/quickstart-app-avatar.png.

4. Em Descrição, digite Manages projects with user stories.

5. Clique no botão Ativar recursos interativos para ativar essa opção.

6. Em Funcionalidade, selecione Receber mensagens individuais, Participar de espaços e conversas em grupo.

7. Em Configurações de conexão, selecione URL do aplicativo.

8. Em URL do app, cole o URL do gatilho que você copiou da implantação do Cloud Functions, formatado como https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Se você implantou a função do Cloud com a CLI gcloud, essa é a propriedade url.

9. Registre os comandos de barra do app do Chat. Para registrar um comando de barra:

   1. Em Comandos de barra, clique em Adicionar um comando de barra.

   2. Para cada comando de barra detalhado na tabela a seguir, insira o Nome, o ID do comando, a Descrição e selecione se o comando de barra Abre uma caixa de diálogo e clique em Concluído:

      Nome	ID do comando	Descrição	Abre uma caixa de diálogo
      /createUserStory	1	Criar uma história com o título especificado.	Não selecionado
      /myUserStories	2	Lista todas as histórias atribuídas ao usuário.	Não selecionado
      /userStory	3	Mostra o status atual da história especificada.	Não selecionado
      /manageUserStories	4	Abre uma caixa de diálogo em que as histórias podem ser editadas.	Selecionado
      /cleanupUserStories	5	Exclui todas as histórias no espaço.	Não selecionado

10. Em Visibilidade, selecione Disponibilizar este app do Chat para pessoas e grupos específicos no domínio do Workspace e digite seu endereço de e-mail.

11. Opcionalmente, em Registros, selecione Registrar erros no Logging.

12. Clique em Salvar. Uma mensagem de configuração salva será exibida, indicando que o app do Chat está pronto para ser testado.

Teste o app do Chat

Teste o app Chat de gerenciamento de projetos enviando uma mensagem e usando os comandos de barra para criar, editar e excluir histórias de usuários.

1. Abra o Google Chat usando a conta do Google Workspace que você forneceu quando se adicionou como trusted testers.

   Acessar o Google Chat

2. Clique em Novo chat.
3. No campo Adicionar uma ou mais pessoas, digite o nome do seu app do Chat.

4. Selecione o app do Chat nos resultados. Uma mensagem direta será aberta.

   Observação:se o app do Chat não estiver na lista de resultados, verifique se você incluiu sua conta do Google Workspace nas configurações Visibilidade da página Configuração da API Chat no console do Google Cloud.
5. Na nova mensagem direta com o app, digite Hello e pressione enter. O app Chat de gerenciamento de projetos responde com um menu de ajuda detalhando o que ele pode fazer.
6. Para criar uma história, digite /createUserStory Test story na barra de mensagem e envie-a. O app Chat de gerenciamento de projetos responde com uma mensagem em card detalhando a história do usuário criada para você usando a IA generativa da Vertex AI.

7. No console, verifique o banco de dados do Firestore para revisar os registros criados sobre o espaço a que você adicionou o app do Chat, os usuários que interagiram com ele e a história do usuário que você criou.

   Acessar o Firestore

8. Volte para o Google Chat.

   Acessar o Google Chat

9. Se quiser, clique em Editar para editar a história. Quando estiver contente com a história, clique em Salvar.
10. Teste cada comando de barra compatível com o app. Para conferir, digite / ou mencione o app do Chat.
11. Exclua a história de usuário de teste emitindo o comando de barra /cleanupUserStories. Como alternativa, remova ou desinstale o app. Quando ele for removido, ele vai excluir todas as histórias de usuário criadas nesse espaço.

Resolver problemas

Quando um app ou card do Google Chat retorna um erro, a interface do Chat mostra a mensagem "Ocorreu um erro" ou "Não foi possível processar sua solicitação". Às vezes, a interface do Chat não mostra nenhuma mensagem de erro, mas o app ou card do Chat produz um resultado inesperado. Por exemplo, uma mensagem de card pode não aparecer.

Embora uma mensagem de erro não apareça na interface do Chat, mensagens de erro descritivas e dados de registro estão disponíveis para ajudar a corrigir erros quando o registro de erros dos apps do Chat está ativado. Se precisar de ajuda para visualizar, depurar e corrigir erros, consulte Resolver problemas e corrigir erros do Google Chat.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial, recomendamos que você exclua o projeto do Cloud.

Cuidado:excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto atual para seguir este tutorial, a exclusão dele incluirá quaisquer outras ações feitas no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL em appspot.com, exclua os recursos selecionados dentro do projeto em vez de excluir o projeto inteiro.

Se você planeja conferir vários tutoriais e guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

1. No Console do Google Cloud, acesse a página Gerenciar recursos. Clique em Menu > IAM e administrador > Gerenciar recursos.

   Acessar o Resource Manager

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Temas relacionados

• Responder perguntas com base nas conversas do Chat com um app Gemini AI Chat
• Responda a incidentes com o Google Chat, a Vertex AI e o Apps Script