Agente pré-criado de varejo

O agente pré-criado baseado em playbook da Retail permite que os usuários pesquisem itens, recebam recomendações de produtos e façam um pedido.

Exemplos de diálogos

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

Pesquisar e comprar produtos

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 quer fazer um pedido, e o agente confirma o pedido com um número de confirmação. Em seguida, o usuário pede recomendações de smartphones, e o agente sugere modelos, 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 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
	Ok, 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 smartphone novo também?
	Temos o Google Pixel 8 e o Google Pixel 7. Você gostaria de 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 fazer o check-out
	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, isso é tudo, obrigado
	Certo, agradecemos por fazer compras com o Google. Tenha um bom dia.

Gerenciamento de carrinho

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

Entrada do usuário	Resposta do agente
Olá, quero comprar um smartphone
	Temos o Google Pixel 8 e o Google Pixel 7. Qual você quer comprar?
me dê dois dos oito
	Isso mesmo! Adicionei dois smartphones Google Pixel 8 ao seu carrinho. Mais alguma coisa?
na verdade, você pode remover um deles?
	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
	Certo, agradecemos por fazer compras 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 procurar 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 fazer compras com o Google. Tenha um bom dia.

Entrada não reconhecida

O usuário faz uma pergunta sobre um assunto não relacionado a produtos ou pedidos. O agente responde repetindo os temas que ele aborda e pergunta ao usuário com o que ele gostaria 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 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

Para configurar esse agente pré-criado:

1. Importe o agente pré-criado.
2. Configure as ferramentas fornecidas com seus serviços externos. Consulte Configuração de ferramentas.

Configuração da ferramenta

Esse agente inclui ferramentas usadas para integração com serviços externos. É possível usar o instalador de ferramentas pré-criado para implantar código e dados de amostra para seu agente pré-criado.

Para implantar e configurar o código e os dados de exemplo do agente pré-criado do 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 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 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 Vertex AI Agent Builder

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

      Console do Vertex AI Agent Builder

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

Google Store API

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

Gerenciar carrinho de compras

Com a ferramenta Manage Shopping Cart, o usuário pode gerenciar o carrinho de compras visualizando, adicionando e removendo itens.

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 agora estão configurados e prontos para teste.