Essence — Automação de Vendas (Varejo)

Essence é um projeto de referência para o setor de varejo, demonstrando automação do processo de vendas para Consultoras via WhatsApp com RAG, processamento de imagem, áudio e geração de link de pagamento.

WhatsApp: +55 11 96193-9803
Handler: essence
Repositório: https://bitbucket.org/ciandt_it/copilot-essence-flow


Demonstração


Fluxos Implementados

Registro de Nova Venda

Jornada principal: Consultora registrando uma venda via WhatsApp, da coleta de dados do cliente até a geração do link de pagamento.

  1. Início — Consultora expressa intenção de registrar uma venda. O ExtractIntentAgent identifica e inicia o fluxo.
  2. Coleta do clienteCustomerValidationAgent valida o telefone e verifica ou cria o cliente no sistema.
  3. Produtos — Consultora informa produtos por código, nome ou descrição. ProductAgent valida disponibilidade e preços.
  4. Imagem e áudioImageDescriptionAgent analisa fotos de catálogos. AudioTranscriptionAgent transcreve mensagens de voz com pontuação de confiança.
  5. Validação do pedidoOrderValidationAgent consolida itens, calcula totais e apresenta resumo para confirmação.
  6. PagamentoPaymentValidationAgent oferece Pix ou cartão (1x a 12x). Consultora escolhe quem absorve a taxa de parcelamento.
  7. ConfirmaçãoOrderConfirmationAgent finaliza o pedido e envia o link de pagamento.

Dúvidas (RAG)

Consultora solicita informações sobre produtos, políticas ou procedimentos. O GeneralAgent recupera conteúdo relevante da base de conhecimento no Strapi CMS via SimpleRAGAgent.

Relatórios

Consultora solicita relatórios de vendas (diário, semanal, mensal). O ReportAgent gera e envia diretamente no chat.


Tecnologia

Estruturação dos agentes

Dois executores principais:

  • ChatExecutor — orquestra 15 agentes especializados para texto, áudio e imagem
  • SimpleRAGAgent — pipeline dedicado à recuperação de conteúdo do Strapi CMS

Configuração do ChatExecutor: https://bitbucket.org/ciandt_it/copilot-essence-flow/src/main/copilot_essence_flow/application/commands/executors/chat_executor.py

Guardrails

  • Filtro de toxicidade na entrada e saída
  • Detecção de vazamento de credenciais
  • Proteção contra jailbreak
  • Validador de conformidade de escopo

Relatório dos agentes

https://agents-dev.infinity-copilot.com/?user_identifier=&source=essence&thread_id=


Testes Exploratórios

max_iterations: 30
instructions: |
  Você está atuando como uma Consultora da Essence. Seu objetivo é testar um bot que tem como função ajudar a registrar uma venda, coletar dados do cliente, escolher produtos e finalizar a compra.
  Seja criativo e tente explorar diferentes caminhos na conversa para alcançar o objetivo.
  Para um pedido ser fechado com sucesso, três conjuntos de informações são essenciais: detalhes do cliente, produtos a serem adquiridos e forma de pagamento. Certifique-se de que o bot solicite e utilize essas informações corretamente durante a conversa.
  Serão informados dados que você pode usar para alcançar o objetivo.

  Explore o máximo possível e não hesite em fazer perguntas adicionais ou solicitar esclarecimentos ao bot, se necessário.
  Você também tem liberdade de errar para testar a robustez do bot.
  Utilize também seu conhecimento sobre processos de compra online para conduzir a conversa de forma eficaz.
  Faça perguntas sobre os pontos que não podem ser mencionados durante a conversa.
data: |
  Dados que você pode usar:
  1. Sobre o cliente:
  - Nome: Maria Silva
  - Telefone: (11) 91234-5678

  2. Os produtos Essence que devem ser adquiridos são:
  - 1 item Perfume Essence Clássico Feminino 90ml código 10001 - R$ 250,00 cada
  - 2 itens Hidratante Corporal Essence Intenso 200ml código 10042 - R$ 150,00 cada

  3. Formas de pagamento disponíveis:
  - Pix
  - Cartão de crédito, parcelado de 1x a 12x e a taxa pode ser paga pelo cliente ou por você (consultora).
goal: |
  Seu objetivo é criar um pedido para o cliente, informar o método de pagamento e receber a confirmação do pedido gerado.
  Isso só vai acontecer depois de ter sido solicitado o meio de pagamento e informado o meio de pagamento.

  As condições de parada são:
    1. Fechar o pedido com sucesso, quando receber a confirmação do pedido com o link de pagamento gerado.
    Nesse caso, deve ser objetivo alcançado com sucesso.

    2. Encontrar algum problema ou algum erro crítico, exemplos:
    - Bot alucinando informações.
    - Erros de quantidades nos produtos solicitados.
    - Trazer informações fora do contexto.
    - Parecer que o bot travou ou repetir mensagens.
    Nesse caso, considere o objetivo alcançado sem sucesso.
first_user_message: "Olá, gostaria de registrar uma nova venda."
temperature: 0.8
copilot-infinity-tester tests/infinity-tester/exploratory.yml 1 1

Testes Manuais e Demonstrações

Para apagar o histórico da consultora, acesse a conversa no backoffice e clique em Clear User Data.