Decisions APIDecisions API

Python-Guide

OpenAI Decisions API in Python

OpenAI hat kein SDK für seine Decisions API veröffentlicht — es gibt kein client.decisions.create zum Kopieren. Diese Seite zeigt funktionierendes Python für den Endpoint dieser Seite — eine aufrufbare OpenAI-Decisions-API-Alternative, die decisions-1 liefert und demselben eingeschränkten Entscheidungsmuster folgt.

Aktualisiert

Den Call ausführen

Ein POST an /api/v1/decisions mit einem Bearer-Schlüssel. Der Body besteht aus model, state und questions — 1 bis 6 Fragen, jeweils vom Typ noul, choice oder score. Setze DECISIONS_API_KEY auf einen Schlüssel aus dem Dashboard.

Nutze requests (oder httpx für async — die Call-Form ist identisch). Setze bei jedem Call ein Timeout; eine hängende Entscheidung soll schnell fehlschlagen, nicht die Pipeline blockieren.

Python

import os
import requests

res = requests.post(
    "https://decisions-api.net/api/v1/decisions",
    headers={"Authorization": f"Bearer {os.environ['DECISIONS_API_KEY']}"},
    json={
        "model": "decisions-1",
        "state": "I was charged twice for my subscription this morning.",
        "questions": {
            "refund": {
                "type": "noul",
                "instructions": "Is the customer asking for money back?",
            }
        },
    },
    timeout=30,
)
res.raise_for_status()
answers = res.json()["answers"]
print(answers["refund"]["noul"])

Die Wahrscheinlichkeiten lesen

answers kommt unter deinen Frage-IDs zurück. Eine noul-Antwort ist die Wahrscheinlichkeit, dass die Aussage wahr ist. Eine choice-Antwort enthält den siegenden choice, eine Wahrscheinlichkeit pro Option und einen Konfidenzwert — nutze die Konfidenz, nicht nur den Sieger, um über automatisches Handeln zu entscheiden.

Python

answers = res.json()["answers"]

# noul: probability the statement is true
if answers["refund"]["noul"] >= 0.8:
    route_to_refunds()

# choice: winning label + per-option probabilities + confidence
team = answers["team"]
print(team["choice"], team["probabilities"], team["confidence"])

Timeouts und Retries

429 und 502 lohnen einen kurzen Backoff-Retry — fehlgeschlagene Calls werden nicht berechnet. 402 heißt Guthaben leer: aufladen, nicht erneut versuchen. 422 ist ein Validierungsfehler; die Meldung nennt das Feld, also korrigiere den Body statt zu wiederholen.

Python

import time
import requests

def decide(body, attempts=3):
    for i in range(attempts):
        try:
            res = requests.post(
                "https://decisions-api.net/api/v1/decisions",
                headers={"Authorization": f"Bearer {os.environ['DECISIONS_API_KEY']}"},
                json=body,
                timeout=30,
            )
            if res.status_code in (429, 502):
                time.sleep(2 ** i)
                continue
            if res.status_code == 402:
                raise RuntimeError("out of credits")
            res.raise_for_status()
            return res.json()["answers"]
        except requests.Timeout:
            time.sleep(2 ** i)
    raise RuntimeError("decision call failed")

Den Anbieter hinter einer Funktion halten

Aufrufer sollten eine Funktion sehen, die Text nimmt und ein Label zurückgibt — keine HTTP-Details. Wenn OpenAI seine Decisions API öffnet, tauschst du das Innere von decide() aus und alle Aufrufstellen bleiben gleich. Fragetexte, Optionen und Schwellenwerte bleiben erhalten.

Python

# Keep the decision behind one function. Swap the HTTP layer
# when OpenAI publishes its schema — callers never change.
def route_ticket(text: str) -> str:
    answers = decide({
        "model": "decisions-1",
        "state": text,
        "questions": {
            "team": {
                "type": "choice",
                "instructions": "Which team should own this ticket?",
                "criteria": {
                    "payments": "Checkout or billing.",
                    "frontend": "Rendering or browser behavior.",
                    "account": "Login or permissions.",
                },
            }
        },
    })
    team = answers["team"]
    return team["choice"] if team["confidence"] >= 0.7 else "triage"

FAQ

Gibt es ein offizielles OpenAI-SDK-Beispiel für die Decisions API?

Nein. OpenAI hat weder SDK-Methoden noch ein Request-Schema für seine Decisions API veröffentlicht — alles mit client.decisions.create ist erfunden. Diese Seite nutzt schlichtes HTTP, was jedes Provider-SDK ohnehin nur kapseln würde.

Kann ich httpx statt requests verwenden?

Ja — der Endpoint ist ein schlichter HTTPS-POST. Nutze httpx.AsyncClient mit denselben Headern, Body, Timeout und Statusbehandlung.

Wie sende ich strukturierten Kontext?

state akzeptiert ein JSON-Objekt oder -Array, nicht nur einen String — übergib dicts direkt im json-Body; das Modell liest sie als Kontext.

Eine Entscheidung im Browser ausführen

Ganz ohne Setup — führe einen echten Call im Playground mit 1 kostenlosem Credit für neue Besucher aus.

Playground öffnenDoku lesen