Agente pré-criado de varejo

O agente pré-criado baseado em playbook de varejo permite pesquisar itens, receber recomendações de produtos e fazer pedidos.

Exemplo de diálogo

Este exemplo de diálogo mostra cenários comuns que esse agente pré-criado processa.

Pesquisar produtos e comprar itens

1. O usuário pergunta sobre os relógios disponíveis na loja.
2. O agente recomenda produtos que atendem a esses critérios.
3. O usuário adiciona o produto ao carrinho.
4. O usuário adiciona outro produto ao carrinho.
5. O usuário pergunta sobre o conteúdo do carrinho.
6. O agente lista os itens no carrinho, e o usuário confirma que quer comprá-los.
7. O agente faz o pedido e fornece um número de confirmação.
8. O usuário pede uma recomendação de smartphone.
9. O agente recomenda smartphones disponíveis na loja.
10. O usuário adiciona um ao carrinho.
11. O usuário faz um pedido para o smartphone e fornece um número de confirmação.

Entrada do usuário	Resposta do agente
Olá,
	Olá, sou seu assistente do Google Shopping. Posso ajudar você a pesquisar itens e fazer pedidos. Como posso ajudar?
Quais relógios você tem?
	Temos o Google Watch. Quer adicionar ao carrinho?
sim, adicione dois, por favor
	Isso mesmo! Adicionei dois Google Watches ao seu carrinho. Mais alguma coisa?
Você pode adicionar um Google Pixel 8 ao meu carrinho também?
	Isso mesmo! Adicionei um Google Pixel 8 ao seu carrinho. Mais alguma coisa?
o que tem no meu carrinho?
	Você tem um Google Pixel 8 e dois Google Watches no carrinho. Quer finalizar a compra?
sim, por favor
	Certo, fiz um pedido com um Google Pixel 8 e dois Google Watches. Seu número de confirmação é QKA67DW2.
	Posso ajudar com mais alguma coisa hoje?
na verdade, você pode me ajudar a encontrar um celular novo também?
	Temos o smartphone do Google Pixel 8 e o smartphone do Google Pixel 7. Quer comprar um deles?
Sim, quero um Pixel 8
	Isso mesmo! Adicionei um smartphone Google Pixel 8 ao seu carrinho. Mais alguma coisa?
Não, podemos conferir
	Você tem um smartphone do Google Pixel 8 no carrinho. Quer finalizar a compra usando este carrinho?
sim
	Certo, fiz um pedido para você. Seu pedido contém um smartphone do Google Pixel 8. Seu número de confirmação é Y43KTF0T.
	Posso ajudar com mais alguma coisa hoje?
Não, só isso, obrigado.
	Certo, agradecemos por comprar com o Google. Tenha um bom dia.

Gerenciamento de carrinhos

O usuário pede para adicionar alguns itens ao carrinho e remove um antes de fazer o pedido.

Entrada do usuário	Resposta do agente
Olá, quero comprar um celular
	Temos o smartphone do Google Pixel 8 e o smartphone do Google Pixel 7. Qual você quer comprar?
me dê dois dos 8
	Isso mesmo! Adicionei dois smartphones Google Pixel 8 ao seu carrinho. Mais alguma coisa?
thought na verdade, você pode remover um deles?
	Removi um smartphone do Google Pixel 8 do seu carrinho. Mais alguma coisa?
Tudo pronto para fazer meu pedido
	Certo, fiz um pedido com um smartphone do Google Pixel 8. Seu número de confirmação é X0KP6K5T.
	Posso ajudar com mais alguma coisa hoje?
Não, é só isso.
	Certo, agradecemos por comprar com o Google. Tenha um bom dia.

Produto não encontrado

O usuário pergunta sobre um produto que a loja não vende.

Entrada do usuário	Resposta do agente
Olá,
	Olá, sou seu assistente do Google Shopping. Posso ajudar você a pesquisar itens e fazer pedidos. Como posso ajudar?
