GENAI084

Visão geral

Neste laboratório, você vai aprimorar seu assistente do Gemini Enterprise para que ele gerencie as solicitações de viagens de negócios de funcionários. Esse assistente vai se comunicar com um agente de conversação responsável por processar essas solicitações. Para que isso aconteça, você vai integrar uma ferramenta OpenAPI. Assim, o agente de conversação vai conseguir interagir com uma função do Cloud Run. Essa função vai gravar as solicitações de viagem diretamente no BigQuery para armazenamento e processamento. O diagrama mostra o fluxo a ser ativado.

Objetivos

Neste laboratório, você vai aprender a:

• implantar uma função do Cloud Run;
• criar uma ferramenta do OpenAPI para que os agentes de conversação possam chamar sua função do Cloud Run;
• implantar um aplicativo do Gemini Enterprise;
• criar um agente de conversação generativo simples usando um playbook;
• integrar seu agente de conversação ao aplicativo do Gemini Enterprise.

Configuração e requisitos

Antes de clicar no botão Start Lab

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer, que é iniciado quando você clica em Start Lab, mostra por quanto tempo os recursos do Cloud ficarão disponíveis.

Este laboratório prático do Qwiklabs permite que você realize as atividades em um ambiente real de nuvem, não em um ambiente simulado ou de demonstração. Isso é possível porque você recebe credenciais novas e temporárias para fazer login e acessar o Google Cloud Platform durante o laboratório.

O que é necessário

Para fazer este laboratório, você precisa ter:

• acesso a um navegador de Internet padrão (recomendamos o Chrome);
• tempo para concluir todas as atividades.

Observação: não use um projeto seu nem uma conta pessoal do GCP neste laboratório.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

   • O botão Abrir Console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Tarefa 1: criar uma tabela do BigQuery para registrar solicitações de viagem

Nesta tarefa, você vai criar uma tabela que vai servir como destino para armazenar as solicitações de viagem recebidas que serão enviadas ao assistente do Gemini Enterprise.

1. Abra um terminal do Cloud Shell pressionando a tecla G seguida da tecla S no teclado.

2. Clique no botão Autorizar quando a solicitação aparecer para autorizar o Cloud Shell.

3. No terminal do Cloud Shell, cole o código a seguir para criar um arquivo travel_requests_schema.json e definir o esquema de uma tabela do BigQuery que será usada para registrar solicitações de viagem:

   cat > travel_requests_schema.json << EOF [ { "name": "user", "type": "STRING", "mode": "REQUIRED" }, { "name": "travel_purpose", "type": "STRING", "mode": "REQUIRED" }, { "name": "departure_city", "type": "STRING", "mode": "NULLABLE" }, { "name": "destination_city", "type": "STRING", "mode": "NULLABLE" }, { "name": "departure_date", "type": "STRING", "mode": "NULLABLE" }, { "name": "return_date", "type": "STRING", "mode": "NULLABLE" } ] EOF

4. Execute os comandos a seguir no Cloud Shell para criar o conjunto de dados do BigQuery e a tabela usando o esquema definido no arquivo travel_requests_schema.json:

   bq --location=US mk -d {{{project_0.startup_script.bq_dataset | Bigquery Dataset}}} bq mk -t {{{project_0.startup_script.bq_dataset | Bigquery Dataset}}}.{{{project_0.startup_script.bq_table | Bigquery Table}}} travel_requests_schema.json

5. Depois de criar o conjunto de dados e a tabela, feche o painel do Cloud Shell clicando no X no canto superior direito do painel do terminal.

   Clique em Verificar meu progresso para conferir os objetivos. Criar um conjunto de dados e uma tabela do BigQuery para registrar as solicitações de viagem

Tarefa 2: criar uma função do Cloud Run para registrar as solicitações

Nesta tarefa, você vai criar a função do Cloud Run que vai receber as solicitações enviadas como JSON e gravá-las na tabela criada acima.

1. Use a barra de pesquisa na parte de cima do console do Cloud para acessar o Cloud Run.

   

2. Nas opções na parte de cima do console do Cloud Run, selecione Escrever uma função.

3. No cabeçalho Configurar, insira record-travel-request como o Nome do serviço.

4. Defina a Região como .

