O assistente de compras agente pré-criado baseado em guião fornece consultas de produtos de retalho, encomendas, estado das encomendas e cancelamento de encomendas. Usa a Vertex AI Search for Retail e payloads de processamento personalizados, oferecendo uma experiência visual interativa.
Exemplos de caixas de diálogo
As caixas de diálogo de exemplo seguintes demonstram cenários comuns processados por este agente pré-criado.
Comparação de produtos e críticas
O utilizador pede para procurar saris tradicionais. O agente apresenta algumas opções populares e o utilizador seleciona a primeira. O utilizador pede sapatos a condizer. O agente apresenta opções populares e o utilizador pede para comparar críticas e seleciona a opção com a classificação mais alta. O agente pergunta acerca do tamanho e confirma que os sapatos foram adicionados ao carrinho.
| Introdução do utilizador | Resposta do agente |
|---|---|
| mostra-me saris tradicionais | |
| [Apresenta produtos] Algum destes produtos lhe interessa ou procura outras opções? | |
| O primeiro tem bom aspeto | |
| Ótima escolha! O sari indiano Self Design, Printed Fashion Georgette é uma peça elegante. Uma vez que os saris são normalmente de tamanho único, vão ficar-lhe perfeitamente. Quer adicioná-lo ao carrinho? | |
| do you have a matching heels with it? | |
| [Apresenta produtos] Algum destes produtos lhe interessa ou procura outras opções? | |
| Sim, mas pode analisar a crítica do cliente e escolher a melhor entre estas | |
| Os sapatos de salto alto para mulher Flat n Heels têm uma classificação média de 4 em 5 estrelas, enquanto os sapatos de salto alto para mulher Glitzy Galz têm uma classificação média de 4,5 em 5 estrelas. Os clientes que compraram os sapatos de salto alto Flat n Heels Women Heels tiveram críticas mistas. Alguns consideraram-nos confortáveis no início, mas desconfortáveis após algumas horas, enquanto outros elogiaram o conforto. Por outro lado, os sapatos de salto alto Glitzy Galz Women Heels receberam críticas maioritariamente positivas, com os clientes a elogiarem o ajuste, a qualidade e o design. Qual quer adicionar ao carrinho? | |
| qualquer um que tenha a melhor crítica e classificações | |
| Os sapatos de salto alto para mulher Glitzy Galz têm a classificação mais elevada, de 4,5 em 5 estrelas. Que tamanho quer para os sapatos de salto alto Glitzy Galz para mulher? Temos tamanhos que variam entre 5 e 11. | |
| 6 | |
| Perfeito! Os sapatos de salto alto para mulher da marca Glitzy Galz no tamanho 6 foram adicionados ao seu carrinho com a quantidade 1. Quer adicionar mais alguma coisa ao seu carrinho? |
Experiência de compras completa
O utilizador procura no catálogo de produtos. O agente apresenta recomendações com base no pedido do utilizador. Após algumas pesquisas, o utilizador encontra um artigo para comprar. O agente confirma o tamanho e a quantidade do artigo a comprar, bem como a data de entrega prevista. O utilizador pede uma data de entrega diferente, que não está disponível, e aceita a data de entrega original. O agente confirma as informações de entrega, pagamento e contacto registadas. O utilizador atualiza as informações de entrega e confirma. O agente faz a encomenda e fornece o número da encomenda ao utilizador.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Está a ficar frio. Tem camisolas boas | |
| [Presents products]. Algum destes produtos lhe interessa ou procura outras opções? | |
| Gosto da camisola de senhora para a minha esposa, mas procuro uma camisola de rapaz | |
| [Presents products]. Algum destes produtos lhe interessa ou procura outras opções? | |
| adiciona o primeiro camisola de mulher ao carrinho | |
| Que tamanho quer para o Nineteen Solid Round Neck Casual Women's Sweater? Temos tamanhos que vão do extra pequeno ao extra grande. | |
| média | |
| Perfeito! O Nineteen Solid Round Neck Casual Women's Sweater no tamanho médio foi adicionado ao seu carrinho com a quantidade 1. Quer adicionar mais alguma coisa ao seu carrinho? | |
| não | |
| A data mais próxima em que podemos enviar-lhe o Nineteen Solid Round Neck Casual Women's Sweater é 29 de abril de 2024. Pode ser? | |
| podes entregá-lo a 28 de abril? | |
| Lamento, mas não é possível entregar o Nineteen Solid Round Neck Casual Women's Sweater a 28 de abril de 2024. A data mais próxima em que o podemos entregar é 29 de abril de 2024. | |
| OK, mantenha a data de entrega como está | |
| OK. O seu Nineteen Solid Round Neck Casual Women's Sweater vai ser entregue a 29 de abril de 2024. Agora, vamos rever os detalhes do seu perfil para garantir que tudo está atualizado:\ | |
| Morada de entrega: 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| Informações de pagamento: Visa com final 4111 Número de contacto: 416-555-5555 Email: email@example.com Reveja estes detalhes. Se tudo estiver correto, basta confirmar. Se precisar de fazer alterações, não hesite em contactar-me. |
|
| A minha morada foi alterada para 371 Talbot Street Carmichael, CA 95608 | |
| A sua morada de entrega foi atualizada com êxito para 371 Talbot Street, Carmichael, CA 95608. Gostaria de modificar mais alguma coisa? | |
| não | |
| A sua encomenda do Nineteen Solid Round Neck Casual Women's Sweater foi efetuada com êxito com o ID da encomenda ee6b4cc7. A entrega está agendada para 29 de abril de 2024. | |
| obrigado | |
| A sua encomenda foi efetuada com êxito! Em que mais posso ser útil? | |
| não | |
| Foi um prazer ajudar! Se precisar de algo da Cymbal Apparel, estou apenas a um clique de distância.\ |
Verificar o estado de uma encomenda
O utilizador pede para verificar o estado de uma encomenda. O agente recolhe o número da encomenda e obtém as informações da encomenda. O agente fornece detalhes sobre os artigos na encomenda, bem como o respetivo estado atual e data de entrega prevista.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Olá, | |
| Sinta-se à vontade para selecionar uma das opções acima ou simplesmente escrever o que procura. Eu posso ajudar. | |
| Quero verificar o estado da minha encomenda | |
| Claro, posso ajudar com isso. Para começar, pode indicar-me o ID da sua encomenda? | |
| ee6b4cc7 | |
| A sua encomenda foi confirmada! Está atualmente a ser processada. Segue o que encomendou: Nineteen Solid Round Neck Casual Women's Sweater Tamanho: M Quantidade: 1 Entrega estimada: 29 de abril de 2024 Precisa de mais alguma coisa? |
|
| Não | |
| Foi um prazer ajudar! Se precisar de algo da Cymbal Apparel, estou apenas a um clique de distância. |
Devolver uma encomenda
O utilizador quer devolver uma encomenda. O agente recolhe o número da encomenda, obtém os detalhes da encomenda e confirma o artigo a devolver. Em seguida, o agente inicia o processo de devolução e fornece uma etiqueta de devolução para o utilizador imprimir e fixar na embalagem.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Olá, | |
| Sinta-se à vontade para selecionar uma das opções acima ou simplesmente escrever o que procura. Eu posso ajudar. | |
| Quero devolver a minha encomenda | |
| Estou aqui para ajudar com a devolução. Para começar, pode partilhar o número da encomenda comigo? | |
| 0fc77d64 | |
| Agradecemos o número da encomenda. Encontrei a sua encomenda feita a 12 de abril de 2024. A encomenda contém uma t-shirt de manga curta azul escura com gola redonda para rapaz da YK Printed no tamanho pequeno. É este o artigo que quer devolver? | |
| sim | |
| Muito bem, iniciei o processo de devolução. Encontra a etiqueta de devolução anexada abaixo. Imprima-a e anexe-a à embalagem antes de a devolver. Em que mais posso ser útil? | |
| Não | |
| Foi um prazer ajudar! Se precisar de algo da Cymbal Apparel, estou apenas a um clique de distância. |
Configuração básica
Para configurar este agente pré-criado:
- Importe o agente pré-criado.
- 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. Para configurar estas ferramentas, siga estes passos:
- Crie uma
base de dados do Firestore
com o nome
apparel-db. - Crie um conetor de integração do Firestore.
- Transfira a solução Application Integration para o Shopping Assistant.
- Substitua todas as referências a
projects/customermod-genai-sa/locations/us-central1/connections/firestorepelo identificador do conector criado no passo 2. - Carregue e publique a integração.
- Conceda as funções
Cloud Functions Invokerao agente de serviço do Dialogflow. - Siga os passos para configurar o catálogo de retalho
- Atualize os controlos de atributos para tornar os seguintes campos recuperáveis: ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title e uri.
- Importe o catálogo de amostras para a ramificação 1 do seu catálogo e torne-a na ramificação predefinida.
- Transfira a função do Cloud Run disponível
aqui
e atualize
config.toml. - Siga os passos para implementar a função do Cloud Run.
- Conceda a função de IAM
Retail Viewerà função do Cloud Run que implementou. - Para as seguintes ferramentas:
get-order-status,order-lookup,place-orderereturn-order, atualize a propriedadepathspara referenciar a integração que criou no passo 5 nas especificações da OpenAPI e escolha Autenticação da conta de serviço com uma conta de serviço à qual concede a funçãoApplication Integration Invoker. - Atualize a propriedade do URL do servidor para a função do Cloud Run que implementou para as restantes ferramentas.
Pesquisa de produtos
A ferramenta search-products extrai os produtos com a melhor correspondência com base na consulta de pesquisa e no valor de deslocamento do catálogo de produtos.
A ferramenta devolve uma resposta de payload personalizada que inclui detalhes do produto.
Este payload personalizado é usado pela IU para apresentar os produtos sob a forma de conteúdo multimédia.
Detalhes do produto
A ferramenta get-product-details extrai detalhes dos produtos do catálogo de produtos
através da API Retail.
Os detalhes dos produtos obtidos são, em seguida, transformados e devolvidos
num formato simplificado,
usado pelo agente para responder a perguntas sobre os produtos que apresentou ao utilizador
Críticas sobre produtos
A ferramenta get-reviews é usada para obter críticas sobre produtos.
Espera uma lista de produtos apresentados e obtém críticas para cada produto.
As críticas geradas são transformadas num formato de modelo personalizado (review_template)
adequado para apresentação numa interface do utilizador avançada.
Produtos semelhantes
A ferramenta similar-productsfacilita a descoberta de produtos
semelhantes a um produto especificado através da API Retail Recommendation.
Aceita um ID do produto e usa a API Retail Recommendation para prever produtos semelhantes do catálogo de produtos.
Data de entrega
A ferramenta store-delivery-date é responsável por armazenar a data de entrega preferencial do utilizador para os artigos no carrinho de compras, que deve ser comparada com a data de entrega estimada mais antiga.
A ferramenta get-delivery-date é responsável por calcular a data de entrega dos artigos no carrinho de compras.
Detalhes do utilizador
A ferramenta get-user-info obtém as informações pessoais do utilizador, incluindo a morada de envio, as informações de pagamento, o número de telefone e o email, enquanto a ferramenta update-user-info é responsável por atualizar as informações do utilizador.
Gestão de encomendas
A ferramenta place-order processa a colocação de uma encomenda dos artigos no carrinho de compras.
Armazena a encomenda no Firestore com os dados da encomenda, que incluem o ID da encomenda, o estado, a data/hora de criação e a lista de produtos.
Devolve o número da encomenda ao agente.
A ferramenta order-lookup extrai dados de encomendas de uma base de dados do Firestore com base no ID da encomenda fornecido.
A ferramenta return-order atualiza o estado de uma encomenda para "return_pending" na base de dados do Firestore,
indicando que a devolução foi iniciada pelo cliente
e que a encomenda está pendente de devolução.
A ferramenta get-order-status é responsável
por obter o estado de uma encomenda e, se a encomenda tiver sido enviada,
monitorizá-la através da API DHL.
Envia mensagens adequadas com base no estado da encomenda.
Concluído
O seu agente e as respetivas integrações devem estar configurados e prontos para teste.