Décisions

POST /v1/systemone évalue un state par rapport à des questions nommées et renvoie une réponse typée par question. La réponse est un JSON synchrone : une probabilité, un nom d'option ou un score que votre code peut comparer et utiliser pour des branchements. Il ne renvoie pas de texte généré.

Décisions ou chatCopy Anchor Link

Le endpoint de décision n'accepte pas messages, tools, stream ou d'autres contrôles de chat, et il n'est pas disponible en mode Batch. Gardez votre modèle de chat principal configuré séparément.

Choisir un modèleCopy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=decision" \
  -H "Authorization: Bearer sk-your-api-key"

Vous pouvez également filtrer avec category=decision. Lisez GET /v1/models/{model} pour le modèle sélectionné avant d'envoyer des requêtes, et envoyez explicitement l'ID du modèle. Les exemples sur cette page utilisent jev-1.13.

Structure de la requêteCopy Anchor Link

instructions et chaque critère acceptent également une chaîne, un objet JSON ou un tableau JSON. La requête rejette les champs inconnus.

Évaluer un ticketCopy Anchor Link

curl https://api.tokenlab.sh/v1/systemone \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "I was charged twice. Please refund the duplicate payment.",
    "questions": {
      "refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
      "department": {
        "type": "choice", "instructions": "Which team should handle this?",
        "criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
      },
      "urgency": {
        "type": "score", "instructions": "Rate urgency",
        "criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
      }
    }
  }'

La réponse conserve les noms de vos questions sous answers. Les valeurs ci-dessous sont illustratives :

{
  "model": "jev-1.13",
  "answers": {
    "refund_requested": {"type": "noul", "noul": 0.97},
    "department": {"type": "choice", "choice": "refunds"},
    "urgency": {"type": "score", "score": 1}
  },
  "usage": {"input_tokens": 96, "output_tokens": 12}
}

Utiliser les réponsesCopy Anchor Link

• Chaque question reçoit une réponse du même type, sous le même nom.
• Une réponse noul est une probabilité, pas un booléen. Choisissez votre propre seuil pour chaque action.
• Une réponse choice est toujours l'un des noms d'options que vous avez envoyés.
• Une réponse score indexe votre tableau criteria : 1 ci-dessus signifie "Money affected".
• Testez les décisions par rapport à vos propres cas étiquetés avant qu'elles ne déclenchent des remboursements, des escalades ou d'autres actions.

Utiliser depuis MCPCopy Anchor Link

Le serveur MCP TokenLab expose evaluate_decisions dans les profils core et full. Appelez d'abord list_models avec {"category":"decision"} et get_model, puis passez les mêmes model, state et questions en tant qu'arguments d'outil. Lisez structuredContent.answers et structuredContent.usage à partir du résultat. L'outil renvoie un résultat synchrone et n'utilise pas de polling de tâche asynchrone.

Utiliser depuis les SDKCopy Anchor Link

Le SDK JavaScript TokenLab 0.1.2+ fournit evaluateDecisions(body) ; le SDK Python 0.1.2+ fournit evaluate_decisions(body). Le corps est le même JSON que la requête HTTP. Les deux préservent les réponses typées et l'usage, et ne rejouent pas automatiquement une requête échouée. Voir SDKs.

Coût et tentativesCopy Anchor Link

• Les décisions sont facturées par tokens, à partir de usage.input_tokens et usage.output_tokens dans la réponse, aux prix actuels des tokens du modèle.
• Les prix peuvent changer. Lisez les détails de tarification du modèle ou l'API de tarification au lieu de coder un prix en dur.
• Un modèle peut rapporter des tokens de sortie même lorsque son prix de sortie est nul.
• Les requêtes suivent votre option de livraison. Voir Facturation et tarification.
• Un délai d'attente (timeout) laisse le résultat incertain. Vérifiez la requête dans vos logs ou votre Console avant d'envoyer à nouveau une requête payante.

Erreurs courantesCopy Anchor Link

Référence APICopy Anchor Link