5. Em URL do endpoint, copie o URL fornecido e cole-o em um documento de texto. Você vai precisar dele mais tarde.

6. Defina o Ambiente de execução como Python 3.12.

7. No cabeçalho Autenticação, selecione Autenticação necessária.

8. Mantenha as outras configurações como padrão e selecione Criar. A guia Origem da função será carregada.

9. Renomeie o Ponto de entrada da função para record_travel_request.

10. Clique no arquivo requirements.txt à esquerda, exclua o conteúdo dele e cole o seguinte:

    functions-framework==3.* google-cloud-bigquery

11. Clique no arquivo main.py à esquerda, exclua o conteúdo dele e cole o código a seguir. Esta função vai receber os detalhes da solicitação de viagem fornecidos a uma solicitação POST como JSON e gravar esses valores em uma nova linha na tabela do BigQuery que você criou anteriormente:

    import functions_framework from google.cloud import bigquery @functions_framework.http def record_travel_request(request): """Writes travel requests to BigQuery. Args: request (flask.Request): A request object with JSON containing fields for user, travel_purpose, departure_city, destination_city, departure_date, and return_date. Returns: JSON response containing a 'message' field indicating the status of the request. """ request_json = request.get_json(silent=True) request_args = request.args print("JSON:" + str(request_json)) print("args:" + str(request_args)) bq_client = bigquery.Client() table_id = "{{{project_0.startup_script.project_id | Project_ID}}}.{{{project_0.startup_script.bq_dataset | Bigquery_Dataset}}}.{{{project_0.startup_script.bq_table | Bigquery_Table}}}" row_to_insert = [ {"user": request_json["user"], "travel_purpose": request_json["travel_purpose"], "departure_city": request_json.get("departure_city",""), "destination_city": request_json.get("destination_city",""), "departure_date": request_json.get("departure_date",""), "return_date": request_json.get("return_date",""), }, ] errors = bq_client.insert_rows_json(table_id, row_to_insert) # Make an API request. if errors == []: return {"message": "New row has been added."} else: return {"message": "Encountered errors while inserting rows: {}".format(errors)}

12. Espere até que todas as etapas de criação do serviço sejam concluídas no canto superior esquerdo e clique em Salvar e reimplantar.

13. Aguarde até que todas as atividades em Implantando a revisão mostrem a mensagem de status Concluído.

    

14. Clique em Testar na parte de cima do console do Cloud Run.

15. Cole estes valores no campo de entrada de teste Configurar payload:

    { "user": "Ursula Matthews", "travel_purpose": "farm inspection", "departure_city": "Santiago", "destination_city": "Doha", "departure_date": "2025-09-08", "return_date": "2025-09-16" }

16. Na parte de baixo do painel de teste, clique em Testar no Cloud Shell.

17. A janela do terminal do Cloud Shell será aberta e um comando curl será preparado para você chamar sua função. Selecione a janela do terminal e pressione Enter ou Return no teclado para enviar o comando.

18. A resposta de execução bem-sucedida vai aparecer:

    

19. Para fechar o terminal do Cloud Shell, pressione o X no canto superior direito do painel desse ambiente.

20. Abra uma nova guia do navegador ou, se estiver usando o Chrome, duplique a guia atual clicando com o botão direito do mouse e selecionando Duplicar. Acesse o BigQuery na nova guia.

21. No painel "Explorador" do BigQuery, selecione o ID do projeto .

22. Selecione o conjunto de dados .

23. Escolha a tabela .

24. Selecione a guia Visualização para conferir as solicitações de viagem registradas. Deixe essa guia aberta para voltar e verificar novas linhas à medida que você trabalha nos outros componentes deste laboratório.

    Clique em Verificar meu progresso para conferir os objetivos. Criar uma função do Cloud Run para registrar as solicitações

Tarefa 3: criar uma ferramenta de agente de conversação para chamar a função do Cloud Run

Nesta tarefa, você vai criar uma ferramenta no console do agente de conversação que pode chamar a função do Cloud Run. Seu agente de conversação poderá usar essa ferramenta para registrar as solicitações de viagem.

1. Na parte de cima do console do Google Cloud, pesquise e selecione a API Dialogflow.

   

