Choice : la primitive de décision à choix unique de GLiDE

Une question Choice demande à GLiDE de choisir une option dans un ensemble fixe, défini par l’appelant, comptant jusqu’à 255 options nommées. La réponse comprend l’option sélectionnée, une valeur de confiance et une distribution de probabilité complète sur toutes les options que vous avez définies. Utilisez un Choice lorsque la réponse est une catégorie parmi plusieurs, sans ordre : l’équipe qui doit traiter un ticket, la catégorie à laquelle appartient un produit, la langue dans laquelle un extrait est rédigé.

Requête

string

requis

Toujours "choice".

string

requis

La question à évaluer, en langage naturel.

object

requis

Un objet associant jusqu’à 255 clés d’option à des chaînes de description, par exemple {"billing": "Payment or charge disputes", "returns": "Refund or return requests"}. Les noms des options et leurs descriptions sont tous deux envoyés au modèle : rédigez donc des descriptions qui distinguent clairement les options aux noms similaires.

curl -s https://api.fastino.ai/v1/systemone \
  -H "X-API-Key: YOUR_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": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this request?",
        "criteria": {
          "billing": "Payment or charge disputes",
          "returns": "Refund or return requests",
          "shipping": "Delivery or shipping issues"
        }
      }
    }
  }'

Réponse

{
  "department": {
    "type": "choice",
    "choice": "returns",
    "confidence": 0.9983415574354015,
    "probabilities": {
      "billing": 0.000576420510560337,
      "returns": 0.9989179779459618,
      "shipping": 0.0005056015434779647
    }
  }
}

choice : l’option ayant la probabilité la plus élevée.
probabilities : la distribution complète sur toutes les options que vous avez définies. Les clés correspondent à vos clés criteria et leur somme vaut environ 1.
confidence : top1 − top2, l’écart de probabilité entre la meilleure et la deuxième meilleure option, de 0 (deux options à égalité) à 1 (une option concentre la quasi-totalité de la masse de probabilité). Consultez Confiance pour savoir comment l’exploiter.

Utilisation du résultat

answer = response["answers"]["department"]

queue_map = {"billing": "billing-team", "returns": "returns-desk", "shipping": "logistics"}
target_queue = queue_map[answer["choice"]]

if answer["confidence"] < 0.5:
    notify("routing uncertain — runner-up may also apply")

Posez toutes vos questions en un seul appel

Évaluez plusieurs questions Choice sur le même state en une seule requête plutôt qu’en une requête par question. Elles reçoivent des réponses indépendantes : ajouter une question coûte des tokens mais modifie à peine la latence. Un appel de triage du support peut demander department, urgency et tone ensemble au lieu de faire trois allers-retours ; votre code peut agir sur department et ignorer le reste jusqu’à ce qu’il en ait besoin. Consultez Combiner plusieurs questions pour un exemple complet. Fournissez au modèle la liste complète des options réelles plutôt qu’une présélection : une question Choice accepte jusqu’à 255 options, et chacune ne coûte que quelques tokens. Ajoutez une option other ou none of the above lorsque l’entrée risque de ne pas couvrir tous les cas : GLiDE peut ainsi y placer la masse de probabilité au lieu d’imposer une mauvaise correspondance avec l’une de vos options nommées.

Voir aussi

Noul : une décision oui/non avec une probabilité
Score : évaluer sur une échelle ordonnée
Modèles de décision : vue d’ensemble des primitives, limites et contrat de requête complet
GLiDE : ce qu’est GLiDE et quand l’utiliser

Démarrage

Modèles de décision

API d'inférence

API d'entraînement

Modèles

Compte

Choice : la primitive de décision à choix unique de GLiDE

Requête

Réponse

Utilisation du résultat

Posez toutes vos questions en un seul appel

Voir aussi

​Requête

​Réponse

​Utilisation du résultat

​Posez toutes vos questions en un seul appel

​Voir aussi

Requête

Réponse

Utilisation du résultat

Posez toutes vos questions en un seul appel

Voir aussi