Agente pré-criado de retalho

O agente pré-criado baseado em guião de retalho permite aos utilizadores pesquisar artigos, receber recomendações de produtos e fazer uma encomenda.

Exemplos de caixas de diálogo

Os exemplos de caixas de diálogo seguintes demonstram cenários comuns processados por este agente pré-criado.

Pesquise produtos e compre artigos

O utilizador pergunta sobre os relógios disponíveis na loja. O agente recomenda produtos que cumprem este critério e o utilizador adiciona-os ao carrinho de compras. O utilizador confirma que quer fazer uma encomenda e o agente confirma a encomenda com um número de confirmação. Em seguida, o utilizador pede recomendações de telemóveis e o agente sugere telemóveis, adiciona um ao carrinho do utilizador e faz uma encomenda para o utilizador.

Introdução do utilizador	Resposta do agente
hi
	Olá! Sou o seu assistente de compras do Google. Posso ajudar a pesquisar artigos e fazer encomendas. Em que posso ser útil?
que relógios tens
	Temos o Google Watch. Quer adicioná-lo ao carrinho?
sim, adiciona dois, por favor
	É isso mesmo. Adicionei dois relógios Google ao seu carrinho. Precisa de mais alguma coisa?
podes adicionar também um Google Pixel 8 ao meu carrinho?
	É isso mesmo. Adicionei um Google Pixel 8 ao seu carrinho. Precisa de mais alguma coisa?
o que está no meu carrinho?
	Tem um Google Pixel 8 e dois Google Watches no carrinho. Quer pagar?
sim por favor
	OK. Fiz uma encomenda com um Google Pixel 8 e dois Google Watches. O seu número de confirmação é QKA67DW2.
	Há mais alguma questão com que possa ajudar?
Na verdade, também me podes ajudar a encontrar um novo telemóvel?
	Temos o Google Phone Pixel 8 e o Google Phone Pixel 7. Gostaria de comprar um destes?
Sim, quero um Pixel 8
	É isso mesmo. Adicionei um Google Phone Pixel 8 ao seu carrinho. Precisa de mais alguma coisa?
Não, podemos fazer o check-out
	Tem um Google Pixel 8 no carrinho. Quer pagar com este carrinho?
sim
	OK, fiz uma encomenda em seu nome. A sua encomenda contém um telemóvel Google Pixel 8. O seu número de confirmação é Y43KTF0T.
	Há mais alguma questão com que possa ajudar?
não, da minha parte é tudo, obrigado
	OK, obrigado por fazer compras com a Google! Tenha um bom dia.

Gestão do carrinho

O utilizador pede para adicionar alguns artigos ao carrinho e, em seguida, remove um antes de fazer uma encomenda.

Introdução do utilizador	Resposta do agente
Olá, quero comprar um telemóvel
	Temos o telemóvel Google Pixel 8 e o telemóvel Google Pixel 7. Qual quer comprar?
dá-me dois dos 8
	É isso mesmo. Adicionei dois Google Phone Pixel 8 ao seu carrinho. Precisa de mais alguma coisa?
Na verdade, pode remover um deles?
	Claro, removi um Google Phone Pixel 8 do seu carrinho. Precisa de mais alguma coisa?
Quero fazer a minha encomenda
	OK. Fiz uma encomenda que contém um telemóvel Google Pixel 8. O seu número de confirmação é X0KP6K5T.
	Há mais alguma questão com que possa ajudar?
Não, é isso
	OK, obrigado por fazer compras com a Google! Tenha um bom dia.

Produto não encontrado

O utilizador pergunta sobre um produto que não é vendido pela loja.

Introdução do utilizador	Resposta do agente
hi
	Olá! Sou o seu assistente de compras do Google. Posso ajudar a pesquisar artigos e fazer encomendas. Em que posso ser útil?
Quero comprar um carro
	Lamentamos, mas não temos nenhum carro em stock. Quer encontrar mais alguma coisa?
Sim, e quanto aos relógios?
	Temos o Google Watch. Quer adicioná-lo ao carrinho?
não
	Há mais alguma questão com que possa ajudar?
não
	OK, obrigado por fazer compras com a Google! Tenha um bom dia.

Entrada não reconhecida

O utilizador pergunta sobre um tópico não relacionado com produtos ou encomendas. O agente responde repetindo os tópicos que aborda e pergunta ao utilizador em que gostaria de receber ajuda.

Introdução do utilizador	Resposta do agente
hi
	Olá! Sou o seu assistente de compras do Google. Posso ajudar a pesquisar artigos e fazer encomendas. Em que posso ser útil?
Quero reservar um hotel
	Lamento, mas não posso ajudar com esse pedido. Posso ajudar a pesquisar produtos, incluindo telemóveis, relógios e auscultadores. Também posso ajudar a fazer encomendas. Em que posso ser útil?

Configuração básica

Para configurar este agente pré-criado:

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

Configuração da ferramenta

Este agente inclui ferramentas que são usadas para a integração com serviços externos. Pode usar o instalador de ferramentas pré-criadas para implementar o exemplo de código e os dados do seu agente pré-criado.

Para implementar e configurar o código e os dados de exemplo para o agente pré-criado Retail, expanda para ver as instruções.

1. Transfira o instalador da ferramenta pré-criada para um diretório local.
2. Navegue para o diretório local onde transferiu installer.zip.
3. Descomprima o ficheiro installer.zip e abra a pasta installer.
4. Reveja o ficheiro README.md para ver uma vista geral detalhada do instalador e dos respetivos requisitos.
5. Execute pip install -r requirements.txt para instalar os requisitos.
6. Execute gcloud auth application-default login para fazer a autenticação através de gcloud auth.
7. Execute o instalador através de python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail
8. Depois de implementar todos os serviços necessários, configure cada ferramenta no agente pré-criado com os URLs fornecidos registados pelo instalador:

   Consola do Vertex AI Agent Builder

   1. Se ainda não importou o agente pré-criado, importe o agente para o seu projeto.
   2. Aceda à consola do Vertex AI Agent Builder.

      Consola do Vertex AI Agent Builder

   3. Selecione o seu projeto no menu pendente da consola.
   4. Selecione a app.
   5. Clique no ícone de ferramentas.
   6. Para cada ferramenta no agente, edite o esquema para substituir o URL no campo servers: pelo ponto final registado pelo instalador.
   7. Clique em Guardar.

   Dialogflow CX

   1. Se ainda não importou o agente pré-criado, importe o agente para o seu projeto.
   2. Abra a consola do Dialogflow CX.
   3. Escolha o seu projeto do Google Cloud.
   4. Selecione o 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 ponto final registado pelo instalador.
   8. Clique em Guardar.
9. Conceda à conta de serviço do Compute Engine (your-project-number-developer.gserviceaccount.com) a função de utilizador do Cloud Datastore, para que as funções do Cloud Run implementadas recentemente possam aceder ao Firestore.

Google Store API

A ferramenta Google Store API é usada para obter itens da Google Store com base num termo de pesquisa.

Faça a gestão do carrinho de compras

A ferramenta Manage Shopping Cart permite que o utilizador faça a gestão do carrinho de compras através da visualização de todos os artigos no carrinho, da adição de artigos ao carrinho e da remoção de artigos do carrinho.

Encomendar

A ferramenta Place Order é usada para fazer uma encomenda com o carrinho de compras atual do utilizador e devolve um número de confirmação da encomenda feita.

Concluído

O seu agente e as respetivas integrações devem estar configurados e prontos para teste.