Cas d'usage

Cas d'usage de Jev

Huit corps de requête complets, prêts à coller dans le playground ou à adapter dans votre code. Chacun envoie un état plus des questions typées à /api/v1/decisions et reçoit un Noul, un Choice ou un Score sur lequel brancher — un crédit par appel réussi.

Mis à jour

Router un paiement vide

Utilisez un Choice comme celui-ci pour envoyer chaque ticket entrant vers l'une de vos files. La réponse nomme l'équipe et porte une probabilité par option, donc un cas serré peut revenir à un humain plutôt qu'à la mauvaise file.

Choice renvoie l’équipe et la probabilité de chacune.

{
  "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."
      }
    }
  }
}
Ouvrir cette requête dans le playground

Est-ce une demande de remboursement ?

Un Noul est la bonne forme quand la question est binaire — ce message demande-t-il un remboursement ? Contrôlez une macro de remboursement ou une file de révision sur la valeur noul plutôt que d'analyser du texte généré.

Noul renvoie une probabilité de oui, pas un paragraphe.

{
  "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?"
    }
  }
}
Ouvrir cette requête dans le playground

Quelle urgence pour l’échec de versement

Score convient au jugement ordonné. Définissez vos propres niveaux — ici une échelle d'urgence à trois crans — et utilisez le score fractionnaire pour trier un backlog au lieu de lire des étiquettes à la main.

Score place la note sur votre échelle et renvoie la distribution.

{
  "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"
      ]
    }
  }
}
Ouvrir cette requête dans le playground

Demande d’identifiants dans un message

Placez un Noul devant votre file de révision humaine comme préfiltre. Les messages demandant des identifiants sont signalés par probabilité ; la probabilité du second indique combien faire confiance à la porte.

La probabilité Noul est le filtre avant la revue humaine.

{
  "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?"
    }
  }
}
Ouvrir cette requête dans le playground

Qualifier une note entrante

Choice sépare l'intention d'achat dans les cases que votre process commercial possède déjà — ready, nurture, ignore — pour que les règles de routage restent explicables et que chaque option garde sa probabilité.

Choice sépare une fenêtre d’achat d’un simple intérêt.

{
  "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."
      }
    }
  }
}
Ouvrir cette requête dans le playground

Annonce à rendement garanti

Noul convient aux vérifications de politique où la règle est écrite en langage clair. L'annonce promet un retour garanti ou non — la probabilité est votre signal d'application.

Noul répond à la question de politique que vous avez écrite.

{
  "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?"
    }
  }
}
Ouvrir cette requête dans le playground

Risque de renouvellement dans une note

Notez le risque de renouvellement sur votre propre échelle plutôt que sur le sentiment d'un fournisseur. Comme les niveaux sont les vôtres, le score fractionnaire correspond directement à l'étape du playbook que vous exécutez déjà.

Score utilise vos trois niveaux, d’improbable à annulation probable.

{
  "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"
      ]
    }
  }
}
Ouvrir cette requête dans le playground

Quelle exception de facture

Un Choice avec une option 'both' attrape les exceptions composées sans second appel. La comptabilité fournisseurs reçoit le type d'exception plus les probabilités par option pour router le litige.

Choice peut marquer un dépassement, une ligne imprévue, ou les deux.

{
  "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."
      }
    }
  }
}
Ouvrir cette requête dans le playground

Des patterns qui se composent

Les exemples ci-dessus sont des appels uniques. La documentation de TypeSafe décrit quelques patterns pour les combiner :

  • Routage à seuil de confidence — n'agissez automatiquement que quand la confiance dépasse votre barre, et envoyez le reste à une personne.
  • Fan-out spéculatif — posez la même question avec des options de Choice réordonnées ou un état réduit, et comparez la cohérence des réponses.
  • Garde-fous — exécutez un Noul sur l'entrée utilisateur avant qu'elle n'atteigne un modèle génératif ou une action de production.
  • Filtrage de passages RAG — utilisez un Noul ou un Score par passage candidat pour ne garder que le contexte pertinent avant la génération.

FAQ

Combien coûte l'exécution de chaque exemple ?

Chaque requête est un appel à /api/v1/decisions, donc une exécution réussie utilise 1 crédit quel que soit le nombre de questions. Les erreurs de validation et les échecs sont gratuits.

Puis-je poser plusieurs de ces questions à la fois ?

Oui — questions est une map, donc un Choice de routage, un Noul de remboursement et un Score d'urgence peuvent partager un même état en un seul appel et ne coûter qu'1 crédit.

Comment exécuter cela depuis le code plutôt que le playground ?

POSTez le même corps JSON vers https://jev-api.org/api/v1/decisions avec une clé Bearer, ou utilisez le SDK TypeSafe pointé vers https://jev-api.org via /v1/systemone.

Que signifie confidence dans les réponses ?

Les réponses Choice et Score portent un confidence dérivé de la distribution de probabilité — une confiance faible ou deux options proches indiquent une décision limite, candidate à une revue humaine.

Exécutez-en un maintenant

Chaque requête ci-dessus s'ouvre préremplie dans le playground. Ajoutez un petit pack de crédits à l'unité sur la page des tarifs, connectez-vous et lancez-la — les appels échoués n'utilisent aucun crédit.