O agente pré-criado baseado em playbook do Assistente de compras oferece consultas de produtos de varejo, pedidos, status do pedido e cancelamento de pedidos. Ele usa o Agent Search para varejo e payloads de fulfillment personalizados para oferecer uma experiência visual avançada.
Exemplo de diálogo
Este exemplo de diálogo mostra cenários comuns que esse agente pré-criado processa.
Comparação de produtos e avaliações
- O usuário pede para ver saris tradicionais.
- O agente apresenta algumas opções populares, e o usuário seleciona a primeira.
- O usuário pede sapatos que combinem.
- O agente apresenta algumas opções populares, e o usuário pede para comparar as avaliações e seleciona a opção com a melhor classificação.
- 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 | |
| [Apresenta os produtos] Algum desses produtos chamou sua atenção ou você está procurando outras opções? | |
| O primeiro está bom | |
| Ótima escolha! O sari de georgette estampado Indian Beauty Self Design é uma peça linda. Como os saris geralmente têm tamanho único, ele vai servir perfeitamente. Quer adicionar ao carrinho? | |
| Você tem um salto que combine com ele? | |
| [Apresenta os produtos] Algum desses produtos chamou sua atenção ou você está procurando outras opções? | |
| yes but can you go through the customer review and pick the best one from these | |
| O salto feminino da Flat n Heels tem uma classificação média de 4 de 5 estrelas, enquanto o salto feminino da Glitzy Galz tem uma classificação média de 4,5 de 5 estrelas. As avaliações das clientes que compraram o salto feminino Flat n Heels foram variadas. Algumas acharam o calçado confortável no início, mas desconfortável depois de algumas horas, enquanto outras elogiaram o conforto. Por outro lado, os sapatos de salto Glitzy Galz receberam avaliações positivas, com elogios ao ajuste, à qualidade e ao design. Qual deles você quer adicionar ao carrinho? | |
| o que tiver as melhores avaliações e classificações | |
| O salto feminino da Glitzy Galz tem a classificação mais alta, com 4,5 de 5 estrelas. Qual tamanho você quer para o salto alto feminino Glitzy Galz? Temos tamanhos de 35 a 41. | |
| 6 | |
| Perfeito. O salto feminino Glitzy Galz tamanho 36 foi adicionado ao seu carrinho com quantidade 1. Quer adicionar mais alguma coisa 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 e a data de entrega prevista.
- O usuário solicita uma data de entrega diferente, que não está disponível, e concorda com a data de entrega original.
- O agente confirma as informações de entrega, pagamento e contato registradas.
- O usuário atualiza as informações de entrega e confirma.
- O agente faz o pedido e fornece o número dele ao usuário.
| Entrada do usuário | Resposta do agente |
|---|---|
| Está ficando frio. Você tem suéteres bons? | |
| [Apresenta produtos]. Algum desses produtos chamou sua atenção ou você quer outras opções? | |
| Gostei do suéter feminino para minha esposa, mas estou procurando um suéter para menino | |
| [Apresenta produtos]. Algum desses produtos chamou sua atenção ou você quer outras opções? | |
| adicionar o primeiro suéter feminino ao carrinho | |
| Qual tamanho você quer do suéter casual feminino Nineteen Solid com gola redonda? Temos tamanhos que vão do extrapequeno ao extragrande. | |
| médio | |
| Perfeito. O suéter casual feminino Nineteen Solid com gola redonda no tamanho médio foi adicionado ao seu carrinho com quantidade 1. Quer adicionar mais alguma coisa ao carrinho? | |
| não | |
| O prazo mais rápido para entregar o suéter feminino casual Nineteen Solid com gola redonda é 29 de abril de 2024. Tudo bem por você? | |
| Você pode entregar em 28 de abril? | |
| Infelizmente, não será possível entregar o suéter casual feminino Nineteen Solid com gola redonda em 28 de abril de 2024. A data mais próxima para entrega é 29 de abril de 2024. | |
| ok, mantenha a data de entrega como está | |
| Certo, seu suéter casual feminino Nineteen Solid com gola redonda 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: Rua Maple, 638, Apt 11, Cupertino, CA 95014\ | |
| Informações de pagamento: Visa com final 4111 Número de contato: 416-555-5555 E-mail: email@example.com Revise esses detalhes. Se tudo estiver correto, basta confirmar. Se precisar fazer alguma mudança, me avise. |
|
| 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. Quer mudar mais alguma coisa? | |
| não | |
| Seu pedido do suéter casual feminino Nineteen Solid Round Neck foi registrado com o ID do pedido ee6b4cc7. A entrega está programada para 29 de abril de 2024. | |
| Agradecimentos | |
| Seu pedido foi registrado. Posso ajudar com mais alguma coisa? | |
| Agora não | |
| Foi um prazer ajudar! Se precisar de algo da Cymbal Apparel, é só me chamar.\ |
Verificar o status de um pedido
- O usuário pede para verificar o 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 e a data de entrega prevista.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá, | |
| Selecione uma das opções acima ou digite o que você está procurando para que eu possa ajudar. | |
| Quero conferir o status do meu pedido | |
| Claro. Posso ajudar você com isso. Para começar, informe o ID do pedido. | |
| ee6b4cc7 | |
| Seu pedido foi confirmado! Ele está sendo processado. Confira os detalhes do pedido: Suéter casual feminino Nineteen Solid com gola redonda Tamanho: M Quantidade: 1 Entrega estimada: 29 de abril de 2024 Posso ajudar com mais alguma coisa? |
|
| Agora não | |
| Foi um prazer ajudar! Se precisar de algo da Cymbal Apparel, é só me chamar. |
Devolver um pedido
- O usuário quer devolver um pedido.
- O agente coleta o número do pedido, recupera os detalhes dele e confirma o item a ser devolvido.
- O agente inicia o processo de devolução e fornece uma etiqueta de devolução para o usuário imprimir e anexar ao pacote.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá, | |
| Selecione uma das opções acima ou digite o que você está procurando para que eu possa ajudar. | |
| Quero devolver meu pedido | |
| Estou aqui para ajudar você com a devolução. Para começar, você poderia compartilhar o número do pedido comigo? | |
| 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 YK estampada de gola redonda azul-escura para meninos, tamanho pequeno. É esse o item que você quer devolver? | |
| sim | |
| Certo, já iniciei o processo de devolução. A etiqueta de devolução está anexada abaixo. Imprima e cole o rótulo no pacote antes de enviar. Posso ajudar com mais alguma coisa? | |
| Agora não | |
| Foi um prazer ajudar! Se precisar de algo da Cymbal Apparel, é só me chamar. |
Configuração básica
Para configurar esse agente pré-criado:
- Importe o agente pré-criado.
- Configure as ferramentas fornecidas com seus serviços externos. Para mais informações, consulte Configuração da ferramenta.
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 do Integration Connectors para o Firestore.
- Faça o download da Application Integration para o assistente de compras.
- Substitua todas as referências a
projects/customermod-genai-sa/locations/us-central1/connections/firestorepelo identificador do conector criado na etapa 2. - Faça upload e publique a integração.
- Conceda o papel
Cloud Functions Invokerao agente de serviço do Dialogflow. - Siga as etapas para configurar seu catálogo do Retail.
- Atualize os controles de atributos para que os seguintes campos possam ser recuperados: ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title, URI.
- Importe o catálogo de amostra para a ramificação 1 do seu catálogo e defina-a como a ramificação padrão.
- Faça o download da
função do Cloud Run e atualize
config.toml. - Siga as etapas para implantar a função do Cloud Run.
- Conceda o papel do IAM
Retail Viewerà função do Cloud Run que você implantou. - Para as seguintes ferramentas:
get-order-status,order-lookup,place-orderereturn-order, atualize a propriedadepathspara referenciar a integração criada na etapa 5 nas especificações da OpenAPI e escolha Autenticação da conta de serviço com uma conta de serviço que tenha o papelApplication Integration Invoker. - Atualize a propriedade do URL do servidor para a função do Cloud Run que você implantou para as ferramentas restantes.
Ferramenta Pesquisar Produtos
A ferramenta search-products recupera os produtos mais adequados com base na
consulta de pesquisa e no valor de deslocamento do catálogo de produtos. A ferramenta retorna uma
resposta de payload personalizado que inclui detalhes do produto. Esse payload personalizado é
usado pela UI para exibir os produtos em formato de conteúdo avançado.
Ferramenta "Receber detalhes do produto"
A ferramenta get-product-details busca detalhes do produto no catálogo de produtos
usando a API AI Commerce Search. Em seguida, o sistema transforma e retorna os
detalhes do produto recuperados em um formato simplificado, que o agente usa para responder
a perguntas sobre os produtos mostrados ao usuário.
Ferramenta para receber avaliações
A ferramenta get-reviews recupera avaliações de produtos. Ele espera uma lista de
produtos mostrados e busca avaliações para cada produto. As avaliações geradas
são transformadas em um formato de modelo personalizado (review_template) adequado para
exibição em uma interface do usuário avançada.
Ferramenta de 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 do produto
e usa a API Retail Recommendation para prever produtos semelhantes do
catálogo de produtos.
Ferramentas de data de entrega
A ferramenta store-delivery-date é responsável por armazenar a data de entrega preferida do usuário para os itens no carrinho de compras, que deve ser comparada com a data de entrega estimada mais próxima.
A ferramenta get-delivery-date estima a data de entrega dos itens no carrinho de compras.
Ferramenta Get User Info
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. A ferramenta update-user-info atualiza as informações do usuário.
Ferramenta de pedidos
A ferramenta place-order faz um pedido para os itens do carrinho de compras. Ele armazena os
dados do pedido no Firestore, incluindo o ID do pedido, o status, o carimbo de data/hora de criação
e a lista de produtos, e retorna o número do pedido ao agente.
Ferramenta de consulta de pedidos
A ferramenta order-lookup busca dados de pedidos em um banco de dados do Firestore usando o ID do pedido fornecido e retorna as informações do pedido para o agente.
Ferramenta de devolução de pedidos
A ferramenta return-order atualiza o status de um pedido para "return_pending" no
banco de dados do Firestore, indicando que uma devolução foi iniciada e está
pendente.
Ferramenta de status do pedido
A ferramenta get-order-status busca o status de um pedido e, se ele for enviado, o rastreia usando a API DHL. Ele fornece mensagens apropriadas com base no
status do pedido.
Concluído
Seu agente e as integrações dele já devem estar configurados e prontos para teste.