2. Clique em Ativar.

3. Na parte de cima do console, pesquise e acesse AI Applications.

4. Clique em Continuar e ativar a API.

   

5. No tipo de app, encontre o card Agente de conversação e clique em Criar. Isso vai abrir o console Agentes de conversação em uma nova guia.

6. No painel Comece a usar os agentes de conversação, clique em Crie o seu.

   

7. Como Nome de exibição do agente, use Corporate Travel Bot.

8. Defina Local como Global.

9. Em Início da conversa, mantenha a opção Playbook selecionada.

10. Clique em Criar.

11. Depois da criação do playbook do agente de conversação, feche os pop-ups de instruções e clique no botão Configurações no canto superior direito da interface.

12. Acesse Geral > Configurações de registro.

13. Clique nas caixas de seleção Ativar o Cloud Logging e Ativar o histórico de conversas para habilitar os recursos do Cloud Logging e do histórico de conversas para seu agente.

14. Clique no botão Salvar na parte de cima do painel "Configurações" para salvar as alterações.

    

15. Antes de criar um playbook, você vai criar uma ferramenta que ele possa usar para chamar a função do Cloud Run que você criou. No menu de navegação à esquerda, selecione Ferramentas.

    

16. Clique em + Criar.

17. Em Nome da ferramenta, digite Record Travel Request.

18. Mantenha o Tipo definido como OpenAPI.

19. Em Descrição, digite Used to record a travel request.

20. Em Esquema, mantenha o tipo YAML selecionado e cole o texto a seguir na caixa de texto. Esta especificação da OpenAPI descreve uma API com:

    • Um URL de servidor definido para o domínio do Cloud Functions.

    • Um caminho chamado / que aceita solicitações POST que incluem JSON em um esquema chamado TravelRequest.

    • Uma definição do esquema TravelRequest para incluir os campos que você definiu no esquema do BigQuery no início deste laboratório:

      openapi: 3.0.0 info: title: Travel Requests API version: 1.0.0 servers: - url: 'YOUR_CLOUD_RUN_FUNCTION_URL' paths: /: post: summary: Record a new travel request operationId: recordTravelRequest requestBody: description: Travel request to add required: true content: application/json: schema: $ref: '#/components/schemas/TravelRequest' responses: '200': description: Success content: application/json: schema: type: object properties: message: type: string example: "New row has been added." components: schemas: TravelRequest: type: object required: - user - travel_purpose properties: user: type: string travel_purpose: type: string departure_city: type: string destination_city: type: string departure_date: type: string return_date: type: string

21. Substitua YOUR_CLOUD_RUN_FUNCTION_URL na especificação acima pelo URL da função do Cloud Run que você copiou anteriormente.

22. Clique em Salvar na parte de cima do painel "Ferramentas".

23. Para permitir que a ferramenta invoque a função do Cloud Run, mude para a guia do navegador que mostra o console do Cloud (não o console de agentes de conversação) e use a barra de pesquisa na parte de cima do console para acessar o IAM.

24. Marque a caixa de seleção para Incluir concessões do papel fornecidas pelo Google.

25. Encontre a linha do Agente de serviço do Dialogflow (talvez seja necessário atualizar a página) e clique no ícone de lápis de edição na linha.

26. Clique em + Adicionar outro papel.

27. No campo Selecionar papel, insira Chamador do Cloud Run.

28. Clique em Salvar.

    Clique em Verificar meu progresso para conferir os objetivos. Criar uma ferramenta de agente de conversação para chamar a função do Cloud Run

Tarefa 4: criar um playbook de agente de conversação

Nesta tarefa, você vai criar um agente de conversação que pode receber solicitações em linguagem natural e usar a ferramenta para gravá-las na tabela do BigQuery usando a função do Cloud Run.

1. Na guia do navegador com o console de agentes de conversação, use o menu de navegação à esquerda para selecionar Playbooks.

2. Selecione o playbook generativo padrão que já foi criado.

3. Mude o Nome do playbook para Confirm Travel Data.

4. Como Objetivo, digite Help users book travel.

