Agente pré-criado de varejo

O agente pré-criado baseado no manual de varejo permite pesquisar itens, receber recomendações de produtos e fazer um pedido.

Diálogos de exemplo

Os diálogos de exemplo a seguir mostram cenários comuns que esse agente pré-criado processa.

Pesquisar produtos e comprar itens

O usuário pergunta sobre os relógios disponíveis na loja. O agente recomenda produtos que atendem a esses critérios, e o usuário os adiciona ao carrinho de compras. O usuário confirma que quer fazer um pedido, e o agente confirma o pedido com um número de confirmação. Em seguida, o usuário solicita recomendações de smartphones, e o agente sugere smartphones, adiciona um ao carrinho do usuário e faz um pedido para o usuário.

Entrada do usuário	Resposta do agente
oi
	Olá, sou seu assistente de compras do Google. Posso ajudar você a pesquisar itens e fazer pedidos. Como posso ajudar?
quais relógios você tem
	Temos o Google Watch. Você quer adicioná-lo ao carrinho?
sim, adicione dois, por favor
	Isso mesmo! Adicionei dois Google Watches ao seu carrinho. Mais alguma coisa?
você também pode adicionar um Google Pixel 8 ao meu carrinho?
	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. Você quer finalizar a compra?
sim, por favor
	Ok, fiz um pedido contendo 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ê também pode me ajudar a encontrar um novo smartphone?
	Temos o Google Phone Pixel 8 e o Google Phone Pixel 7. Você quer comprar um deles?
sim, me dê um Pixel 8
	Isso mesmo! Adicionei um Google Phone Pixel 8 ao seu carrinho. Mais alguma coisa?
não, podemos finalizar a compra
	Você tem um Google Phone Pixel 8 no carrinho. Você quer finalizar a compra usando esse carrinho?
sim
	Ok, fiz um pedido para você. Seu pedido contém um Google Phone Pixel 8. Seu número de confirmação é Y43KTF0T.
	Posso ajudar com mais alguma coisa hoje?
não, é só isso, obrigado
	Ok, obrigado por comprar com o Google! Tenha um bom dia.

Gerenciamento de carrinho

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

Entrada do usuário	Resposta do agente
oi, quero comprar um smartphone
	Temos o Google Phone Pixel 8 e o Google Phone Pixel 7. Qual você quer comprar?
me dê dois do 8
	Isso mesmo! Adicionei dois Google Phone Pixel 8 ao seu carrinho. Mais alguma coisa?
na verdade, você pode remover um deles?
	Claro, removi um Google Phone Pixel 8 do seu carrinho. Mais alguma coisa?
tudo pronto para fazer meu pedido
	Ok, fiz um pedido contendo um Google Phone Pixel 8. Seu número de confirmação é X0KP6K5T.
	Posso ajudar com mais alguma coisa hoje?
não, é só isso
	Ok, obrigado 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 tem.

Entrada do usuário	Resposta do agente
oi
	Olá, sou seu assistente de compras do Google. Posso ajudar você a pesquisar itens e fazer pedidos. Como posso ajudar?
quero comprar um carro
	Desculpe, não temos carros em estoque. Você quer encontrar mais alguma coisa?
sim, e relógios?
	Temos o Google Watch. Você quer adicioná-lo ao carrinho?
não, obrigado
	Posso ajudar com mais alguma coisa hoje?
não
	Ok, obrigado por comprar com o Google! Tenha um bom dia.

Entrada não reconhecida

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

Entrada do usuário	Resposta do agente
oi
	Olá, sou seu assistente de compras do Google. 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 de ferramentas.

Configuração de ferramentas

Esse agente inclui ferramentas para integração com serviços externos. Use o instalador de ferramentas pré-criado para implantar o exemplo de código e os dados do agente pré-criado.

Para implantar e configurar o exemplo de código e os dados do agente pré-criado de varejo, expanda para ver 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 installer.zip e abra a pasta installer.
4. Consulte o arquivo README.md para uma visão geral detalhada do instalador e dos requisitos dele.
5. Execute pip install -r requirements.txt para instalar os requisitos.
6. Execute gcloud auth application-default login para fazer a autenticação usando o 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 na lista suspensa 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 servers: campo com o 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 servers campo 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.

Google Store API

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

Gerenciar carrinho de compras

A ferramenta "Gerenciar carrinho de compras" permite gerenciar o carrinho de compras visualizando, adicionando e removendo itens.

Fazer pedido

A ferramenta "Fazer pedido" faz um pedido com 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.