Entscheidungen

POST /v1/systemone bewertet einen state anhand benannter Fragen und gibt eine typisierte Antwort pro Frage zurück. Die Antwort ist synchrones JSON: eine Wahrscheinlichkeit, ein Optionsname oder eine Bewertung, die Ihr Code vergleichen und für Verzweigungen verwenden kann. Es wird kein generierter Text zurückgegeben.

Entscheidungen oder ChatCopy Anchor Link

Der Entscheidungs-Endpunkt akzeptiert keine messages, tools, stream oder andere Chat-Steuerungen und ist nicht in Batch verfügbar. Halten Sie Ihr Haupt-Chat-Modell separat konfiguriert.

Wählen Sie ein ModellCopy Anchor Link

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

Sie können auch mit category=decision filtern. Lesen Sie GET /v1/models/{model} für das ausgewählte Modell, bevor Sie Anfragen senden, und senden Sie die Modell-ID explizit mit. Die Beispiele auf dieser Seite verwenden jev-1.13.

Anfrage-StrukturCopy Anchor Link

instructions und jedes Kriterium akzeptieren auch einen String, ein JSON-Objekt oder ein JSON-Array. Die Anfrage weist unbekannte Felder zurück.

Ein Ticket bewertenCopy 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"]
      }
    }
  }'

Die Antwort behält Ihre Fragnamen unter answers bei. Die Werte unten dienen der Veranschaulichung:

{
  "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}
}

Die Antworten verwendenCopy Anchor Link

• Jede Frage erhält eine Antwort desselben type unter demselben Namen.
• Eine noul-Antwort ist eine Wahrscheinlichkeit, kein Boolean. Wählen Sie Ihren eigenen Schwellenwert für jede Aktion.
• Eine choice-Antwort ist immer einer der von Ihnen gesendeten Optionsnamen.
• Eine score-Antwort indiziert Ihr criteria-Array: 1 oben bedeutet "Money affected".
• Testen Sie Entscheidungen anhand Ihrer eigenen gelabelten Fälle, bevor sie Rückerstattungen, Eskalationen oder andere Aktionen auslösen.

Verwendung über MCPCopy Anchor Link

Der TokenLab MCP server stellt evaluate_decisions in den core- und full-Profilen bereit. Rufen Sie zuerst list_models mit {"category":"decision"} und get_model auf, und übergeben Sie dann dieselben model, state und questions als Tool-Argumente. Lesen Sie structuredContent.answers und structuredContent.usage aus dem Ergebnis. Das Tool gibt ein synchrones Ergebnis zurück und verwendet kein asynchrones Task-Polling.

Verwendung über die SDKsCopy Anchor Link

Das TokenLab JavaScript SDK 0.1.2+ bietet evaluateDecisions(body); das Python SDK 0.1.2+ bietet evaluate_decisions(body). Der Body ist dasselbe JSON wie bei der HTTP-Anfrage. Beide bewahren typisierte Antworten und Usage-Daten und wiederholen eine fehlgeschlagene Anfrage nicht automatisch. Siehe SDKs.

Kosten und WiederholungsversucheCopy Anchor Link

• Entscheidungen werden nach Tokens abgerechnet, basierend auf usage.input_tokens und usage.output_tokens in der Antwort, zu den aktuellen Token-Preisen des Modells.
• Preise können sich ändern. Lesen Sie die Preisdetails des Modells oder die Pricing API, anstatt einen Preis fest zu kodieren.
• Ein Modell kann Output-Tokens melden, selbst wenn der Output-Preis null ist.
• Anfragen folgen Ihrer Zustellungsoption. Siehe Abrechnung und Preise.
• Ein Timeout lässt das Ergebnis ungewiss. Überprüfen Sie die Anfrage in Ihren Logs oder der Console, bevor Sie erneut eine kostenpflichtige Anfrage senden.

Häufige FehlerCopy Anchor Link

API-ReferenzCopy Anchor Link