Score

Une question Score évalue une situation sur une échelle ordonnée que vous définissez. Elle renvoie un score discret (l’indice du niveau retenu) ainsi que expected_level, une estimation continue pondérée par les probabilités sur l’ensemble des niveaux, des probabilities par niveau et une legend qui reprend vos descriptions de niveaux par indice. Utilisez un Score lorsque la réponse est une position sur une échelle aux niveaux définis (urgence, gravité, intensité du sentiment) plutôt qu’une catégorie sans ordre.

Score ou Noul : si vous avez simplement besoin d’une décision binaire, utilisez plutôt Noul. C’est plus simple et cela renvoie une probabilité unique plutôt qu’une distribution sur des niveaux.

Requête

string

requis

Toujours "score".

string | object

requis

La question à évaluer, sous forme de chaîne non vide ou d’objet JSON non vide. L’objet est sérialisé en texte JSON compact.

string[] | object

requis

Un tableau ordonné de descriptions de niveaux, l’indice 0 correspondant au niveau le plus bas : ["low urgency, can wait", "medium urgency, handle soon", "high urgency, handle immediately"].Accepte également un objet avec des clés sous forme de chaînes numériques (par exemple {"1": "...", "3": "...", "5": "..."}) : les clés sont triées puis ignorées, et la réponse est toujours réindexée de 0..N-1, quelles que soient les clés utilisées.Fournissez entre 1 et 255 niveaux.

curl -s https://api.fastino.ai/v1/systemone \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fastino/GLiDE",
    "state": "Refund request: the receipt is attached, the purchase was 10 days ago, and refunds are allowed within 30 days.",
    "questions": {
      "urgency": {
        "type": "score",
        "instructions": "How urgent is this request?",
        "criteria": [
          "low urgency, can wait",
          "medium urgency, handle soon",
          "high urgency, handle immediately"
        ]
      }
    }
  }'

Objet de réponse

L’entrée correspondante dans answers est :

{
  "urgency": {
    "type": "score",
    "score": 0,
    "expected_level": 0.27621539375795195,
    "confidence": 0.4999999998141525,
    "probabilities": {
      "0": 0.7412615353520668,
      "1": 0.24126153553791435,
      "2": 0.017476929110018805
    },
    "legend": {
      "0": "low urgency, can wait",
      "1": "medium urgency, handle soon",
      "2": "high urgency, handle immediately"
    }
  }
}

score : un indice entier discret, le niveau argmax.
expected_level : Σ(level × probability), la position continue, pondérée par les probabilités, sur l’ensemble des niveaux. Utilisez-le lorsque vous avez besoin de seuils plus fins que ceux permis par l’indice discret.
legend n’est pas généré par le modèle : l’API le construit à partir de vos propres criteria, indexés.
confidence : top1 − top2, la même formule que pour Choice, de 0 (deux niveaux adjacents à égalité) à 1 (un niveau concentre la quasi-totalité de la masse de probabilité). Consultez Confiance et incertitude pour savoir comment l’exploiter.

Utilisation du résultat

answer = response["answers"]["urgency"]

if answer["score"] >= 2:
    action = "page_oncall"
elif answer["expected_level"] >= 1.5:
    action = "escalate"  # closer to the next level up than a clean 1
else:
    action = "standard_queue"

Démarrage

Modèles de décision

API d'entraînement

Modèles GLiNER

API d'inférence

Dépannage

Modèles

Compte

Requête

Objet de réponse

Utilisation du résultat