Jev: o classificador do agente

O Jev é um modelo que decide, mas não escreve. Você faz perguntas sobre a conversa e ele responde com uma escolha e a certeza de cada opção, em porcentagem.

Um exemplo: o cliente escreve "já paguei, cadê meu pacote?" e você pergunta ao Jev "qual é o pedido principal?". Ele pode responder algo como:

• rastreio com 93%
• ja_paguei com 5%
• outro com 2%

O Jev é rápido e barato. Por isso ele serve para classificar mensagens antes do agente responder.

O Jev pode trabalhar no atendimento do WhatsApp de dois jeitos: observando (modo shadow) ou escolhendo o caminho de cada mensagem (modo route). Veja a seção 5.

Onde fica

Abra o agente e clique na aba Jev, ao lado de Aprendizados e Guardrails. Ela aparece nos agentes VoltAgent e tem seis partes:

Depois de mudar qualquer coisa, clique em Salvar, no topo da tela.

1. Ligar e escolher o modelo

1. Na parte Configuração, ligue Ativar Jev neste agente.
2. Em Modelo do Jev, escolha um modelo.

Cada modelo usa um provedor, como TypeSafe, Vercel ou OpenRouter. Para trocar de provedor, basta escolher outro modelo.

Pode acontecer de não aparecer nenhum modelo, ou de o modelo mostrar "sem chave" ou "sem endpoint". Nesses casos, fale com o time da plataforma: os modelos e as chaves são cadastrados por eles.

2. Criar as perguntas

Cada pergunta tem:

• uma chave, que é o nome curto dela, em letras minúsculas e sem espaços (ex.: intencao);
• a pergunta em si (ex.: "Qual é o pedido principal das mensagens novas do cliente?");
• um tipo:

O segredo está na descrição das opções. O Jev decide lendo as descrições. Então escreva cada uma como você explicaria a uma pessoa. Por exemplo, para a opção rastreio: "quer saber onde está o pacote, status, atraso ou quando chega".

Por que existe a opção "Outro"

Toda pergunta de Escolha tem a opção outro, e ela não pode ser removida. O Jev sempre escolhe alguma opção da lista. Sem "outro", uma mensagem que não se encaixa em nada ia parar na opção "menos errada".

Atalho: importar um JSON pronto

O botão Importar / Exportar serve para duas coisas:

• copiar as perguntas e o state deste agente, para usar em outro;
• colar um conjunto pronto.

3. Escolher o que o Jev lê (State)

O Jev não lê o prompt do agente. Ele lê só um resumo da conversa, que você monta assim:

• Descrição do atendimento: uma frase dizendo do que se trata a conversa.
• Instruções livres: qualquer orientação extra (ex.: "classifique só as mensagens novas").
• Histórico da thread: liga ou desliga as mensagens anteriores e define quantas mensagens entram, de 1 a 200.
• Separar mensagens novas: as "mensagens novas" são tudo o que o cliente mandou desde a última resposta do agente. É isso que as perguntas devem classificar.
• Informações extras: textos fixos, como "empresa: UPS Brasil".
• Campos do contexto e da memória: dados que o sistema já guarda da conversa (ex.: se o pacote já foi pago).

Para ver o resultado, escolha uma conversa em Prévia do state e clique em Gerar prévia. Você vê exatamente o que o Jev vai ler e o tamanho em tokens. O limite é 32.000. A prévia não tem custo.

4. Testar

Na parte Testar, escolha uma das duas formas:

• Conversa simulada: você escreve o histórico, as mensagens novas do cliente e, se quiser, um botão clicado ou dados de memória.
• Thread real: você busca uma conversa do agente pelo nome, pelo telefone ou pelo ID.

Depois, clique em Testar. O resultado mostra:

• uma barra para cada opção, com a certeza em porcentagem;
• a versão do modelo, o tempo de resposta e os tokens;
• quanto o teste custou.

Os testes ficam salvos no agente (os 20 mais recentes), na lista "Testes salvos". Clique em um para rever as respostas, o modelo, o custo e o que o Jev leu. O botão Limpar apaga o histórico.

Como ler as barras: 90% ou mais é uma decisão clara. Duas opções parecidas, como 52% e 46%, são um empate: melhore as descrições dessas opções.

5. Usar no atendimento do WhatsApp

Pense no Jev como uma recepcionista: antes do agente responder, ela lê as mensagens novas do cliente e diz qual é o assunto. Você decide o que acontece em cada assunto.

Se o cliente mandar várias mensagens seguidas, o Jev lê todas juntas, como uma só vez.

Passo 1: configurar as rotas

Na parte Rotas:

1. Escolha a pergunta de roteamento: uma pergunta de escolha, como "qual é o pedido principal?". Cada opção dela vira uma rota.
2. Escreva o prompt base: as regras que valem para todas as rotas, como o jeito de falar.
3. Para cada rota, escolha a ação:

Cada rota tem uma confiança mínima. Se o Jev tiver menos certeza que isso, a mensagem vai para o agente padrão. A opção outro e as fotos ou áudios sem texto também vão sempre para o agente padrão.

Clique em Salvar rotas.

Passo 2: escolher o modo

Na parte Configuração, em Modo no atendimento:

• Desligado: o Jev só roda no botão Testar.
• Shadow (observar): o agente responde como sempre. O Jev só anota o que teria feito. Use para conferir se ele acerta, sem risco para o cliente.
• Route (rotear): o Jev escolhe a rota e a ação dela acontece de verdade.

Comece pelo Shadow. Quando o Histórico mostrar que o Jev acerta, mude para Route.

Passo 3: acompanhar no Histórico

A parte Histórico mostra cada vez que o Jev trabalhou numa conversa:

• quando foi e em qual modo;
• a rota escolhida e a certeza;
• a ação e o resultado: executada, foi ao padrão (com o motivo), só registrada (shadow) ou falhou;
• quantas mensagens do cliente ele leu e quantas respostas saíram;
• um link para abrir a conversa.

Você pode filtrar por modo e por rota.

Quanto custa

Cada teste é uma chamada real e é cobrado na carteira do workspace. O valor é muito pequeno, frações de centavo de dólar por teste. A prévia do state não é cobrada.

No shadow e no route, cada vez que o Jev lê as mensagens de uma conversa também é cobrado, com o mesmo valor pequeno. O texto fixo não gasta com a IA do agente.

Quem pode usar

• Qualquer pessoa que vê o agente pode ver a configuração.
• Salvar, testar, configurar as rotas e mudar o modo exige a permissão Gerenciar agentes.