Casos de uso

Casos de uso do Jev

Oito corpos de requisição completos, prontos para colar no playground ou adaptar em código. Cada um envia um estado mais perguntas tipadas a /api/v1/decisions e recebe um Noul, Choice ou Score para ramificar — um crédito por chamada bem-sucedida.

Atualizado

Encaminhar um checkout em branco

Use um Choice assim para mandar cada ticket que chega para uma das suas filas. A resposta nomeia o time e traz uma probabilidade por opção, então um caso apertado pode ir para uma pessoa em vez da fila errada.

Choice devolve a equipe e a probabilidade de cada uma.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Abrir esta requisição no playground

É um pedido de reembolso?

Um Noul é a forma certa quando a pergunta é binária — essa mensagem pede dinheiro de volta? Controle uma macro de reembolso ou uma fila de revisão pelo valor noul em vez de analisar texto gerado.

Noul devolve a probabilidade de sim, não um parágrafo.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Abrir esta requisição no playground

Qual a urgência da falha de pagamento

Score serve para julgamento ordenado. Defina seus próprios níveis — aqui uma escala de urgência de três passos — e use o score fracionário para ordenar o backlog em vez de ler rótulos à mão.

Score posiciona na sua escala e devolve a distribuição.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Abrir esta requisição no playground

Pedido de credenciais numa mensagem

Rode um Noul na frente da fila de revisão humana como pré-filtro. Mensagens pedindo credenciais são sinalizadas por probabilidade; a probabilidade do vice diz o quanto confiar no portão.

A probabilidade Noul é a porta antes da revisão humana.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Abrir esta requisição no playground

Qualificar uma nota de entrada

Choice separa a intenção de compra nos baldes que seu processo de vendas já tem — ready, nurture, ignore — para que as regras de roteamento continuem explicáveis e cada opção mantenha sua probabilidade.

Choice separa uma janela de compra de um mero interesse.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Abrir esta requisição no playground

Anúncio de retorno garantido

Noul funciona para checagens de política onde a regra está escrita em linguagem simples. O anúncio promete retorno garantido ou não — a probabilidade é seu sinal de aplicação.

Noul responde à pergunta de política que você escreveu.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Abrir esta requisição no playground

Risco de renovação numa nota

Pontue o risco de renovação na sua própria escala em vez do sentiment de um fornecedor. Como os níveis são seus, o score fracionário mapeia direto para o passo do playbook que você já executa.

Score usa os seus três níveis, de improvável a provável cancelamento.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Abrir esta requisição no playground

Qual exceção de fatura

Um Choice com opção 'both' pega exceções compostas sem uma segunda chamada. Contas a pagar recebe o tipo de exceção mais as probabilidades por opção para rotear a disputa.

Choice pode marcar acima do pedido, uma linha inesperada ou ambas.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Abrir esta requisição no playground

Padrões que se combinam

Os exemplos acima são chamadas únicas. A documentação da TypeSafe descreve alguns padrões para combiná-los:

  • Roteamento com portão de confidence — aja automaticamente só quando a confiança passa do seu limite e mande o resto a uma pessoa.
  • Fan-out especulativo — faça a mesma pergunta com as opções do Choice reordenadas ou um estado enxugado e compare a consistência das respostas.
  • Guardrails — rode um Noul sobre a entrada do usuário antes que ela chegue a um modelo generativo ou a uma ação de produção.
  • Filtragem de passagens RAG — use um Noul ou Score por passagem candidata para manter só o contexto relevante antes da geração.

Perguntas frequentes

Quanto custa rodar cada exemplo?

Cada requisição é uma chamada a /api/v1/decisions, então uma execução bem-sucedida usa 1 crédito, não importa quantas perguntas carregue. Erros de validação e falhas do serviço são grátis.

Posso perguntar várias dessas de uma vez?

Sim — questions é um mapa, então um Choice de roteamento, um Noul de reembolso e um Score de urgência podem dividir um estado numa única chamada e ainda custar 1 crédito.

Como rodo isso em código em vez do playground?

Faça POST do mesmo corpo JSON para https://jev-api.org/api/v1/decisions com uma chave Bearer, ou use o SDK da TypeSafe apontado para https://jev-api.org via /v1/systemone.

O que significa confidence nas respostas?

Respostas Choice e Score trazem um confidence derivado da distribuição de probabilidade — confiança baixa ou duas opções próximas significam que a decisão foi apertada e é candidata a revisão humana.

Execute um agora

Cada requisição acima abre pré-preenchida no playground. Adicione um pequeno pacote de créditos avulso na página de preços, entre e execute — chamadas com falha não usam créditos.