GSP1259

Visão geral

Os Agentes de Conversação oferecem uma abordagem simples e visual para a criação de bots no design de agentes de conversação. Os designers de bots agora têm uma visão muito mais clara do processo geral de criação de bots, e vários designers podem colaborar facilmente na mesma criação de agente. Os Agentes de Conversação são compatíveis com vários idiomas para seu agente usar e entender, mas este laboratório usará apenas o inglês.

Neste laboratório, você vai criar um agente de conversação usando os Agentes de Conversação.

Pré-requisitos

Você precisa ter familiaridade com os conceitos básicos da IA conversacional. Leia estas transcrições de amostra para ter uma ideia de como as transcrições de clientes podem ser. Em geral, a primeira etapa para criar um agente é ler as transcrições do cliente e/ou outros dados contextuais para entender o caso de uso e os requisitos específicos da empresa.

Configuração

Antes de clicar no botão Começar o Laboratório

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

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

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.

Habilitar o API Dialogflow

1. No campo de pesquisa do console, digite "API Dialogflow".
2. Selecione o bloco da API Dialogflow.
3. Clique no botão Ativar.

Tarefa 1: crie seu agente

1. Acesse o console de Agentes de Conversação e selecione o projeto do Cloud chamado .

   

   Clique em Verificar meu progresso para conferir o objetivo. Ativar API `

2. Clique em Criar agente > Criar seu próprio. Se essa página não aparecer, atualize o navegador.

   

3. Nomeie seu agente como Reservador de voos.

4. Escolha global no menu suspenso "Local".

5. Clique em Criar.

   

6. Depois de criar o agente, acesse Configurações > Configurações do agente > Geral > Configurações de registro e marque as caixas ao lado das opções Ativar o Cloud Logging e Ativar histórico de conversa. Ele vai gerar registros para esse agente.

7. Clique em Salvar.

   

   Clique em Verificar meu progresso para conferir o objetivo.

   Criar um agente

   Teste de conhecimento

Tarefa 2: intents

Intents são os motivos que um usuário final tem para interagir com o agente, por exemplo, fazer um pedido. Você pode criar uma intent para cada tópico que eles possam querer navegar.

As intents podem ser reutilizadas em páginas e fluxos. Cada intent é definida por frases de treinamento que os usuários finais costumam perguntar. Elas podem ser anotadas ou rotuladas para coletar parâmetros específicos, como cidade de chegada ou data de partida.

Os Agentes de Conversação vão sugerir anotações conforme você inclui frases de treinamento para a intent. Elas também podem ser anotadas manualmente para coletar os valores de parâmetro que você quer extrair da interação do usuário final com seu agente.

Recomendação: para reutilizar as intenções e facilitar a manutenção, dê nomes claros e explícitos a elas.

Formato da intent: category.some_description

Exemplo de formatação:

• Intents principais: main.book_a_flight
• Intent comum, mas não principal: supplemental.flight_emissions
• Intenções reutilizáveis: confirmation.yes, confirmation_no, redirect.live_agent.

Crie sua primeira intent

1. No painel de navegação à esquerda, clique em Alertas.

2. Clique em Gerenciar > Intenções > + Criar:

   

3. Nome de exibição: main.book_a_flight

4. Em Frases de treinamento, adicione cada uma das frases a seguir aos Agentes de Conversação e clique em Enter após cada frase:

   • Reservar um voo
   • Você pode reservar meu voo para São Francisco no próximo mês?
   • Quero usar meus pontos de recompensa para reservar um voo de Milão em outubro
   • Minha família vai me visitar na semana que vem e precisamos reservar 6 passagens de ida e volta
   • Quatro passagens de classe executiva de Taiwan para Dubai de 2 a 30 de junho
   • Preciso de um voo no sábado de LAX para San Jose
   • Reserve um voo de SFO para MIA no dia 10 de agosto, só de ida
   • Preciso de ajuda para reservar uma passagem da Cidade do México para Medellín, na Colômbia, de 10 a 15 de abril.
   • Estou reservando uma viagem surpresa para minha mãe. Você pode me ajudar a organizar uma viagem para a Costa Rica de 10 a 25 de maio?
   • Você tem voos baratos para Nova York neste fim de semana?
   • Quero que meu primo venha de Montreal no dia 8 de agosto
   • Quero encontrar dois assentos para a Cidade do Panamá em 4 de julho
   • Para o aniversário de casamento, queremos ir a Seattle no Natal
   Observação: para maior precisão do modelo, é recomendável usar de 20 a 50 frases de treinamento com opções de resposta curtas e longas.

5. Clique em Salvar.

   Observação: você também pode adicionar frases de treinamento em massa criando um arquivo CSV de frases de treinamento e fazendo upload dele nos Agentes de Conversação.

Tarefa 3: fluxos e páginas

Os fluxos são usados para definir esses tópicos e os caminhos de conversa associados. Cada agente tem um fluxo chamado fluxo inicial padrão. Esse fluxo único pode ser tudo o que você precisa para um agente simples.

Agentes mais complexos podem exigir fluxos adicionais, e diferentes membros da equipe de desenvolvimento podem ser responsáveis por criar e manter esses fluxos.

Todo fluxo começa com uma Página e é composto por uma ou várias páginas diferentes para lidar com a conversa em um fluxo específico. A página em que um usuário final está é considerada a página ativa. Cada página pode ser configurada para coletar as informações necessárias do usuário final.

Crie usando o Fluxo Inicial Padrão

A página em que o agente começa é chamada de Fluxo Inicial Padrão. As páginas armazenam a lógica de roteamento, as respostas (conhecidas como fulfillment) e as ações específicas a serem tomadas se uma intent não puder ser correspondida (conhecidas como no-match) ou se receber no-input (quando o agente não recebe uma resposta a tempo).

1. Clique em Build.

2. Clique em Página inicial para abrir a página.

   

3. Nas opções expandidas na página inicial, selecione o ícone + ao lado de Rotas.

   

4. Selecione a intent main.book_a_flight no menu suspenso e clique em Salvar.

   

5. Em seguida, na seção "Rotas", clique na rota main.book_a_flight.

6. Role para baixo até Transição e escolha + nova Página no menu suspenso.

7. Nomeie a página como Informações sobre ingressos e clique em Salvar.

   

8. Saia das janelas para voltar à exibição principal dos fluxos e ver a nova página Informações do tíquete conectada à página Início.

   

   O início do fluxo agora inclui uma saudação e, em seguida, vai para a página Informações do tíquete quando a intent main.book_a_flight é correspondida. Na página "Informações do bilhete", você vai coletar parâmetros do usuário final para que ele possa reservar o voo.

Tarefa 4: entidades e parâmetros

• Entidades definem o tipo de informação que você quer extrair de um usuário final, por exemplo, a cidade para a qual ele quer voar. Use as "entidades do sistema" integradas do Agente Conversacional para corresponder a datas, horários, cores, endereços de e-mail e assim por diante.

• As entidades de sistema também podem ser estendidas para incluir valores que não fazem parte dos valores de sistema padrão. Se você precisar criar uma entidade totalmente personalizada, poderá fazer isso criando um tipo de entidade personalizada para corresponder a dados personalizados para sua empresa e que não são encontrados como uma entidade do sistema.

• Parâmetros são informações fornecidas pelo usuário final durante uma sessão, como data, hora e cidade de destino. Cada parâmetro tem um nome e um tipo de entidade. Elas são escritas em snake_case (minúsculas com sublinhados entre as palavras)

Crie seu primeiro conjunto de parâmetros

Em seguida, você vai usar uma entidade para extrair um parâmetro obrigatório do usuário final.

1. Clique na página Ticket Information e depois em + em Parameters para coletar dados de voo.

2. Insira departure_city no campo Nome de exibição.

3. Escolha @sys.geo-city no menu suspenso Tipo de entidade.

4. Role para baixo até Cumprimento do comando inicial > Respostas do agente > + Adicionar resposta de diálogo > Diálogo do agente e adicione De qual cidade você gostaria que o voo partisse?

5. Clique em Salvar.

   

6. Saia desta janela para criar outro parâmetro.

7. Clique em + em Parâmetros novamente para criar mais quatro parâmetros, um por um, com o nome, o tipo de entidade e a forma como o agente vai solicitar ao usuário final.

   Nome de exibição	Tipo de entidade	Caixa de diálogo do agente:
   departure_date	@sys.date	Qual é o mês e o dia da partida?
   destination_city	@sys.geo-city	Qual é a cidade de destino?
   return_date	@sys.date	Qual é o mês e o dia do voo de volta?
   passenger_name	@sys.any	Qual é o nome do passageiro?

   Quando terminam, elas são listadas assim:

   

   Observação: a ordem em que os parâmetros são listados afeta a ordem em que o agente de reservas de voos vai pedir cada um deles. Você pode mudar a ordem facilmente arrastando os parâmetros para cima ou para baixo.

   Teste de conhecimento

Tarefa 5: condições

Depois que o agente coletar os cinco parâmetros necessários para a reserva de voos, você vai direcionar o usuário final para outra página usando uma condição de roteamento, que você vai criar em seguida.

1. Saia da janela de parâmetros para retornar à página Informações do tíquete.

2. Role para baixo até encontrar Rotas e clique no sinal + ao lado.

3. Role para baixo até Condição > Regras de condição > selecione "Corresponder a PELO MENOS UMA regra (OR)"

4. No campo Parâmetro, insira $page.params.status.

5. Escolha o sinal de = no menu suspenso Operando.

6. No campo Valor, insira: "FINAL" (inclua as aspas duplas).

7. Clique em Salvar.

   

   Teste de conhecimento

Tarefa 6: cumprimento das instruções

Agora adicione uma resposta para dizer ao usuário final quando todos os cinco parâmetros de reserva forem coletados. Essas respostas são chamadas de Fulfillment.

1. Na condição que você acabou de criar, role um pouco para baixo e localize a seção chamada Fulfillment.

2. Em Respostas do agente, clique em Adicionar resposta de diálogo, selecione Diálogo do agente e digite o seguinte: Agradeço pelas informações. Vou verificar a disponibilidade do seu tíquete e clicar em Adicionar.

3. Clique em Salvar.

   (Agora fique nesta página enquanto lê a próxima etapa de confirmação de informações.)

   

Tarefa 7: confirmação de informações

Depois de oferecer uma resposta (ou fulfillment), você precisa criar uma transição para uma nova página que vai repetir para o usuário final se as informações de viagem coletadas (parâmetros) estiverem corretas.

1. Continue rolando para baixo (depois do atendimento que você acabou de criar) até chegar em Transição.

2. No campo Página, selecione o menu suspenso para escolher + nova Página.

3. Digite Confirmar viagem no campo Nome da página.

   

4. Clique em Salvar.

5. Saia da janela.

6. Confira o fluxo das suas três páginas.

   

Repetir os parâmetros coletados dos usuários finais

Os parâmetros de sessão armazenam informações coletadas anteriormente do usuário final e ficam ativos durante toda a sessão. Elas também ajudam você a repetir informações para o usuário final.

Por exemplo, o agente pode repetir o nome do passageiro: "Agradecemos por fornecer essas informações, $session.params.passenger_name." Isso será exibido para o usuário final como "Agradecemos as informações, João Dias."

Eles são formatados da seguinte maneira:

• Prefixo: $session.params.
• Nome da entidade: passenger_name

A referência à cidade de partida seria: $session.params.departure_city

1. Na visualização "Build", clique na página Confirmar viagem > Preenchimento de entrada > campo Editar preenchimento.

   

2. Como você usou cinco parâmetros, pode repeti-los para o usuário usando os seguintes parâmetros de sessão. Cole o texto a seguir na seção Diálogo do agente e clique em Adicionar:

   Este e-mail serve para confirmar que $session.params.passenger_name vai voar De: $session.params.departure_city Para: $session.params.destination_city Partida: $session.params.departure_date Retorno: $session.params.return_date Está tudo correto?

3. Clique em Salvar.

4. É assim que o Agente de Conversação vai repetir os parâmetros da sessão coletados para o usuário final:

   

Rota de confirmação positiva

1. Saia da janela para voltar à página Confirmar viagem. Clique em + ao lado de Rotas.

   

2. Clique no menu suspenso Intents e em + nova Intent.

   

3. Em "Nome de exibição", digite confirmation.yes.

4. Em "Frases de treinamento", digite sim e pressione Enter (você pode adicionar mais frases como "correto", "sim" etc. para melhorar a correspondência de NLU para esse intent).

   

5. Clique em Salvar.

6. Depois de salvar, role para baixo até a seção Cumprimento e, em Respostas do agente, clique em Adicionar resposta de diálogo, selecione Diálogo do agente e digite o seguinte: Ótimo, seu voo está reservado!. Clique em Adicionar.

   

7. Em seguida, clique em Salvar.

8. Clique na seta para voltar, ao lado de Rota.

   

Rota de confirmação negativa

Agora adicione lógica para direcionar um usuário final a relembrar os parâmetros do voo se ele disser que as informações estão incorretas.

1. Ainda na seção "Rotas", selecione Adicionar rota.

   

2. No menu suspenso "Intents", escolha + nova Intent.

3. Nomeie a intent como confirmation.no no campo "Nome de exibição".

   

4. Role para baixo até a seção "Frases de treinamento", digite não e clique em Enter.

   

5. Clique em Salvar.

6. Em seguida, role para baixo até a seção Transição > Página e escolha Informações do ingresso no menu suspenso.

   

Observação: isso serve para pedir novamente as informações de voo do usuário.

7. Role para cima até Predefinições de parâmetros e clique em Adicionar parâmetro . Insira os seguintes 5 valores e atribua o valor null sem aspas.

   Observação: você vai precisar excluir as aspas na coluna de valor e digitar null. Isso serve para excluir os parâmetros coletados do usuário final.

   Parâmetro	Valor
   departure_city	null
   destination_city	null
   departure_date	null
   return_date	null
   passenger_name	null

   

   O objetivo é remover o valor que foi coletado anteriormente do usuário final para permitir que ele envie um novo valor. Se essa etapa for ignorada, pode resultar em um cenário de loop infinito no seu bot.

8. Clique em Salvar.

9. Saia da janela para voltar à visualização "Build". Agora você vai ver o fluxo das três páginas. Observe que a última página tem duas setas entre as páginas "Confirmar viagem" e "Informações do ingresso" porque a intent confirmation.no está vinculada de volta.

   

   Teste de conhecimento

Tarefa 8: teste

1. Para testar se o agente funciona como esperado, clique em Ativar simulador no canto superior direito da tela.

2. No menu suspenso Recurso inicial, selecione Fluxo inicial padrão.

3. Interaja com o agente como se fosse o usuário final. Ao percorrer o fluxo principal, observe as páginas, intenções e transições que você criou.

   Dependendo de como você organizou a coleta de parâmetros, tente digitar a seguinte amostra de diálogo:

   • Eu gostaria de reservar um quarto.
   • Austin
   • Amanhã
   • Boston
   • Na próxima sexta-feira
   • Mickey Mouse
   • Sim

   Isso deve resultar em uma transação bem-sucedida pelo seu agente, comumente conhecida como cenário ideal.

   Este é um exemplo do teste do agente acima no console do Test Agent:

   

Clique em Verificar meu progresso para conferir o objetivo. Testar o agente

Tarefa 9: como exportar seu agente

Quando você cria um agente para um projeto, pode exportá-lo para usar em outro projeto. Você pode exportar seu agente e salvá-lo para usar em laboratórios futuros ou continuar criando seu próprio projeto pessoal.

1. No menu suspenso Agente na parte de cima do console de Agentes de Conversação, clique em Ver todos os agentes.

   

2. Na tela da lista de agentes, clique no menu de contexto ao lado do seu agente e depois em Exportar.

   

3. Na tela do agente de exportação, escolha Download para arquivo local e clique em Exportar.

   

Parabéns!

Você criou um agente de conversação e se familiarizou com os conceitos básicos.

Próximas etapas / Saiba mais

• Adicione a Documentação dos Agentes de Conversação aos favoritos

Manual atualizado em 28 de fevereiro de 2025

Laboratório testado em 28 de fevereiro de 2025

Copyright 2025 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.