Planejar viagens com um agente de IA acessível em todo o Google Workspace

HTTP

Apps Script

HTTP

1. No console do Google Cloud, ative as APIs Vertex AI, Places, People, Google Chat, Gmail, Cloud Build, Cloud Functions, Cloud Pub/Sub, Cloud Logging, Artifact Registry, Cloud Run e Google Workspace Add-ons.

   Ativar as APIs

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

3. Confirme se você está ativando as APIs corretas e clique em Ativar.

Apps Script

1. No console do Google Cloud, ative as APIs Vertex AI, Places, People e Google Chat.

   Ativar as APIs

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

3. Confirme se você está ativando as APIs corretas e clique em Ativar.

Python

Ver no GitHub

Apps Script

Ver no GitHub

Python

1. Faça o download deste repositório do GitHub.

   Fazer download

2. No ambiente de desenvolvimento local de sua preferência, extraia o arquivo baixado e abra o diretório add-ons-samples/python/travel-adk-ai-agent.

   unzip add-ons-samples-main.zip
   cd add-ons-samples-main/python/travel-adk-ai-agent

3. Mova o arquivo de chave JSON credentials.json da conta de serviço baixada nas etapas anteriores para o diretório do projeto.

4. No console do Google Cloud, acesse o Cloud Run:

   Acessar o Cloud Run

5. Clique em Escrever uma função.

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

   1. No campo Nome da conta de serviço, insira travel-concierge-app.
   2. Na lista Região, selecione o local do projeto do Cloud que você criou, PROJECT_LOCATION.
   3. Em URL do endpoint, clique em .
   4. Na lista Ambiente de execução, selecione a versão mais recente do Python.
   5. Na seção Autenticação, selecione Permitir acesso público.
   6. Na seção Contêineres, volumes, rede, segurança, em Recursos:
      1. No campo Memória, selecione 1 GiB.
      2. No campo CPU, selecione 2.
   7. Clique em Criar e aguarde o Cloud Run criar o serviço. O console redireciona você para a guia Origem.

7. No ambiente de desenvolvimento local de sua preferência, implante a origem do projeto:

   gcloud run deploy travel-concierge-app --quiet --source . \
       --region PROJECT_LOCATION  \
       --function adk_ai_agent  \
       --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

   Substitua:

   1. PROJECT_LOCATION com o local da função do Cloud Run criada anteriormente.
   2. LOCATION com o local do projeto do Google Cloud criado nas etapas anteriores, PROJECT_LOCATION.
   3. PROJECT_NUMBER com o número do projeto do agente de IA do Travel Concierge ADK implantado nas etapas anteriores.
   4. ENGINE_ID com o ID do mecanismo do agente de IA do ADK do Travel Concierge implantado nas etapas anteriores.
   5. BASE_URL com o URL do endpoint que você copiou antes.

Apps Script

Para criar um projeto do Apps Script e configurá-lo para usar o agente de IA do ADK do Travel Concierge implantado:

1. Clique no botão a seguir para abrir o projeto do Apps Script do Agente de IA do ADK do Travel Concierge.
   Abrir o projeto

2. Clique em info_outline Visão geral e em Fazer uma cópia.

3. Dê um nome à sua cópia do projeto do Apps Script:

   1. Clique em Cópia do agente de IA do ADK do Travel Concierge.
   2. Em Título do projeto, digite Travel Concierge ADK AI Agent.
   3. Clique em Renomear.

4. No projeto do Apps Script, clique em Editor e mova o arquivo VertexAi.gs para cima até que ele fique acima do arquivo AgentHandler.gs usando a ação Mover arquivo para cima.

5. No seu projeto do Apps Script, clique em Configurações do projeto, clique em Editar propriedades do script e em Adicionar propriedade do script para adicionar as seguintes propriedades:

6. ENGINE_ID com o ID do mecanismo do agente de IA do ADK do Travel Concierge implantado nas etapas anteriores, ENGINE_ID.

7. LOCATION com o local do projeto do Google Cloud criado nas etapas anteriores, PROJECT_LOCATION.

8. PROJECT_NUMBER com o número do projeto do agente de IA do ADK do Travel Concierge implantado nas etapas anteriores, PROJECT_NUMBER.

