O assistente de compras agente predefinido baseado no playbook oferece consultas de produtos de varejo, pedidos, status do pedido e cancelamento de pedidos. Ele usa a Vertex AI para Pesquisa para varejo e payloads de fulfillment personalizados, oferecendo uma experiência visual rica.
Exemplos de diálogos
Os exemplos de diálogos a seguir demonstram cenários comuns gerenciados por esse agente pré-criado.
Comparação de produtos e avaliações
O usuário pede para navegar por saris tradicionais. O agente apresenta algumas opções populares e o usuário seleciona a primeira. O usuário pede sapatos combinando. O agente apresenta opções populares e o usuário pede para comparar as avaliações e seleciona a opção com a classificação mais alta. O agente pergunta sobre o tamanho e confirma que os sapatos foram adicionados ao carrinho.
| Entrada do usuário | Resposta do agente |
|---|---|
| mostrar saris tradicionais | |
| [Presents products] Você tem interesse em algum desses produtos ou prefere outras opções? | |
| A primeira parece boa | |
| Ótima escolha! O sari de Georgette com design indiano e estampa de moda é uma peça linda. Como os saris geralmente são de um tamanho, ele vai servir perfeitamente. Quer adicionar o item ao seu carrinho? | |
| Você tem sapatos de salto que combinem com ele? | |
| [Presents products] Você tem interesse em algum desses produtos ou prefere outras opções? | |
| Sim, mas você pode analisar a avaliação do cliente e escolher a melhor entre estas | |
| O Flat n Heels Women Heels tem uma classificação média de 4 de 5 estrelas, enquanto o Glitzy Galz Women Heels tem uma classificação média de 4,5 de 5 estrelas. Os clientes que compraram os sapatos femininos da Flat n Heels fizeram avaliações variadas. Alguns acharam que os sapatos eram confortáveis no início, mas desconfortáveis depois de algumas horas, enquanto outros elogiaram o conforto. Já os sapatos de salto da Glitzy Galz receberam avaliações positivas, com os clientes elogiando o ajuste, a qualidade e o design. Qual você quer adicionar ao carrinho? | |
| a que tiver a melhor avaliação e classificação | |
| O Glitzy Galz Women Heels tem a classificação mais alta de 4,5 de 5 estrelas. Qual tamanho você quer para os sapatos de salto Glitzy Galz? Temos tamanhos que variam de 5 a 11. | |
| 6 | |
| Perfeito. O produto Glitzy Galz Women Heels no tamanho 36 foi adicionado ao seu carrinho com a quantidade 1. Você quer adicionar mais algum item ao carrinho? |
Experiência de compra completa
O usuário navega pelo catálogo de produtos. O agente apresenta recomendações com base na solicitação do usuário. Depois de algumas pesquisas, o usuário encontra um item para comprar. O agente confirma o tamanho e a quantidade do item a ser comprado, além da data de entrega esperada. O usuário solicita uma data de entrega diferente, que não está disponível, e aceita a data de entrega original. O agente confirma a entrega, o pagamento e as informações de contato em arquivo. O usuário atualiza as informações de entrega e confirma. O agente faz o pedido e informa o número do pedido ao usuário.
| Entrada do usuário | Resposta do agente |
|---|---|
| Está ficando frio. Você tem suéteres bons | |
| [Presents products]. Algum desses produtos chamou sua atenção ou você está procurando opções diferentes? | |
| Gosto do suéter feminino para minha esposa, mas estou procurando um suéter masculino | |
| [Presents products]. Algum desses produtos chamou sua atenção ou você está procurando opções diferentes? | |
| Adicionar o primeiro suéter feminino ao carrinho | |
| Qual tamanho você quer para o suéter feminino casual com gola redonda Nineteen? Temos tamanhos que variam de extrapequeno a extragrande. | |
| médio | |
| Perfeito. A blusa casual feminina Nineteen com gola redonda lisa e tamanho médio foi adicionada ao seu carrinho com a quantidade 1. Você quer adicionar mais algum item ao carrinho? | |
| não | |
| O suéter feminino casual com gola redonda e gola redonda Nineteen Solid só poderá ser enviado a partir de 29 de abril de 2024. Parece interessante? | |
| Você pode entregar no dia 28 de abril? | |
| Não é possível entregar o suéter casual feminino com gola redonda e gola redonda Nineteen Solid em 28 de abril de 2024. A entrega só será possível a partir de 29 de abril de 2024. | |
| Ok, mantenha a data de entrega como está | |
| Certo, seu suéter casual feminino com gola redonda e gola redonda Nineteen será entregue em 29 de abril de 2024. Agora, vamos revisar os detalhes do seu perfil para garantir que tudo esteja atualizado: | |
| Endereço de entrega: 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| Informações de pagamento: Visa que termina em 4111 Número de contato: 416-555-5555 E-mail: email@example.com Revise esses detalhes. Se tudo estiver correto, confirme. Se precisar fazer alguma mudança, entre em contato. |
|
| meu endereço mudou para 371 Talbot Street Carmichael, CA 95608 | |
| Seu endereço de entrega foi atualizado para 371 Talbot Street, Carmichael, CA 95608. Você quer modificar mais alguma coisa? | |
| não | |
| Seu pedido de suéter casual feminino com gola redonda e cor sólida Nineteen foi feito com o código de pedido ee6b4cc7. A entrega está programada para 29 de abril de 2024. | |
| agradecimentos | |
| Seu pedido foi feito. Posso ajudar com mais alguma coisa? | |
| Agora não | |
| Foi um prazer ajudar. Se precisar de algo da Cymbal Apparel, basta um clique.\ |
Como verificar o status de um pedido
O usuário solicita a verificação do status de um pedido. O agente coleta o número do pedido e recupera as informações dele. O agente fornece detalhes sobre os itens do pedido, bem como o status atual e a data de entrega prevista.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá, | |
| Escolha uma das opções acima ou digite o que você está procurando. Vou ajudar você. | |
| Quero verificar o status do meu pedido | |
| Claro. Posso ajudar você com isso. Para começar, você pode me informar o código do pedido? | |
| ee6b4cc7 | |
| Seu pedido foi confirmado! O pedido está sendo processado. Confira o que você pediu: Suéter casual feminino Nineteen liso de gola redonda Tamanho: M Quantidade: 1 Previsão de entrega: 29 de abril de 2024 Posso ajudar em algo mais? |
|
| Agora não | |
| Foi um prazer ajudar. Se precisar de algo da Cymbal Apparel, basta um clique. |
Como devolver um pedido
O usuário quer devolver um pedido. O agente coleta o número do pedido, recupera os detalhes do pedido e confirma o item a ser devolvido. Em seguida, o agente inicia o processo de devolução e fornece uma etiqueta para o usuário imprimir e anexar ao pacote.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá, | |
| Escolha uma das opções acima ou digite o que você está procurando. Vou ajudar você. | |
| Quero devolver meu pedido | |
| Estou aqui para ajudar você com sua declaração. Para começar, poderia me informar o número do pedido? | |
| 0fc77d64 | |
| Agradeço por informar o número do pedido. Encontrei seu pedido feito em 12 de abril de 2024. O pedido contém uma camiseta masculina azul-escuro com gola redonda e estampa YK no tamanho pequeno. É o item que você quer devolver? | |
| sim | |
| Certo, iniciei o processo de devolução. A etiqueta de devolução está anexada abaixo. Imprima e anexe ao pacote antes de enviar de volta. Posso ajudar com mais alguma coisa? | |
| Agora não | |
| Foi um prazer ajudar. Se precisar de algo da Cymbal Apparel, basta um clique. |
Configuração básica
Para configurar esse agente pré-criado:
- Importe o agente pré-criado.
- 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. Para configurar essas ferramentas, siga estas etapas:
- Crie um banco de dados do Firestore chamado
apparel-db. - Crie um conector de integração do Firestore.
- Faça o download da integração de aplicativos para o Shopping Assistant.
- Substitua todas as referências a
projects/customermod-genai-sa/locations/us-central1/connections/firestorepelo identificador do conector criado na etapa 2. - Faça o upload e publique a integração.
- Conceda o papel
Application Integration Invokerao seu agente de serviço do Dialogflow. - Atualize a propriedade
pathspara fazer referência à integração criada na etapa 5 nas especificações da OpenAPI das seguintes ferramentas:get-order-status,order-lookup,place-order,return-order
Google Shopping
A ferramenta search-products recupera os produtos mais bem correspondentes
com base na consulta de pesquisa e no valor de deslocamento do catálogo de produtos.
A ferramenta retorna uma resposta de payload personalizada que inclui detalhes do produto.
Esse payload personalizado é usado pela interface para
mostrar os produtos no formato de conteúdo avançado.
Detalhes do produto
A ferramenta get-product-details busca detalhes do produto no catálogo de produtos
usando a API Retail.
Os detalhes do produto recuperados são transformados e retornados
em um formato simplificado,
usado pelo agente para responder a perguntas sobre produtos que ele mostrou ao usuário.
Avaliações de produtos
A ferramenta get-reviews é usada para recuperar avaliações de produtos.
Ele espera uma lista de produtos mostrados e busca avaliações para cada um deles.
As avaliações geradas são transformadas em um modelo personalizado (review_template)
adequado para exibição em uma interface do usuário rica.
Produtos semelhantes
A ferramenta similar-products facilita a descoberta de produtos
semelhantes a um produto especificado usando a API Retail Recommendation.
Ela aceita um ID de produto e utiliza a API Retail Recommendation
para prever produtos semelhantes no catálogo.
Data de envio
A ferramenta store-delivery-date é responsável por armazenar a data de entrega
preferencial do usuário para itens no carrinho de compras, que precisa ser comparada à
data de entrega estimada mais cedo.
A ferramenta get-delivery-date é responsável por estimar a data de entrega dos
itens no carrinho de compras.
Detalhes do usuário
A ferramenta get-user-info recupera as informações pessoais do usuário,
incluindo endereço de entrega, informações de pagamento, número de telefone e e-mail,
enquanto a ferramenta "update-user-info" é responsável
por atualizar as informações do usuário.
Gerenciamento de pedidos
A ferramenta place-order processa o pedido dos itens do carrinho de compras.
Ele armazena o pedido no Firestore com os dados do pedido, que incluem o ID, o status, o carimbo de data/hora de criação e a lista de produtos.
Ele retorna o número do pedido para o agente.
A ferramenta order-lookup busca dados de pedidos de um banco de dados do Firestore com base no ID de pedido fornecido.
A ferramenta return-order atualiza o status de um pedido para "return_pending" no
banco de dados do Firestore,
indicando que a devolução foi iniciada pelo cliente
e que o pedido está pendente de devolução.
A ferramenta get-order-status é responsável
por buscar o status de um pedido e, se ele tiver sido enviado,
rastreá-lo usando a API DHL.
Ele fornece mensagens adequadas com base no status do pedido.
Concluído
Seu agente e as integrações dele estão configurados e prontos para testes.