Playbook pré-criado para varejo

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Observação: esse recurso tem acesso limitado. Entre em contato com a equipe de conta do Google Cloud para solicitar acesso a esse recurso e acessar a documentação de referência da API.

O manual predefinido de varejo permite que os usuários pesquisem itens, recebam recomendações de produtos e façam pedidos.

Exemplos de diálogos

As caixas de diálogo de exemplo a seguir demonstram cenários comuns processados por este playbook pré-criado.

Pesquisar produtos e comprar itens

O usuário pergunta sobre os relógios disponíveis na loja. O agente recomenda produtos que atendem a esse critério, e o usuário os adiciona ao carrinho de compras. O usuário confirma que gostaria de fazer um pedido, e o agente confirma o pedido com um número de confirmação. 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 ele.

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. Quer adicionar o item ao seu carrinho?
sim, adicione dois
	Isso mesmo! Adicionei dois relógios Google 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. Você 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?
Você pode me ajudar a encontrar um novo smartphone?
	Temos o Google Phone Pixel 8 e o Google Phone Pixel 7. Você gostaria de comprar um deles?
sim, me dê um Pixel 8
	Isso mesmo! Adicionei um smartphone Google Pixel 8 ao seu carrinho. Mais alguma coisa?
Não, podemos verificar.
	Você tem um smartphone Google Pixel 8 no carrinho. Você quer finalizar a compra usando este carrinho?
sim
	Certo, fiz um pedido para você. Seu pedido contém um smartphone Google Pixel 8. Seu número de confirmação é Y43KTF0T.
	Posso ajudar com mais alguma coisa hoje?
Não, tudo bem, obrigado
	Agradecemos por comprar com o Google. Tenha um bom dia.

Gerenciamento de carrinho

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

Entrada do usuário	Resposta do agente
Olá, quero comprar um smartphone
	Temos o Google Phone Pixel 8 e o Google Phone 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?
Você pode remover uma delas?
	Claro, removi um smartphone Google Pixel 8 do seu carrinho. Mais alguma coisa?
Tudo pronto para fazer o pedido
	Ok, fiz um pedido com um smartphone Google Pixel 8. Seu número de confirmação é X0KP6K5T.
	Posso ajudar com mais alguma coisa hoje?
Não, isso é tudo
	Agradecemos por comprar com o Google. Tenha um bom dia.

Produto não encontrado

O usuário pergunta sobre um produto que não é vendido na loja.

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
	Não temos carros em estoque. Você quer encontrar mais alguma coisa?
Sim, e os relógios?
	Temos o Google Watch. Quer adicionar o item ao seu carrinho?
Agora não
	Posso ajudar com mais alguma coisa hoje?
não
	Agradecemos por comprar com o Google. Tenha um bom dia.

Entrada não reconhecida

O usuário pergunta sobre um assunto não relacionado a produtos ou pedidos. O agente responde repetindo os tópicos que ele aborda e pergunta ao usuário em que ele precisa de 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 com isso. Posso ajudar você a pesquisar produtos, como smartphones, relógios e fones de ouvido. Também posso ajudar você a fazer pedidos. Como posso ajudar?

Configuração básica

Para configurar este playbook pré-criado:

1. Importe o playbook predefinido.
2. Configure as ferramentas fornecidas com seus serviços externos. Consulte Configuração de ferramentas.

Configuração da ferramenta

Esse agente inclui ferramentas que são usadas para integração com serviços externos. Você pode usar o instalador de ferramentas pré-criadas para implantar códigos e dados de exemplo para seu playbook pré-criado.

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

1. Faça o download do instalador de ferramentas pré-criadas 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 README.md para conferir 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:

   Console do Agent Builder

   1. Se você ainda não importou o agente pré-criado, importe o agente para seu projeto.
   2. Acesse o console do Criador de agentes.

      Console do Criador de agentes

   3. Selecione seu projeto no menu suspenso do console.
   4. Selecione seu app.
   5. Clique no ícone 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.

Google Store API

A ferramenta Google Store API é usada para buscar itens da Google Store com base em um termo de pesquisa.

Gerenciar o carrinho de compras

A ferramenta Manage Shopping Cart permite que o usuário gerencie o carrinho de compras visualizando todos os itens, adicionando e removendo itens do carrinho.

Fazer pedido

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

Concluído

Seu agente e as integrações dele estão configurados e prontos para testes.