9. SERVICE_ACCOUNT_KEY com a chave JSON da conta de serviço baixada nas etapas anteriores, como { ... }.

10. Clique em Salvar propriedades do script.

11. No projeto do Apps Script, clique em Configurações do projeto.

12. Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.

13. Em Número do projeto do GCP, cole o número do projeto do agente de IA do ADK do Travel Concierge implantado nas etapas anteriores, PROJECT_NUMBER.

14. Clique em Configurar projeto. O projeto do Google Cloud e o projeto do Apps Script agora estão conectados.

Python

Use uma implantação de complemento do Google Workspace para instalar o projeto de exemplo em todos os aplicativos do Google Workspace (exceto o Google Chat) e ativar os testes.

1. No ambiente de desenvolvimento local de sua preferência, abra o arquivo deployment.json da origem do código do projeto e substitua todas as ocorrências de $BASE_URL pelo valor de BASE_URL, o URL do endpoint que você copiou nas etapas anteriores.

2. Crie uma implantação de complemento do Google Workspace chamada travel-concierge-addon:

   gcloud workspace-add-ons deployments create travel-concierge-addon \
       --deployment-file=deployment.json

3. Instale a implantação do complemento do Google Workspace:

   gcloud workspace-add-ons deployments install travel-concierge-addon

Apps Script

Instale o projeto do Apps Script em todos os aplicativos do Google Workspace (exceto o Google Chat) para ativar o teste.

1. No projeto do Apps Script, clique em Implantar > Testar implantações e em Instalar.

Python

Instale o projeto de exemplo no Chat usando o URL do endpoint para ativar os testes.

1. No console, pesquise Google Chat API, clique em API Google Chat, depois em Gerenciar e Configuração.

   Acessar a página de configuração da API Google Chat

2. Configure o app Chat:

   1. No campo Nome do app, digite Travel ADK AI Agent.
   2. No campo URL do avatar, insira https://goo.gle/3SfMkjb.
   3. No campo Descrição, use Travel ADK AI Agent.
   4. Em Configurações de conexão, selecione URL do endpoint HTTP.
   5. Em Gatilhos, selecione Usar um URL de endpoint HTTP comum para todos os gatilhos.
   6. No campo URL do endpoint HTTP, cole o URL do endpoint que você copiou anteriormente, BASE_URL.
   7. Registre um comando rápido que o app Chat totalmente implementado usa:
      1. Em Comandos, clique em Adicionar um comando.
      2. Em ID do comando, digite 1.
      3. Em Descrição, digite Reset session.
      4. Em Tipo de comando, selecione Comando rápido.
      5. Em Nome, digite Reset session.
      6. Clique em Concluído. O comando rápido é registrado e listado.
   8. Em Visibilidade, selecione Disponibilizar este app de chat para pessoas e grupos específicos no domínio do Workspace e digite seu endereço de e-mail.
   9. Em Registros, selecione Registrar erros no Logging.
   10. Clique em Salvar.

Apps Script

Instale o projeto do Apps Script no Chat usando o ID da implantação principal para ativar os testes.

1. No projeto do Apps Script, clique em Implantar > Testar implantações e, em seguida, Copiar em ID da implantação principal.

2. No console, pesquise Google Chat API, clique em API Google Chat, depois em Gerenciar e Configuração.

   Acessar a página de configuração da API Google Chat

3. Configure o app Chat:

   1. No campo Nome do app, digite Travel ADK AI Agent.
   2. No campo URL do avatar, insira https://goo.gle/3SfMkjb.
   3. No campo Descrição, use Travel ADK AI Agent.
   4. Em Configurações de conexão, selecione Apps Script.
   5. No campo ID da implantação, cole o ID da implantação principal que você copiou anteriormente.
   6. Registre um comando rápido que o app Chat totalmente implementado usa:
      1. Em Comandos, clique em Adicionar um comando.
      2. Em ID do comando, digite 1.
      3. Em Descrição, digite Reset session.
      4. Em Tipo de comando, selecione Comando rápido.
      5. Em Nome, digite Reset session.
      6. Clique em Concluído. O comando rápido é registrado e listado.
   7. Em Visibilidade, selecione Disponibilizar este app de chat para pessoas e grupos específicos no domínio do Workspace e digite seu endereço de e-mail.
   8. Em Registros, selecione Registrar erros no Logging.
   9. Clique em Salvar.

