Passer au contenu principal
Une question Choice demande à GLiDE de choisir une option dans un ensemble fixe, défini par l’appelant, comptant de 2 à 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 | 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.
object
requis
Un objet associant de 2 à 255 clés d’option à des chaînes de description, par exemple {"billing": "Payment or charge disputes", "returns": "Refund or return requests"}. Une option unique n’est pas valide, car elle ne peut représenter ni une décision ni un écart de confiance significatif. 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.

Objet de réponse

L’entrée correspondante dans answers est :
  • 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 et incertitude pour savoir comment l’exploiter.

Utilisation du résultat

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 de 2 à 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.