Neste tutorial, mostramos como criar um app do Google Chat que responde a incidentes em tempo real. Ao responder a um incidente, o app cria e preenche um espaço do Chat, facilita o incidente a resolução com mensagens, comandos de barra e caixas de diálogo e usa IA para resumir a resposta a incidentes em um documento Google.
Um incidente é um evento que requer a atenção imediata de uma equipe. de pessoas resolver. Exemplos de incidentes:
- Um caso urgente é criado em um sistema de gestão de relacionamento com o cliente (CRM). exigindo a colaboração de uma equipe de serviço para chegar a uma solução.
- Um sistema fica off-line, alertando um grupo de engenheiros de confiabilidade do site (SREs) para que eles possam trabalhar juntos para colocá-los novamente on-line.
- Há um terremoto de alta magnitude e os profissionais de emergência precisam para coordenar essas respostas.
Para este tutorial, o alerta de incidente começa quando alguém informa o incidente clicando em um botão em uma página da Web. A página da Web simula um incidente solicitando que os usuários insiram informações básicas do incidente: título, descrição e endereços de e-mail dos participantes.
Confira o app do Chat de gerenciamento de incidentes em ação:
-
Figura 1. o site em que alguém pode relatar um incidente. -
Figura 2. Notificação de que o espaço do Chat do incidente foi criado. -
Figura 3. O espaço do Chat de resposta a incidentes. -
Figura 4. Resolver o incidente com um comando de barra. -
Figura 5. Caixa de diálogo de resolução de incidentes. -
Figura 6. um documento do Documentos Google para resolução de incidentes compartilhado no espaço. -
Figura 7. O documento Google Docs sobre resolução de incidentes com resumo de IA.
Pré-requisitos
Se você precisa ativar algum desses pré-requisitos na sua organização, peça seu administrador do Google Workspace para ativá-las:
- Uma empresa Conta do Google Workspace com acesso a Google Chat.
- Ter Diretório (compartilhamento de contatos) ativado para o Google Workspace. O aplicativo do incidente usa no diretório para procurar os responsáveis pela resposta informações de contato, como nome e endereço de e-mail. Os responsáveis pela resposta a incidentes precisam ser usuários com uma conta do Google Chat do Google Workspace na sua organização.
Objetivos
- Criar um app do Chat que responda a incidentes.
- Para ajudar os usuários a responder a incidentes, faça o seguinte:
- Criar espaços de resposta a incidentes.
- Publicar mensagens resumindo incidentes e respostas.
- Apoiar a colaboração com modelos Recursos do app de chat.
- Resuma conversas e resoluções com a Vertex AI.
Arquitetura
O diagrama a seguir mostra a arquitetura do Google Workspace Recursos do Google Cloud usados pela resposta a incidentes app Google Chat.
A arquitetura mostra como a resposta a incidentes O app Google Chat processa um incidente e a resolução.
Um usuário inicia um incidente em um site externo hospedado em Apps Script.
O site envia uma solicitação HTTP assíncrona para o App Google Chat, também hospedado no Apps Script.
O app do Google Chat de resposta a incidentes processa a solicitação:
O serviço do SDK Admin do Apps Script recebe um membro da equipe informações, como ID do usuário e endereço de e-mail.
Com um conjunto de solicitações HTTP para a API Chat usando o o serviço avançado de chat do Apps Script, a resposta a incidentes O app do Google Chat cria um incidente o preenche com os membros da equipe e envia uma mensagem para ele.
Os membros da equipe discutem o incidente no espaço do Chat.
Um membro da equipe invoca um comando de barra para sinalizar uma resolução para o o incidente.
Uma chamada HTTP para a API Chat usando o Apps Script O serviço avançado do Chat lista todos os recursos do Chat mensagens do espaço.
A Vertex AI recebe as mensagens listadas e gera um resumo.
O serviço
DocumentApp
do Apps Script cria um do app Documentos Google e adiciona o resumo da Vertex AI ao documento.As chamadas do app Google Chat de resposta a incidentes API Chat para enviar uma mensagem compartilhando um link para o resumo do app Documentos Google.
Prepare o ambiente
Nesta seção, mostramos como criar e configurar um projeto do Google Cloud para a App Chat.
Criar um projeto do Google Cloud
Console do Google Cloud
- No console do Google Cloud, acesse o menu > IAM e Administrador > Criar um projeto.
-
No campo Nome do projeto, insira um nome descritivo para o projeto.
Opcional: para editar o ID do projeto, clique em Editar. O ID do projeto não pode ser alterado após a criação do projeto, então escolha um ID que atenda às suas necessidades para o ciclo de vida projeto.
- No campo Local, clique em Procurar para mostrar os possíveis locais para sua projeto. Em seguida, clique em Selecionar.
- Clique em Criar. O console do Google Cloud acessa a página "Painel" e seu projeto é criado em alguns minutos.
CLI da gcloud
Em um dos ambientes de desenvolvimento a seguir, acesse o Google Cloud CLI (`gcloud`):
-
Cloud Shell: para usar um terminal on-line com a gcloud CLI
configure o Cloud Shell.
Ativar o Cloud Shell -
Local Shell: para usar um ambiente de desenvolvimento local,
instalar e
inicializar
a CLI gcloud.
Para criar um projeto do Cloud, use o comando "gcloud projects create":gcloud projects create PROJECT_ID
Ative o faturamento para o projeto do Cloud
Console do Google Cloud
- No console do Google Cloud, acesse Faturamento. Clique em Cardápio > Faturamento > Meus projetos.
- Em Selecionar uma organização, escolha a organização associada a seu projeto do Google Cloud.
- Na linha do projeto, abra o menu Ações. ( ), Clique em Alterar faturamento e escolha 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 da projeto do Google Cloud em que você quer ativar o faturamento.BILLING_ACCOUNT_ID
é o ID da conta de faturamento a ser vinculada. no projeto do Google Cloud.
Ative as APIs
Console do Google Cloud
No console do Google Cloud, ative a API Google Chat, a API Google Docs as APIs Admin SDK e Vertex AI.
Confirme se você está ativando as APIs projeto do Google Cloud e clique em Próxima.
Confirme se você está ativando as APIs corretas e clique em Ativar.
CLI da gcloud
Se necessário, defina o projeto do Cloud atual como o que você criou pelo comando
gcloud config set project
:gcloud config set project PROJECT_ID
Substitua PROJECT_ID pelo ID do projeto da do Google Cloud que você criou.
Ative a API Google Chat, a API Google Docs, a API Admin SDK e a API Vertex AI pelo comando
gcloud services enable
:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Configurar a autenticação e a autorização
Com a autenticação e a autorização, Recursos de acesso a apps do Chat no Google Workspace e o Google Cloud para processar uma resposta a incidentes.
Neste tutorial, você vai publicar o app internamente, então não há problema em usar o marcador de posição informações imprecisas ou inadequadas. Antes de publicar o app externamente, substitua o marcador informações reais para a tela de consentimento.
No console do Google Cloud, acesse Cardápio > 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
Incident Management
.Em E-mail para suporte do usuário, selecione seu endereço de e-mail ou uma grupo do Google.
Em Dados de contato do desenvolvedor, insira seu endereço de e-mail.
Clique em Salvar e continuar.
Clique em Adicionar ou remover escopos. Será exibido um painel com uma lista de escopos. para cada API ativada no projeto do Cloud.
Em Adicionar escopos manualmente, cole os seguintes escopos:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
Clique em Adicionar à tabela.
Clique em Atualizar.
Clique em Salvar e continuar.
Leia o resumo do registro do app e clique em Voltar ao painel.
Criar e implantar o app do Chat
Na seção a seguir, você vai copiar e atualizar um Projeto do Apps Script que contém todos os aplicativos necessários para o app do Chat. Por isso, não é necessário copiar e e colar cada arquivo.
Algumas funções incluem sublinhados no final dos nomes, como
processSlashCommand_()
de ChatApp.gs
. O sublinhado oculta a função
da página da Web de inicialização do incidente quando ele é aberto em um navegador. Para mais
informações, consulte
Funções particulares.
O Apps Script oferece suporte a dois tipos de arquivo: scripts .gs
e .html
.
. Para respeitar esse suporte, o JavaScript do lado do cliente do app é incluído
nas tags <script />
, e o CSS delas é incluído em tags <style />
na
um arquivo HTML.
Outra opção é acessar o projeto inteiro no GitHub.
Esta é uma visão geral de cada arquivo:
Consts.gs
Define as constantes referenciadas por outros arquivos de código, incluindo o ID do projeto do Cloud, o ID do local da Vertex AI e os ID de comando de barra para encerrar um incidente.
Ver código do app
Consts.gs
ChatApp.gs
Lida com eventos de interação do Chat, incluindo: mensagens, cliques em cards, comandos de barra e caixas de diálogo. Responde ao evento Comando de barra
/closeIncident
abrindo uma caixa de diálogo para coletar o incidente detalhes da resolução. Lê mensagens no espaço chamando Métodospaces.messages.list
na API Chat. Recebe IDs de usuário com o serviço Diretório do SDK Admin no Apps Script.Ver código do app
ChatApp.gs
ChatSpaceCreator.gs
Recebe os dados do formulário que os usuários inserem no incidente página da Web de inicialização do aplicativo e a usa para configurar criando e preenchendo-o e publicando uma mensagem sobre o o incidente.
Ver código do app
ChatSpaceCreator.gs
DocsApi.gs
Chama a API Google Docs para criar um documento do Google Docs em um Google Drive do usuário e um resumo das informações do incidente, criado em
VertexAiApi.gs
ao documento.Ver código do app
DocsApi.gs
VertexAiApi.gs
Resume a conversa no Chat usando a Vertex AI. Esse resumo é publicado em um espaço criado documento em
DocsAPI.gs
.Ver código do app
VertexAiApi.gs
WebController.gs
Disponibiliza o site de inicialização do incidente.
Ver código do app
WebController.gs
Index.html
O HTML do site de inicialização de incidentes.
Ver código do app
Index.html
JavaScript.html
Lida com o comportamento do formulário, incluindo envios, erros e apagados do site de inicialização de incidentes. Está incluído em
Index.html
pela funçãoinclude
personalizada emWebController.gs
.Ver código do app
JavaScript.html
Stylesheet.html
O CSS do site de inicialização do incidente. Está incluída em
Index.html
pela funçãoinclude
personalizadaWebController.gs
Ver código do app
Stylesheet.html
Encontrar o número e o ID do projeto do Cloud
No console do Google Cloud, acesse seu projeto do Cloud.
Clique em "Configurações e utilitários" > Configurações do projeto.
Anote os valores nos campos Número do projeto e ID do projeto. Você usá-los nas seções a seguir.
Criar o projeto do Apps Script
Para criar um projeto do Apps Script e conectá-lo à sua Projeto do Google Cloud:
- Clique no botão a seguir para abrir o projeto do Apps Script Responder a incidentes com o Google Chat.
Abrir o projeto. - Clique em Overview.
- Na página de visão geral, clique em
Fazer uma cópia.
Nomeie sua cópia do projeto do Apps Script:
Clique em Cópia de Responder a incidentes com o Google Chat.
Em Título do projeto, digite
Incident Management Chat app
.Clique em Renomear.
Na sua cópia do projeto do Apps Script, acesse
Consts.gs
e substituaYOUR_PROJECT_ID
pelo ID do seu do Google Cloud.
Definir o projeto do Cloud do projeto do Apps Script
- No seu projeto do Apps Script,
Clique em
Configurações do projeto.
- Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.
- Em Número do projeto do GCP, cole o número do projeto do Cloud.
- Clique em Configurar projeto. O projeto do Cloud e o Apps Script estão conectadas.
Criar uma implantação do Apps Script
Agora que todo o código está no lugar, implante o Apps Script projeto. O ID de implantação é usado para configurar Chat no Google Cloud.
No Apps Script, abra o projeto do app de resposta a incidentes.
Clique em Implantar > Nova implantação.
Se Complemento e App da Web ainda não estiverem selecionados, ao lado de Selecionar tipo, clique nos tipos de implantação
e selecione Complemento e App da Web.
Em Descrição, digite uma descrição para essa versão, como
Complete version of incident management app
Em Executar como, selecione Usuário acessando o app da Web.
Em Quem pode acessar, selecione Qualquer pessoa na sua organização do Workspace. em que "sua organização do Workspace" é o nome do seu organização do Google Workspace.
Clique em Implantar. Relatórios do Apps Script concluídos implantação e fornece um ID de implantação e um URL para a solicitação página da Web de inicialização.
Anote o URL do app da Web para acessar mais tarde ao iniciar um incidente. Copie o ID da implantação. Ele é usado durante a configuração do App de chat no console do Google Cloud.
Clique em Concluído.
Configurar o app do Chat no console do Google Cloud
Esta seção mostra como configurar a API Google Chat no console do Google Cloud com informações sobre o app do Chat, incluindo ID da implantação que você acabou de criar a partir do seu Apps Script projeto.
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
Incident Management
.No URL do avatar, digite
https://developers.google.com/chat/images/quickstart-app-avatar.png
.Em Descrição, digite
Responds to incidents.
.Clique no botão Ativar recursos interativos para ativar essa opção.
Em Funcionalidade, selecione Receber mensagens individuais, Participar de espaços e conversas em grupo.
Em Configurações de conexão, selecione Projeto do Apps Script.
Em Deployment ID, cole o ID de implantação do Apps Script que você copiou do projeto do Apps Script implantação do Google Workspace.
Registre um comando de barra que usos do app do Chat totalmente implementado:
Em Comandos de barra, clique em Adicionar um comando de barra.
Em Nome, digite
/closeIncident
.Em ID do comando, digite
1
.Em Descrição, digite
Closes the incident being discussed in the space.
Selecione Abre uma caixa de diálogo.
Clique em Concluído. O comando de barra é registrado e listado.
Em Visibilidade, selecione Disponibilizar este app do Chat para pessoas e grupos específicos na sua Workspace e digite seu endereço de e-mail.
Em Registros, selecione Registrar erros no Logging.
Clique em Salvar. Uma mensagem de configuração salva é exibida, indicando que o aplicativo é prontos para serem testados.
Teste o app do Chat
Para testar o app do Chat de gerenciamento de incidentes, inicie uma incidente da página da Web e verificar se o app do Chat funciona como esperado:
Acesse o URL do app da Web de implantação do Apps Script.
Quando o Apps Script pede permissão para acessar seus dados, clique em Analisar permissões e faça login com a Conta do Google apropriada. no domínio do Google Workspace e clique em Permitir.
A página da Web de inicialização do incidente é aberta. Insira as informações do teste:
- Em Título do incidente, digite
The First Incident
. - Em Responsáveis a incidentes, você também pode digitar os endereços de e-mail dos com outros profissionais de resposta a incidentes. Eles precisam ser usuários com conta do Google Chat na sua organização do Google Workspace ou falha ao criar um espaço. Não insira seu endereço de e-mail porque ele é incluído automaticamente.
- Em Mensagem inicial, digite
Testing the incident management Chat app.
.
- Em Título do incidente, digite
Clique em Criar espaço do Chat. Uma mensagem
creating space
será exibida.Depois que o espaço é criado, a mensagem
Space created!
aparece. Clique em Abrir o espaço, que abre o espaço no Chat em uma nova guia.Opcionalmente, você e os outros responsáveis pela resposta a incidentes podem enviar mensagens no espaço. O app resume essas mensagens usando a Vertex AI e compartilha uma documento de retrospectiva.
Para encerrar a resposta a incidentes e iniciar o processo de resolução, no Espaço do Chat. Digite
/closeIncident
. Um plano de gestão de incidentes a caixa de diálogo será aberta.Em Fechar incidente, digite uma descrição para a resolução do incidente. como
Test complete
.Clique em Fechar incidente.
O aplicativo de gerenciamento de incidentes lista as mensagens no espaço e as resume com a Vertex AI, cola o resumo em um arquivo dos Documentos Google e compartilha documento no espaço.
Limpar
Para evitar cobranças na sua conta do Google Cloud pelo recursos usados neste tutorial, recomendamos que você exclua os do Google Cloud.
- No console do Google Cloud, acesse a página Gerenciar recursos. Clique em Cardápio > 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 o projeto.
Temas relacionados
- Responda a perguntas baseadas nas conversas do Chat com o app Gemini AI Chat
- Gerenciar projetos com o Google Chat, a Vertex AI e o Firestore
- O aplicativo de resposta a incidentes se autentica com credenciais de usuário para chamar APIs
e invocar os serviços do Google Cloud, como a API Chat e a API Vertex AI.
Isso significa que o usuário que inicializa um incidente precisa ter acesso a essas
serviços. Para tornar o app mais robusto, chame a API Vertex AI
como conta de serviço em vez das credenciais do usuário que está invocando
o comando de barra
/closeIncident
. Para receber ajuda para configurar uma conta de serviço para a API Vertex AI, consulte Usar uma conta de serviço personalizada.