HTTP

Em outros apps do Google Workspace além do Chat, o agente de IA tem as seguintes limitações:

• É síncrono:as barras laterais só podem ser atualizadas em resposta às interações do usuário. Portanto, as respostas do agente de IA são exibidas somente após a conclusão total (sem streaming).

• Pode ocorrer um tempo limite:as atualizações da barra lateral expiram quando levam mais do que alguns minutos para serem concluídas.

Essas limitações não existem no Chat.

Apps Script

Em todos os aplicativos do Google Workspace, o agente de IA chama as APIs REST da Vertex AI usando UrlFetchApp, o que causa as seguintes limitações:

• É síncrono:as respostas do agente de IA são retornadas somente após a conclusão total (sem streaming).

• Pode expirar:os agentes de IA expiram quando levam mais de um minuto para concluir uma solicitação.

Python

• main.py::define as principais UIs e a lógica de interações do usuário (processadores de eventos do Google Workspace). Uma extensão típica seria ativar os documentos do Drive como um recurso de contexto para o aplicativo Drive, semelhante ao que é feito com as mensagens do Gmail para o aplicativo Gmail.

• vertex_ai.py::gerencia as sessões, respostas e erros do agente de IA e define interfaces específicas da Vertex AI para implementar e oferecer suporte a interações do agente e renderizações de respostas. Extensões típicas seriam adicionar suporte a várias sessões para conversas separadas de usuários e outras plataformas de gerenciamento de agentes de IA.

• agent_handler.py:implementa interfaces específicas da Vertex AI definidas em vertex_ai.py nos casos específicos de aplicativos do Chat e não do Chat. Uma extensão típica seria adicionar botões para que os usuários enviassem feedback sobre as respostas do agente de IA.

• google_workspace.py::implementa interações da plataforma de gerenciamento de agentes não relacionados à IA usando chamadas de API. Apenas as APIs do Google Workspace são usadas neste exemplo para coletar detalhes de contexto e realizar ações. Uma extensão típica seria adicionar funções para recuperar dados comerciais da Agenda Google ou de um sistema de gestão de relacionamento com o cliente (CRM).

• travel_agent_ui_render.gs::implementa renderizações de resposta específicas do concierge de viagens para os subagentes e aplicativos do Workspace. As extensões típicas seriam adicionar suporte para novas renderizações de resposta para mostrar graficamente opções de voo e outros agentes de IA.

Apps Script

• Code.gs::define as principais UIs e a lógica de interações do usuário (processadores de eventos do Google Workspace). Uma extensão típica seria ativar os documentos do Drive como um recurso de contexto para o aplicativo Drive, semelhante ao que é feito com as mensagens do Gmail para o aplicativo Gmail.

• VertexAi.gs::gerencia as sessões, respostas e erros do agente de IA e define interfaces específicas da Vertex AI para implementar e oferecer suporte a interações e renderizações de respostas do agente. Extensões típicas seriam adicionar suporte a várias sessões para conversas separadas de usuários e outras plataformas de gerenciamento de agentes de IA.

• AgentHandler.gs:implementa interfaces específicas da Vertex AI definidas em VertexAi.gs nos casos específicos de aplicativos de chat e não chat. Uma extensão típica seria adicionar botões para que os usuários enviassem feedback sobre as respostas do agente de IA.

• GoogleWorkspace.gs::implementa interações da plataforma de gerenciamento de agentes não relacionados à IA usando chamadas de API. Apenas as APIs do Google Workspace são usadas neste exemplo para coletar detalhes de contexto e realizar ações. Uma extensão típica seria adicionar funções para recuperar dados comerciais da Agenda Google ou de um sistema de gestão de relacionamento com o cliente (CRM).

• TravelAgentUiRender.gs::implementa renderizações de resposta específicas do concierge de viagens para os subagentes e aplicativos do Workspace. As extensões típicas seriam adicionar suporte para novas renderizações de resposta para mostrar graficamente opções de voo e outros agentes de IA.