Quero comprar um carro
	Não temos carros em estoque. Quer encontrar mais alguma coisa?
Sim, e os relógios?
	Temos o Google Watch. Quer adicionar ao carrinho?
Agora não
	Posso ajudar com mais alguma coisa hoje?
não
	Certo, agradecemos por comprar com o Google. Tenha um bom dia.

Entrada não reconhecida

1. O usuário pergunta sobre um tópico não relacionado a produtos ou pedidos.
2. O agente responde repetindo os tópicos que aborda e pergunta ao usuário em que ele precisa de ajuda.

Entrada do usuário	Resposta do agente
Olá,
	Olá, sou seu assistente do Google Shopping. Posso ajudar você a pesquisar itens e fazer pedidos. Como posso ajudar?
Quero reservar um hotel
	Desculpe, não posso ajudar você com isso. Posso ajudar você a pesquisar produtos, incluindo smartphones, relógios e fones de ouvido. Também posso ajudar você a fazer pedidos. Como posso ajudar?

Configuração básica

Siga estas etapas para configurar esse agente pré-criado:

1. Importe o agente pré-criado.
2. Configure as ferramentas fornecidas com seus serviços externos. Para mais informações, consulte Configuração da ferramenta.

Configuração da ferramenta

Esse agente inclui ferramentas para integração com serviços externos. Implante dados e exemplos de código para seu agente pré-criado usando o instalador de ferramentas.

Para implantar e configurar o exemplo de código e os dados do agente pré-criado de varejo, abra as instruções.

1. Faça o download do instalador de ferramentas pré-criado para um diretório local.
2. Navegue até o diretório local em que você fez o download de installer.zip.
3. Descompacte o arquivo installer.zip e abra a pasta installer.
4. Consulte o arquivo README.md para uma visão geral detalhada do instalador e dos requisitos.
5. Execute pip install -r requirements.txt para instalar os requisitos.
6. Execute gcloud auth application-default login para autenticar usando gcloud auth.
7. Execute o instalador usando python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail
8. Depois de implantar todos os serviços necessários, configure cada ferramenta no agente pré-criado com os URLs fornecidos registrados pelo instalador:

   Generative AI App Builder

   1. Se você ainda não importou o agente pré-criado, importe o agente para seu projeto.
   2. Acesse o Generative AI App Builder.

      Generative AI App Builder

   3. Selecione seu projeto no menu suspenso do console.
   4. Selecione seu app.
   5. Clique no ícone de Ferramentas.
   6. Para cada ferramenta no agente, edite o esquema para substituir o URL no campo servers: pelo endpoint registrado pelo instalador.
   7. Clique em Salvar.

   Dialogflow CX

   1. Se você ainda não importou o agente pré-criado, importe o agente para seu projeto.
   2. Abra o console do Dialogflow CX.
   3. Escolha seu projeto do Google Cloud.
   4. Selecione seu agente.
   5. Clique no ícone de Recursos generativos.
   6. Clique em Ferramentas.
   7. Para cada ferramenta no agente, edite o esquema para substituir o URL no campo servers pelo endpoint registrado pelo instalador.
   8. Clique em Salvar.
9. Conceda à conta de serviço do Compute Engine (your-project-number-developer.gserviceaccount.com) o papel de Usuário do Cloud Datastore, para que as funções do Cloud Run recém-implantadas possam acessar o Firestore.

Ferramenta da API Google Store

A ferramenta da API Google Store busca itens na Google Store com base em um termo de pesquisa.

Ferramenta de gerenciamento do carrinho de compras

A ferramenta de gerenciamento do carrinho de compras permite que o usuário gerencie o carrinho de compras visualizando, adicionando e removendo itens.

Ferramenta de pedidos

A ferramenta Place Order faz um pedido para o carrinho de compras atual do usuário e retorna um número de confirmação.

Concluído

Seu agente está configurado e pronto para testes.