OpenAI Decisions API eğitimi: ilk karar çağrınız

Adım 1 — anahtar alın

Oyun alanını açıp bir kez Run'a basın — misafir oturumu, API anahtarı ve 1 ücretsiz kredi otomatik oluşturulur. Üretim için giriş yapın ve panelde API keys altında adlandırılmış bir anahtar oluşturun. Anahtarlar Authorization Bearer başlığıyla gönderilir.

Anahtarı sunucuda tutun. Onu taşıyan her istek bakiyenizden düşer — tarayıcı koduna veya herkese açık bir depoya asla koymayın.

Adım 2 — ilk isteği gönderin

Bir karar isteğinin üç alanı vardır: model (decisions-1 veya decisions-latest), state (modelin okuduğu bağlam — bir metin, JSON nesnesi veya metin dizisi) ve questions (1–6 soru kimliğinden oluşan bir eşleme). Asıl soruyu instructions içine yazın — kimlik, yanıtın döndüğü etiketten ibarettir.

Bir noul sorusu evet/hayır yargısıdır: yanıt alanı noul, ifadenin doğru olma olasılığıdır.

curl https://decisions-api.net/api/v1/decisions \
  -H "Authorization: Bearer $DECISIONS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "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?"
    }
  }
}'

Adım 3 — bir choice sorusu ekleyin

Bir choice sorusu tanımladığınız listeden bir etiket seçer. criteria, her biri kısa bir açıklamaya sahip 2–8 seçenek kimliğinden oluşan bir objedir — model açıklamayı okur, bu yüzden onu bir yönlendirme kuralı gibi yazın.

Bir score sorusu aynı şekilde çalışır ama en düşükten başlayan 2–10 seviye açıklamasının sıralı bir dizisini alır. Üç tipi tek çağrıda karıştırabilirsiniz — toplam altı soruya kadar.

{
  "team": {
    "type": "choice",
    "instructions": "Which team should own this ticket?",
    "criteria": {
      "payments": "Checkout, billing, or payment processing.",
      "frontend": "Rendering or browser behavior.",
      "account": "Login, permissions, or profile."
    }
  }
}

Adım 4 — olasılıkları okuyun

Başarılı bir yanıt model, soru kimliklerinizle anahtarlanmış answers, usage ve credits_used içerir. Bir noul yanıtı yalnızca olasılıktır. Bir choice yanıtı kazanan choice'u, her seçenek için bir olasılık ve bir güven değeri içerir.

İkinci, kazanan kadar önemlidir. Her biri yaklaşık 0.5 olan iki seçenek, 0.9'a karşı 0.1'den farklı bir durumdur — yakın sonuçları emin seçimler değil, inceleme adayları olarak ele alın.

{
  "model": "decisions-1",
  "answers": {
    "refund": { "type": "noul", "noul": 0.98 }
  },
  "credits_used": 1
}

Adım 5 — eşik belirleyin ve hataları yönetin

Kendi trafiğinizden bir güven eşiği seçin: üstünü kabul edin, geri kalanı bir kişiye yönlendirin. Yüksekten başlayın (0,7–0,8) ve yalnızca altında kalan vakaları inceledikten sonra düşürün.

402 bakiye bitti demektir; 429 veya 502 daha sonra tekrar deneyin demektir — başarısız çağrılar ücretlendirilmez. 422 gövde doğrulama hatasıdır ve mesaj alanı belirtir.

const res = await fetch('https://decisions-api.net/api/v1/decisions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DECISIONS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(body),
})

if (res.status === 402) { /* out of credits */ }
if (res.status === 429 || res.status === 502) { /* retry later */ }

const { answers } = await res.json()
const team = answers.team

if (team.type === 'choice' && team.confidence >= 0.7) {
  routeTo(team.choice)          // confident: auto-assign
} else {
  queueForHuman(team)           // low confidence or near-tie: review
}

SSS