5. Em Instruções, cole o seguinte no campo de texto:

   - Ask the user to provide for user name, travel purpose, departure city, destination city, and a range of dates. Assume a year of 2025 for dates without a year: - Use ${TOOL:Record Travel Request} - Let the user know that they should receive a list of flights to choose from in their email within 24 hours.

6. Essas instruções do playbook foram criadas para serem usadas pelo Gemini Enterprise porque ele inclui apenas um turno de conversa, mesmo que faça várias coisas nesse turno, como invocar a ferramenta e gerar uma resposta. Mais adiante, você vai dar ao agente do Gemini Enterprise a responsabilidade de coletar as informações relevantes antes de invocar esse playbook.

7. Clique em Salvar na parte de cima do painel do playbook.

8. No canto superior direito do console de agentes de conversação, clique no botão de chat Ativar simulador () para conferir uma prévia do agente de conversação.

9. Na caixa de entrada Digitar texto na parte de baixo do painel, inicie o chat com Can you help me book a flight?

10. Informe um nome, o objetivo da viagem, as cidades de partida e de destino e um período (por exemplo, Joe Smith. Customer Presentation. Berlin to Valencia. Feb 21 to 28.) para observar o comportamento do agente.

11. Um card indicando que a ferramenta Record Travel Request foi usada vai aparecer. Clique nele para conferir a entrada e a resposta da ferramenta:

    

    Observação: mude o modelo caso a resposta seja diferente de 200 e reinicie o chat redefinindo a conversa ().

12. Seu chat deve terminar com uma informação semelhante a esta:

    

    Clique em Verificar meu progresso para conferir os objetivos. Criar um playbook de agente de conversação

Tarefa 5: criar um repositório de dados do BigQuery

Nesta tarefa, você vai implantar um aplicativo do Gemini Enterprise. Para isso, será preciso criar um repositório de dados. Vamos configurar um repositório de dados do BigQuery para que você possa consultar e acessar as solicitações de viagem já registradas e integrar o Google como provedor de identidade.

1. Volte para a guia do navegador do console do Google Cloud e pesquise AI Applications na parte de cima do console.

2. Selecione Configurações no painel de navegação à esquerda.

3. Na linha do local global, clique no ícone de lápis .

4. Selecione Google Identity como provedor de identidade e clique em Salvar.

   

5. Selecione Repositórios de dados no painel de navegação à esquerda.

6. Clique em + Criar repositório de dados.

7. Pesquise BigQuery para encontrar o card BigQuery e clique em Selecionar nele.

8. Para o tipo de dados, mantenha a opção padrão Estruturado: tabela do BigQuery com seu próprio esquema.

9. Em Caminho do BigQuery, selecione Procurar.

10. Pesquise o conjunto de dados .

11. Clique no botão de opção ao lado do nome da tabela: .

12. Clique em Selecionar.

13. Clique em Continuar.

14. Você pode manter o esquema como está e clicar em Continuar.

15. Como nome, insira Travel Requests.

16. Clique em Criar.

    Clique em Verificar meu progresso para conferir os objetivos. Criar um repositório de dados do BigQuery

Tarefa 6: criar um aplicativo do Gemini Enterprise

Nesta tarefa, você vai criar um aplicativo do Gemini Enterprise e o vincular a um repositório de dados.

1. Acesse AI Applications > Apps > + Criar app.

2. Encontre o card Gemini Enterprise e clique em Saiba mais para criar o aplicativo dessa plataforma.

3. Em Nome do app, insira .

4. Defina Local como Global.

5. Em Opções avançadas, insira como Nome da empresa.

6. Clique em Criar.

7. No painel de navegação à esquerda, clique em Repositórios de dados conectados > Adicionar repositório de dados atual.

8. No painel Dados, selecione o repositório Travel Requests que você criou acima.

9. Clique em Conectar.

   Clique em Verificar meu progresso para conferir os objetivos. Criar um aplicativo do Gemini Enterprise

Tarefa 7: integrar seu agente de conversação ao aplicativo do Gemini Enterprise

Nesta tarefa, você vai permitir que o assistente do Gemini Enterprise envie mensagens para o agente de conversação e receba respostas dele.

1. Acesse Gemini Enterprise > Apps e selecione o app .

2. Na barra de navegação à esquerda, clique em Configurações.

3. Selecione a guia Assistente.

