Neste tutorial, mostramos como criar um app do Google Chat que responde perguntas com base em conversas nos espaços do Chat usando a IA generativa com a tecnologia Vertex AI com Gemini. O app do Chat usa a API Google Workspace Events e o Pub/Sub para reconhecer e responder perguntas postadas nos espaços do Chat em tempo real, mesmo quando isso não for mencionado.
O app do Chat usa todas as mensagens enviadas no espaço como fonte de dados e base de conhecimento: quando alguém faz uma pergunta, o app do Chat verifica se há respostas compartilhadas anteriormente e compartilha uma. Se nenhuma resposta for encontrada, ele vai informar que não pode atender. Em cada resposta, os usuários podem clicar no botão de ação acessório para @mencionar um administrador e pedir uma resposta. Com o Gemini AI, o app Google Chat se adapta e aumenta a base de conhecimento à medida que treina continuamente em conversas nos espaços a que é adicionada.
Veja como o app do Chat funciona no espaço de integração e suporte de funcionários:
-
Figura 2. Dana pergunta se a empresa oferece treinamento de oratória. -
Figura 3. O app Chat, assistente de conhecimento em IA, solicita que a Vertex AI com o Gemini responda à pergunta de Dana com base no histórico de conversas do espaço do Chat. Depois, a resposta é compartilhada.
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 use a IA generativa para responder a perguntas com base no conhecimento compartilhado nas conversas no espaço do Chat.
- Com a IA generativa:
- Detecte e responda às perguntas dos funcionários.
- Aprenda continuamente com conversas em andamento em um espaço do Chat.
- Detecte e responda a mensagens em um espaço do Chat em tempo real, mesmo quando o app do Chat não for enviado diretamente.
- Manter mensagens gravando e lendo em um banco de dados do Firestore.
- Para facilitar a colaboração em um espaço do Chat, mencione os administradores quando nenhuma resposta for encontrada.
Arquitetura
No diagrama a seguir, mostramos a arquitetura dos recursos do Google Workspace e do Google Cloud usados pelo app Assistente de conhecimento de IA do Chat.
O app do Chat assistente de conhecimento em IA funciona da seguinte maneira:
Um usuário adiciona o app do Chat assistente de conhecimento de IA a um espaço do Chat:
O app do Chat solicita que o usuário que o adicionou ao espaço do Chat configure a autenticação e a autorização.
O app do Chat busca as mensagens do espaço chamando o método
spaces.messages.list
na API Chat e, em seguida, armazena as mensagens buscadas em um banco de dados do Firestore.O app do Chat chama o método
subscriptions.create
na API Events do Google Workspace para começar a detectar eventos, como mensagens, no espaço. O endpoint de notificação da assinatura é um tópico do Pub/Sub que usa o Eventarc para encaminhar o evento ao app do Chat.O app do Chat publica uma mensagem de introdução ao espaço.
Um usuário no espaço do Chat posta uma mensagem:
O app do Chat recebe a mensagem em tempo real do tópico do Pub/Sub.
O app do Chat adiciona a mensagem ao banco de dados do Firestore.
Se um usuário editar ou excluir a mensagem posteriormente, o app do Chat receberá o evento atualizado ou excluído em tempo real e, em seguida, atualizará ou excluirá a mensagem no banco de dados do Firestore.
O app Chat envia a mensagem para a Vertex AI com o Gemini:
O comando instrui a Vertex AI com o Gemini a verificar se a mensagem inclui uma pergunta. Em caso afirmativo, o Gemini responde à pergunta com base no histórico de mensagens do espaço do Chat mantido no Firestore e, em seguida, o app do Google Chat envia a mensagem para o espaço do Chat. Se não tiver, não responda.
Se a Vertex AI com o Gemini responder à pergunta, o app do Chat vai postar a resposta chamando o método
spaces.messages.create
na API Chat usando a autenticação de app.Se a Vertex AI com o Gemini não puder responder à pergunta, o app do Chat vai postar uma mensagem dizendo que não consegue encontrar uma resposta para essa pergunta no histórico do espaço do Chat.
As mensagens sempre incluem um botão de ação acessório em que os usuários podem clicar, o que faz com que o app do Chat mencione @um administrador do espaço pedindo que ele responda.
O app do Chat recebe uma notificação de ciclo de vida da API Events do Google Workspace informando que a assinatura do espaço do Chat está prestes a expirar:
- O app do Chat envia uma solicitação para renovar a
assinatura chamando o método
subscriptions.patch
na API Events do Google Workspace.
- O app do Chat envia uma solicitação para renovar a
assinatura chamando o método
O app do Chat é removido de um espaço do Chat:
O app do Chat exclui a assinatura chamando o método
subscriptions.delete
na API Events do Google Workspace.O app do Chat exclui os dados do espaço do Chat do Firestore.
Confira os produtos usados pelo app do Chat assistente de conhecimento de IA
O app Chat assistente de conhecimento em IA usa os seguintes produtos do Google Workspace e do Google Cloud:
- API Vertex AI com Gemini: uma plataforma de IA generativa com tecnologia Gemini. O app Chat assistente de conhecimento em IA usa a API Vertex AI com o Gemini para reconhecer, entender e responder às perguntas dos funcionários.
-
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
Assistente com conhecimento em IA do Chat usa a API Chat para:
- Receba e responda a eventos de interação enviados pelo Chat.
- Liste as mensagens enviadas em um espaço.
- Poste as respostas às perguntas dos usuários em um espaço.
- Configure atributos que determinam como ele aparece no Chat, como nome e imagem do avatar.
- API Google Workspace Events: essa API permite que você se inscreva em eventos e gerencie notificações de mudança nos aplicativos do Google Workspace. O app assistente de conhecimento em IA do Chat usa a API Events do Google Workspace para detectar mensagens postadas em um espaço do Chat e detectar e responder a perguntas, mesmo quando elas não são mencionadas.
- Firestore: um banco de dados de documentos sem servidor. O app do Chat, assistente de conhecimento em IA, usa o Firestore para armazenar dados sobre mensagens enviadas em um espaço do Chat.
- Pub/Sub: é um serviço de mensagens assíncrono e escalonável que separa os serviços que produzem mensagens dos serviços que as processam. O app assistente de conhecimento em IA do Chat usa o Pub/Sub para receber eventos de assinatura dos espaços do Chat.
- Eventarc: o Eventarc permite criar arquiteturas orientadas a eventos sem precisar implementar, personalizar ou manter a infraestrutura subjacente. O app assistente de conhecimento em IA do Chat usa o Eventarc para rotear eventos do Pub/Sub para um espaço do Chat e a função do Cloud que recebe e processa os eventos de assinatura.
-
Cloud Functions:
um serviço de computação leve e sem servidor que permite criar
funções autônomas e de finalidade única que podem responder a eventos de
interação e assinatura com o Chat sem a necessidade de gerenciar um servidor ou um ambiente de
execução. O app Chat assistente de conhecimento em IA
usa duas funções do Cloud chamadas:
-
app
: hospeda o endpoint HTTP para o 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. -
eventsApp
: recebe e processa eventos do espaço do Chat, como mensagens de uma assinatura do Pub/Sub.
- Cloud Build: uma plataforma de integração, entrega e implantação contínuas totalmente gerenciada que executa builds automatizados.
- Cloud Run: um ambiente totalmente gerenciado para executar aplicativos conteinerizados.
-
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
- No console do Google Cloud, acesse Menu > IAM e administrador > Criar um projeto.
-
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.
- No campo Local, clique em Procurar para exibir possíveis locais para seu projeto. Em seguida, clique em Selecionar.
- 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
Ativar o faturamento para o projeto do Cloud
Console do Google Cloud
- No console do Google Cloud, acesse Faturamento. Clique em Menu > Faturamento > Meus projetos.
- Em Selecionar uma organização, escolha a organização associada ao seu projeto do Google Cloud.
- Na linha do projeto, abra o menu Ações ( ), clique em Alterar faturamento e escolha a conta do Cloud Billing.
- Clique em Definir conta.
CLI da gcloud
- Para listar as contas de faturamento disponíveis, execute:
gcloud billing accounts list
- 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
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, a API Google Workspace Events, a API Eventarc e a API Cloud Run Admin.
Confirme se você está ativando as APIs no projeto correto do Cloud e clique em Próxima.
Confirme se você ativou as APIs corretas e clique em Ativar.
CLI da gcloud
Se necessário, defina o projeto atual do Cloud para aquele que você criou:
gcloud config set project PROJECT_ID
Substitua PROJECT_ID pelo ID do projeto do projeto do Cloud que você criou.
Ative a API Google Chat, a API Vertex AI, a API Cloud Functions, a API Firestore, a API Cloud Build, a API Pub/Sub, a API Eventos do Google Workspace, a API Eventarc e a API Cloud Run Admin:
gcloud services enable chat.googleapis.com \ aiplatform.googleapis.com \ cloudfunctions.googleapis.com \ firestore.googleapis.com \ cloudbuild.googleapis.com \ pubsub.googleapis.com \ workspaceevents.googleapis.com \ eventarc.googleapis.com \ run.googleapis.com
Configurar a autenticação e a autorização
A autenticação e a autorização permitem que o app do Chat acesse recursos no Google Workspace e no Google Cloud.
Neste tutorial, você publica o app Google Chat internamente, então não há problema em usar informações de marcador de posição. Antes de publicar o app do Google Chat externamente, substitua as informações do marcador por informações reais para a tela de consentimento.
Configurar a tela de permissão OAuth, especificar escopos e registrar seu app
No console do Google Cloud, acesse Menu > APIs e serviços > Tela de permissão OAuth.
Em Tipo de usuário, selecione Interno e clique em Criar.
Em Nome do app, digite
AI knowledge assistant
.Em E-mail para suporte do usuário, selecione seu endereço de e-mail ou um Grupo do Google apropriado.
Em Dados de contato do desenvolvedor, insira seu endereço de e-mail.
Clique em Save and continue.
Clique em Adicionar ou remover escopos. Um painel aparece com uma lista de escopos para cada API ativada no projeto do Cloud.
Em Adicionar escopos manualmente, cole o seguinte escopo:
https://www.googleapis.com/auth/chat.messages
Clique em Adicionar à tabela.
Clique em Atualizar.
Clique em Save and continue.
Leia o resumo do registro do aplicativo e clique em Voltar para o painel.
Criar credenciais de ID do cliente OAuth
No console do Google Cloud, acesse Menu > APIs e serviços > Credenciais.
Clique em Criar credenciais > ID do cliente OAuth.
Clique em Tipo de aplicativo > Aplicativo da Web.
No campo Nome, digite um nome para a credencial. Esse nome só é mostrado no console do Google Cloud.
Em URIs de redirecionamento autorizados, clique em Adicionar URI.
Em URIs 1, digite o seguinte:
https://REGION-PROJECT_ID.cloudfunctions.net/app/oauth2
Substitua:
- REGION: a região da função do Cloud, como
us-central1
. Posteriormente, quando você criar as duas funções do Cloud, será preciso definir a região delas para esse valor. - PROJECT_ID: o ID do projeto do Cloud que você criou.
- REGION: a região da função do Cloud, como
Clique em Criar.
Na janela Cliente OAuth criado, clique em Fazer o download do JSON.
Salve o arquivo transferido por download como
client_secrets.json
. Depois, ao criar as duas funções do Cloud, inclua o arquivoclient_secrets.json
em cada implantação.Clique em OK.
Crie o tópico do Pub/Sub
O tópico do Pub/Sub funciona com a API Events do Google Workspace para se inscrever em eventos em um espaço do Chat, como mensagens, e notificar o app do Chat em tempo real.
Veja como criar o tópico do Pub/Sub:
Console do Google Cloud
No console do Google Cloud, acesse Menu > Pub/Sub.
Clique em Criar tópico.
Em ID do tópico, digite
events-api
.Desmarque a opção Adicionar uma assinatura padrão.
Em Criptografia, selecione Chave de criptografia gerenciada pelo Google.
Clique em Criar. O tópico do Pub/Sub é exibido.
Para que este tópico do Pub/Sub e a API Events do Google Workspace funcionem juntos, conceda ao usuário do IAM do Chat permissão para postar no tópico do Pub/Sub:
No painel events-api, em PERMISSÕES, clique em Adicionar principal.
Em Adicionar principais, em Novos principais, digite
chat-api-push@system.gserviceaccount.com
.Em Atribuir papéis, em Selecionar um papel, escolha Pub/Sub > Editor do Pub/Sub.
Clique em Salvar.
CLI da gcloud
Crie um tópico do Pub/Sub com o ID
events-api
:gcloud pubsub topics create events-api
Conceda ao usuário do IAM do Chat permissão para postar no tópico do Pub/Sub:
gcloud pubsub topics add-iam-policy-binding events-api \ --member='serviceAccount:chat-api-push@system.gserviceaccount.com' \ --role='roles/pubsub.publisher'
Crie o banco de dados do Firestore
O banco de dados do Firestore persiste e recupera
dados de espaços do Chat, como mensagens. Você não define o modelo de dados, que é definido implicitamente no código de amostra pelos arquivos model/message.js
e services/firestore-service.js
.
O banco de dados do app Chat do assistente de conhecimento de IA usa um modelo de dados NoSQL baseado em Modelo de dados do Firestore.
documentos organizados em coleções . Para saber mais, consulteNo diagrama a seguir, apresentamos uma visão geral do modelo de dados do app Assistente de conhecimento de IA do Chat:
A raiz contém duas coleções:
spaces
, em que cada documento representa um espaço do Chat em que o app do Chat é adicionado. Cada mensagem é representada por um documento na subcoleçãomessages
.users
, em que cada documento representa um usuário que adicionou o app do Chat a um espaço do Chat.
Ver definições de coleção, documento e campo
spaces
Um espaço do Chat que inclui o app do Chat, assistente de conhecimento de IA.
Campos | |
---|---|
Document ID | String ID exclusivo de um espaço específico. Uma parte do nome do recurso do espaço na API Chat. |
messages | Subcollection of Documents ( Mensagens enviadas no espaço do Chat. Corresponde ao Document ID de uma message no Firebase. |
spaceName | String O nome exclusivo do espaço na API Chat. Corresponde ao nome do recurso do espaço na API Chat. |
messages
Mensagens enviadas no espaço do Chat.
Campos | |
---|---|
Document ID | String ID exclusivo de uma mensagem específica. |
name | String O nome exclusivo de uma mensagem na API Chat. Corresponde ao nome do recurso da mensagem na API do Chat. |
text | String O corpo do texto da mensagem. |
time | String (Timestamp format) A hora em que a mensagem foi criada. |
users
Usuários que adicionaram o app do Chat assistente de conhecimento em IA a um espaço do Chat.
Campos | |
---|---|
Document ID | String ID exclusivo de um usuário específico. |
accessToken | String O token de acesso concedido durante a autorização do usuário do OAuth 2.0 usado para chamar APIs do Google Workspace. |
refreshToken | String O token de atualização concedido durante a autorização do usuário do OAuth 2.0. |
Veja como criar o banco de dados do Firestore:
Console do Google Cloud
No console do Google Cloud, acesse Menu > Firestore.
Clique em Criar banco de dados.
Em Selecionar o modo Firestore, clique em Modo nativo.
Clique em Continuar.
Configure o banco de dados:
Em Nomear seu banco de dados, deixe o ID do banco de dados como
(default)
.Em Tipo de local, selecione Região.
Em Região, 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 do Cloud Functions do app do Chat.
Clique em Criar banco de dados.
CLI da gcloud
Crie um banco de dados do Firestore no modo nativo:
gcloud firestore databases create \ --location=LOCATION \ --type=firestore-native
Substitua LOCATION pelo nome de uma região do Firestore, como
us-central1
. Para ter o melhor desempenho, selecione o mesmo local ou um local próximo do Cloud Functions do app do Chat.
crie e implante o app do Chat
Agora que seu projeto do Google Cloud foi criado e configurado, você está pronto para criar e implantar o app do Chat. Nesta seção, você fará o seguinte:
- Criar e implantar duas funções do Cloud. um para responder a eventos de interação do Chat e outro para responder a eventos do Pub/Sub.
- Criar e implantar um app do Chat na página de configuração da API Google Chat.
Crie e implante o Cloud Functions
Nesta seção, você vai criar e implantar duas funções do Cloud chamadas:
app
: hospeda e executa o código do app do Chat que responde a eventos recebidos do Chat como solicitações HTTP.eventsApp
: recebe e processa eventos do espaço do Chat, como mensagens do Pub/Sub.
Juntas, essas funções do Cloud compõem a lógica de aplicativo do assistente de conhecimento de IA do Chat.
Como alternativa, antes de criar o Cloud Functions, reserve um momento para analisar e se familiarizar com o exemplo de código hospedado no GitHub.
Criar e implantar app
Console do Google Cloud
Faça o download do código do GitHub como um arquivo ZIP.
Extraia o arquivo ZIP salvo.
A pasta extraída contém todo o repositório de amostras do Google Workspace.
Na pasta extraída, navegue até o diretório
google-chat-samples-main/node/ai-knowledge-assistant
.No diretório
google-chat-samples/node/ai-knowledge-assistant
, adicione o arquivoclient_secrets.json
que você transferiu por download quando criou credenciais de ID do cliente OAuth para autenticação e autorização.Compacte o conteúdo da pasta
ai-knowledge-assistant
em um arquivo zip.O diretório raiz do arquivo ZIP precisa conter os seguintes arquivos e pastas:
.gcloudignore
.gitignore
README.md
deploy.sh
env.js
events_index.js
http_index.js
index.js
client_secrets.json
package-lock.json
package.json
controllers/
model/
services/
test/
No console do Google Cloud, acesse Menu > Cloud Functions.
Verifique se o projeto do Google Cloud do seu app do Chat está selecionado.
Clique em
Criar função.Na página Criar função, configure a função:
- Em Ambiente, selecione 2a geração.
- Em Nome da função, digite
app
. - Em Região, selecione uma região, como
us-central1
. Essa região precisa corresponder à região definida no URI de redirecionamento autorizado quando você criou credenciais de ID do cliente OAuth para autenticação e autorização. - Em Tipo de acionador, selecione HTTPS.
- Em Autenticação, selecione Permitir invocações não autenticadas.
- Clique em Próxima.
Em Ambiente de execução, selecione Node.js 20.
Em Ponto de entrada, exclua o texto padrão e digite
app
.Em Código-fonte, selecione Upload do ZIP.
Em Bucket de destino, crie ou selecione um bucket:
- Clique em Procurar.
- Escolha um bucket.
- 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.
Em Arquivo ZIP, faça upload do arquivo ZIP que você baixou do GitHub, extraiu e recompactou:
- Clique em Procurar.
- Navegue até o arquivo ZIP e selecione-o.
- Clique em Abrir.
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.
Edite o exemplo de código para definir constantes:
- Na página Detalhes da função do Cloud, clique em Editar.
- Clique em Próxima.
- Em Código-fonte, selecione Editor in-line.
- No editor in-line, abra e edite o arquivo
env.js
:- Defina o valor de project como o ID do projeto do Cloud.
- Defina o valor de location como a região da função do Cloud, como
us-central1
.
Selecione Implantar.
CLI da gcloud
Clone o código do GitHub:
git clone https://github.com/googleworkspace/google-chat-samples.git
Alterne para o diretório que contém o código deste app do Chat assistente de IA:
cd google-chat-samples/node/ai-knowledge-assistant
No diretório
google-chat-samples/node/ai-knowledge-assistant
, adicione o arquivoclient_secrets.json
que você transferiu por download quando criou credenciais de ID do cliente OAuth para autenticação e autorização.Edite o arquivo
env.js
para definir as variáveis de ambiente:- Defina o valor de project como o ID do projeto do Cloud.
- Defina o valor de location como a região da
função do Cloud, como
us-central1
.
Implante a função do Cloud no Google Cloud:
gcloud functions deploy app \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=app \ --trigger-http \ --allow-unauthenticated
Substitua REGION pelo valor da região da Função do Cloud para corresponder ao definido no arquivo
env.js
, comous-central1
.
Criar e implantar eventsApp
Console do Google Cloud
No console do Google Cloud, acesse Menu > Cloud Functions.
Verifique se o projeto do Google Cloud do seu app do Chat está selecionado.
Clique em
Criar função.Na página Criar função, configure a função:
- Em Ambiente, selecione 2a geração.
- Em Nome da função, digite
eventsApp
. - Em Região, selecione uma região, como
us-central1
. Essa região precisa corresponder à região definida no URI de redirecionamento autorizado quando você criou credenciais de ID do cliente OAuth para autenticação e autorização. - Em Tipo de gatilho, selecione Cloud Pub/Sub.
- Em Tópico do Cloud Pub/Sub, selecione o nome do tópico do Pub/Sub que você
criou, que tem o formato
projects/PROJECT/topics/events-api
, em que PROJECT é o ID do projeto do Cloud. - Se você receber uma mensagem começando a
Service account(s) might not have enough permissions to deploy the function with the selected trigger.
, clique em Conceder a todos. - Clique em Próxima.
Em Ambiente de execução, selecione Node.js 20.
Em Ponto de entrada, exclua o texto padrão e digite
eventsApp
.Em Código-fonte, selecione Zip do Cloud Storage.
No local do Cloud Storage, clique em Procurar.
Selecione o bucket para o qual você fez upload do arquivo ZIP quando criou a função do Cloud
app
.Clique no arquivo ZIP que você enviou.
Clique em Selecionar.
Selecione Implantar.
A página Detalhes do Cloud Functions é aberta e sua função aparece com três indicadores de progresso: um para a versão, outro para o serviço e outro para o gatilho. Quando os três indicadores de progresso desaparecem e são substituídos por uma marca de seleção, a função é implantada e fica pronta.
Edite o exemplo de código para definir constantes:
- Na página Detalhes da função do Cloud, clique em Editar.
- Clique em Próxima.
- Em Código-fonte, selecione Editor in-line.
- No editor in-line, abra e edite o arquivo
env.js
:- Defina o valor de project como o ID do projeto do Cloud.
- Defina o valor de location como a região da Função do Cloud, como
us-central1
.
Selecione Implantar.
CLI da gcloud
Na CLI gcloud, se você ainda não estiver nela, mude para o diretório que contém o código deste app do Chat assistente de conhecimento de IA que você clonou anteriormente do GitHub:
cd google-chat-samples/node/ai-knowledge-assistant
No diretório
google-chat-samples/node/ai-knowledge-assistant
, adicione o arquivoclient_secrets.json
que você transferiu por download quando criou credenciais de ID do cliente OAuth para autenticação e autorização.Edite o arquivo
env.js
para definir as variáveis de ambiente:- Defina o valor de project como o ID do projeto do Cloud.
- Defina o valor de location como a região da
função do Cloud, como
us-central1
.
Implante a função do Cloud no Google Cloud:
gcloud functions deploy eventsApp \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=eventsApp \ --trigger-topic=events-api
Substitua REGION pelo valor da região da Função do Cloud para corresponder ao definido no arquivo
env.js
, comous-central1
.
Copie o URL do gatilho da função do Cloud app
Cole o URL de gatilho da função do Cloud app
na próxima seção
ao
Configurar o app do Chat no console do Google Cloud.
Console do Google Cloud
No console do Google Cloud, acesse Menu > Cloud Functions.
Na coluna Nome da lista de funções do Cloud, clique em
app
.Clique em Gatilho.
Copie o URL.
CLI da gcloud
Descreva a função do Cloud
app
:gcloud functions describe app
Copie a propriedade
url
.
Configurar o app 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 o app do Chat, incluindo o nome do app do Chat e o URL do gatilho da função do Cloud do app do Chat para a qual ele envia eventos de interação do Chat.
No console do Google Cloud, clique em Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat > Gerenciar > Configuração.
Em Nome do app, digite
AI knowledge assistant
.No URL do avatar, digite
https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/live_help/default/24px.svg
.Em Descrição, digite
Answers questions with AI
.Clique no botão Ativar recursos interativos para ativar essa opção.
Em Funcionalidade, selecione Participar de espaços e conversas em grupo.
Em Configurações de conexão, selecione URL do aplicativo.
Em URL do app, cole o URL do gatilho da função do Cloud
app
formatada comohttps://
REGION-
PROJECT_ID.cloudfunctions.net/app
, em que REGION é a região da função do Cloud, comous-central1
e PROJECT_ID é o ID do projeto do projeto do Cloud que você criou.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.
Opcionalmente, em Registros, selecione Registrar erros no Logging.
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 assistente de conhecimento em IA do Chat em um espaço do Chat com mensagens fazendo perguntas que ele pode responder.
Confira algumas maneiras de testar o app do Chat assistente de conhecimentos de IA:
- Adicione o app assistente de conhecimento em IA do Chat a um espaço do Chat atual e faça perguntas relevantes nesse espaço.
- Crie um espaço do Chat e poste algumas mensagens para usar como
fonte de dados. As mensagens podem ser provenientes do
Gemini, com um comando como
Answer 20 common onboarding questions employees ask their teams.
. Também é possível colar alguns parágrafos do guia de visão geral do desenvolvimento com o Chat e fazer perguntas sobre ele.
Neste tutorial, vamos criar um espaço do Chat e colar alguns parágrafos do guia Desenvolver com o Chat a visão geral.
Abra o Google Chat.
Criar um espaço do Chat:
Clique em > Criar um espaço.
Novo ChatEm Nome do espaço, digite
Testing AI knowledge assistant app
.Em Para que serve este espaço?, selecione Colaboração.
Em Configurações de acesso, escolha quem pode acessar o espaço.
Clique em Criar.
Adicione mensagens a serem usadas como fonte de dados:
Em um navegador da Web, acesse o guia de visão geral do desenvolvimento com o Chat.
Copie e cole o conteúdo do guia no espaço do Chat que você criou.
Adicione o app do Chat assistente de conhecimento em IA:
Na barra de escrita de mensagens, digite
@AI knowledge assistant
e, no menu de sugestões exibido, selecione o app do assistente de conhecimento de IA do Chat e pressioneenter
.Aparece uma mensagem perguntando se você quer adicionar o app do Chat, assistente de conhecimentos de IA, ao espaço. Clique em Adicionar ao espaço.
Se esta for a primeira vez que você adiciona o app do Chat a um espaço, configure a autenticação e a autorização dele:
- Clique em Configurar.
- Uma nova janela ou guia do navegador será aberta solicitando que você escolha uma Conta do Google. Escolha a conta que será usada no teste.
- Revise as permissões solicitadas pelo app Assistente de conhecimentos de IA do Chat. Para concedê-las, clique em Permitir.
- Aparecerá uma mensagem com a mensagem
You may close this page now.
. Feche a janela ou guia do navegador e volte ao espaço do Chat.
Faça uma pergunta:
Na barra de escrita da mensagem, digite uma pergunta como
What are Google Chat apps?
.O app Assistente do Chat, assistente de IA, responde.
Ou, se a resposta não for precisa ou suficiente, para melhorar o histórico de conversas da IA, clique em
Receber ajuda. O app Chat menciona um administrador do espaço e pede para responder à pergunta. Na próxima vez, o app assistente do Assistente de IA para IA vai saber a resposta.
Considerações, opções de arquitetura alternativas e próximas etapas
Esta seção analisa outras maneiras de criar o assistente de conhecimento de IA do app Chat.
Firestore, Cloud Storage ou fazer chamadas de lista de mensagens na API Chat
Neste tutorial, recomendamos armazenar dados do espaço do Chat, como
mensagens, em um banco de dados do Firestore, porque isso melhora o desempenho
em comparação com a chamada do método list
no recurso Message
com a API Chat sempre que o
app do Chat responde a uma pergunta. Além disso, chamar list messages
repetidamente pode fazer com que o app do Chat atinja os limites de cota da API.
No entanto, se o histórico de conversas de um espaço do Chat ficar muito longo, o uso do Firestore pode se tornar caro.
O Cloud Storage é uma alternativa ao Firestore. Cada espaço em que o app assistente de conhecimento em IA do Chat está ativo recebe um objeto próprio, e cada objeto é um arquivo de texto que contém todas as mensagens no espaço. A vantagem dessa abordagem é que todo o conteúdo do arquivo de texto pode ser alimentado à Vertex AI com o Gemini de uma só vez, mas a desvantagem é que é necessário mais trabalho para atualizar o histórico de conversas, porque não é possível anexar a um objeto no Cloud Storage, apenas substituí-lo. Essa abordagem não faz sentido se você atualiza regularmente o histórico de mensagens, mas seria uma boa escolha se você atualizasse o histórico de mensagens periodicamente, por exemplo, uma vez por semana.
Resolver problemas
Quando um app ou card do Google Chat retorna um erro, a interface do Chat mostra a mensagem "Algo deu errado". ou "Não foi possível processar sua solicitação". Às vezes, a interface do Chat não exibe nenhuma mensagem de erro, mas o app ou o cartão do Chat produz um resultado inesperado. Por exemplo, uma mensagem de card pode não aparecer.
Embora uma mensagem de erro possa não aparecer 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 para 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.
- No Console do Google Cloud, acesse a página Gerenciar recursos. Clique em Menu > IAM e administrador > Gerenciar recursos.
- Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
- Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.
Temas relacionados
- Gerencie projetos com o Google Chat, a Vertex AI e o Firestore
- Responda a incidentes com o Google Chat, a Vertex AI e o Apps Script