TypeSafe Decisions

Utilisez Jev pour évaluer des conditions, classifier, noter et sélectionner des outils.

Decisions utilise Jev pour évaluer du texte ou un état métier et renvoie des réponses directement exploitables dans le code. L'API renvoie du JSON de manière synchrone et ne prend pas en charge le streaming.

POST/v1/decisions

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez une API Key délivrée par le site actuel.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

Identifiant d'un modèle de décision accessible sur le site actuel.

state*string||array<unknown>

Contenu ou état métier à évaluer. Toutes les questions d'une requête partagent le même state.

questions*

Table de questions non vide. Chaque clé est un identifiant de question personnalisé ; les réponses utilisent les mêmes identifiants.

Champs1 <= properties

stream?false

Omettre ou définir sur false. Cette API ne prend pas en charge stream: true.

Valeurs autorisées

false

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/decisions" \  -H "Authorization: Bearer your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "jev-1.13.0",    "state": "My subscription was charged twice. Please refund the duplicate charge.",    "questions": {      "ticket": {        "type": "noul",        "instructions": "Does the customer explicitly request a refund?",        "criteria": {          "true": "The message explicitly asks for a refund.",          "false": "The message does not ask for a refund."        }      }    }  }'

{
  "model": "jev-1.13.0",
  "answers": {
    "ticket": {
      "type": "noul",
      "noul": 0.99
    }
  },
  "usage": {
    "input_tokens": 319,
    "output_tokens": 20
  }
}

Exemples de requêtes

Les exemples suivants utilisent jev-1.13.0. Sélectionnez un scénario de question et un langage pour copier la requête correspondante.

Déterminer si un remboursement est demandé

curl --request POST 'https://api.agtcloud.cn/v1/decisions' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "jev-1.13.0",
  "state": "My subscription was charged twice. Please refund the duplicate charge.",
  "questions": {
    "ticket": {
      "type": "noul",
      "instructions": "Does the customer explicitly request a refund?",
      "criteria": {
        "true": "The message explicitly asks for a refund.",
        "false": "The message does not ask for a refund."
      }
    }
  }
}'

Types de questions

Type	Utilisation	Champs renvoyés
`noul`	Déterminer si une condition est satisfaite, par exemple si le client demande un remboursement	`noul` : probabilité que la condition soit satisfaite
`choice`	Choisir une catégorie ou une action parmi des options, par exemple l'équipe chargée d'un ticket	`choice`, `probabilities`, `confidence`
`score`	Noter selon des critères ordonnés, par exemple l'urgence d'un ticket	`score`, `legend`, `probabilities`, `confidence`

Fournissez le contenu à évaluer dans state et les questions et critères dans questions. Une requête peut contenir plusieurs questions et combiner les trois types ; toutes les questions partagent le même state.

Lecture des résultats

answers utilise les mêmes identifiants de questions que questions. Par exemple, si l'identifiant est ticket, lisez la réponse dans answers.ticket.

Évaluation : Lisez noul. Les valeurs vont de 0 à 1 ; une valeur proche de 1 tend vers vrai et une valeur proche de 0 vers faux. Définissez un seuil de décision selon vos besoins métier.
Classification : Lisez choice pour obtenir le nom de l'option retenue et utilisez probabilities pour consulter la probabilité de chaque option.
Notation : Lisez score. Les niveaux sont numérotés à partir de 0 selon leur position dans le tableau criteria ; trois niveaux correspondent à 0–2 et la note peut être décimale. legend associe les numéros de niveau à leur description.

Pour choice et score, confidence indique le degré de certitude de la distribution des probabilités, et non l'exactitude de la réponse. Les probabilités, notes et quantités de Tokens varient selon la requête.

La sélection d'outils utilise choice pour renvoyer un nom d'action, par exemple lookup_payment. L'application exécute ensuite l'opération correspondante ; cette requête de décision n'exécute aucun outil et ne génère pas de tool_calls OpenAI.

Utilisation des Tokens et coûts

usage.input_tokens et usage.output_tokens indiquent respectivement les Tokens d'entrée et de sortie. Jev facture les Tokens d'entrée uniquement ; les Tokens de sortie ne sont pas facturés. Plusieurs questions et descriptions d'options influencent également la quantité de Tokens d'entrée. Consultez les tarifs actuels dans le Catalogue des modèles.

200application/json

400application/json

422application/json

`application/json`

`application/json`

`application/json`