4. No cabeçalho Agentes, selecione Adicionar um item. Um card será exibido para conectar um Novo agente:

   

5. Selecione a guia do navegador que mostra o console de Agentes de conversação.

6. No menu suspenso Agente, na parte de cima do console, selecione Ver todos os agentes.

7. No final da linha do agente Corporate Travel Bot, selecione o ícone de opções (três pontos na vertical) e Copiar nome.

   

8. Volte para a guia AI Applications e, no card Novo agente, cole o valor copiado no campo Agente.

9. Como Nome de exibição do agente, use Corporate Travel Bot.

10. Em Instruções, insira:

    Use for booking travel by providing a user, travel purpose, departure city, destination city, and a date range.

11. Essas instruções orientam o assistente do Gemini Enterprise a coletar as informações necessárias antes de transmitir os detalhes para o agente de conversação em um único turno de conversa.

12. Clique em Concluído.

13. Clique em Salvar e publicar na parte de baixo do painel.

    Observação: a criação de agentes no aplicativo do Gemini Enterprise pode levar até 10 minutos. Se as etapas abaixo não funcionarem como esperado, aguarde mais alguns minutos para que o app seja criado.

    Clique em Verificar meu progresso para conferir os objetivos. Integrar o agente de conversação ao aplicativo do Gemini Enterprise

Tarefa 8: comunicar-se com seu agente de conversação pelo assistente do Gemini Enterprise

Nesta tarefa, o assistente do Gemini Enterprise vai se comunicar com o agente de conversação, que vai usar a própria ferramenta para registrar solicitações de viagem.

1. Para acessar o app na página Gemini Enterprise, clique no app chamado e acesse a guia Visão geral no menu à esquerda. Em seguida, clique em Copiar URL e abra o link em uma nova guia do navegador. Se preferir, acesse a guia Integração e copie o URL da seção O link para o app da Web.

   Como mencionado no início desta tarefa, se você encontrar um erro 404, talvez seja preciso aguardar mais alguns minutos para que o app seja criado. Atualize a página em intervalos de alguns minutos até que o app da web do Gemini Enterprise apareça.

2. Acesse Agentes e selecione Corporate Travel Bot.

3. Na barra de pesquisa principal, digite:

   Book travel for Alex Cymbal from Singapore to Council Bluffs, Iowa, departing on April 1 and returning on April 14, 2025, for a data center tour.

4. O assistente vai responder que sua solicitação foi registrada e você vai receber um e-mail de acompanhamento em até 24 horas.

   Nesta atividade, você usou instruções mínimas do playbook e nenhum exemplo de conversa, o que significa que esse agente não será muito robusto. Se precisar reiniciar a conversa para tentar de novo, clique no botão Novo no canto superior esquerdo.

5. Abaixo das respostas do assistente, há um menu "opções" (três pontos verticais). Abra as opções e clique em Mostrar informações de diagnóstico.

   

6. Nas informações de diagnóstico exibidas, confirme se a conversa acionou a invocação da função do Cloud Run encontrando "functionName": "Corporate_Travel_Bot".

   Observação: se aparecer apenas o token de acesso no painel Mostrar informações de diagnóstico, e não os detalhes da chamada de função, atualize a página e reabra o painel Informações de diagnóstico.

   

7. Para confirmar se as solicitações estão sendo registradas, volte à guia do navegador que mostra a tabela do BigQuery. Na guia Visualização, clique no ícone de atualização para conferir os dados mais recentes.

   Clique em Verificar meu progresso para conferir os objetivos. Comunicar-se com seu agente de conversação pelo assistente do Gemini Enterprise

Parabéns!

Neste laboratório, você aprendeu a ampliar o assistente do Gemini Enterprise com agentes de conversação. Mais especificamente, você aprendeu a:

• implantar uma função do Cloud Run;
• criar uma ferramenta do OpenAPI para que os agentes de conversação possam chamar sua função do Cloud Run;
• implantar um aplicativo do Gemini Enterprise;
• criar um agente de conversação generativo simples usando um playbook;
• integrar seu agente de conversação ao aplicativo do Gemini Enterprise.

Manual atualizado em 15 de outubro de 2025

Laboratório testado em 15 de outubro de 2025

Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.