TypeScript ガイド
TypeScript で使う OpenAI Decisions API
OpenAI は Decisions API の SDK を公開していません——client.decisions.create のようなメソッドは存在しません。このページでは、このサイトのエンドポイント(decisions-1 を提供する、呼び出せる OpenAI Decisions API の代替)向けの、完全に型付けされた動く TypeScript を示します。同じ制約付きデシジョンパターンに従います。
更新日
契約を定義する
リクエストを一度型付けすればどこでも再利用できます。model はリテラル union なので固定 ID がタイポでずれることがありません。questions は質問 ID をキーとする record で、それぞれ noul・choice・score 型です。
answers は type で判別される union として型付けします——これがレスポンス処理を安全にする部分です：noul の回答には noul があり、choice の回答には choice と probabilities があります。type で絞り込めば正しいフィールドが得られます。
TypeScript
interface DecisionQuestion {
type: 'noul' | 'choice' | 'score'
instructions: string
criteria?: Record<string, string> | string[]
}
interface DecisionRequest {
model: 'decisions-1' | 'decisions-latest'
state: string | Record<string, unknown> | unknown[]
questions: Record<string, DecisionQuestion>
}
interface DecisionAnswers {
[questionId: string]:
| { type: 'noul'; noul: number }
| { type: 'choice'; choice: string; probabilities: Record<string, number>; confidence: number }
| { type: 'score'; score: number; legend: string[]; probabilities: Record<string, number>; confidence: number }
}呼び出す
Bearer キーで 1 回 POST します。satisfies DecisionRequest でコンパイル時に本文を検査し、AbortSignal.timeout がハングした呼び出しがパイプラインを止めるのを防ぎます。answers を読む前に type フィールドで絞り込んでください。
TypeScript
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(request satisfies DecisionRequest),
signal: AbortSignal.timeout(30000),
})
const { answers } = (await res.json()) as { answers: DecisionAnswers }
const team = answers.team
if (team.type === 'choice' && team.confidence >= 0.7) {
routeTo(team.choice)
}タイムアウトとリトライ
429 と 502 は短いバックオフ付きでリトライする価値があります——失敗した呼び出しは課金されません。402 は残高不足です：チャージしてください。リトライは無駄です。422 はバリデーションエラーで、メッセージがフィールドを示すので本文を直してください。
TypeScript
async function decide(body: DecisionRequest, attempts = 3): Promise<DecisionAnswers> {
for (let i = 0; i < attempts; i++) {
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),
signal: AbortSignal.timeout(30000),
})
if (res.status === 429 || res.status === 502) {
await new Promise(r => setTimeout(r, 2 ** i * 1000))
continue
}
if (res.status === 402) throw new Error('out of credits')
if (!res.ok) throw new Error(`decision call failed: ${res.status}`)
return (await res.json() as { answers: DecisionAnswers }).answers
}
throw new Error('decision call failed')
}呼び出しをヘルパーに包む
呼び出し側には「テキストを入れてラベルが出る」関数だけを見せます——HTTP の詳細は隠します。タイムアウト、402 チェック、リトライループを decide() の中に一度だけ書けば、すべての呼び出し箇所がクリーンに保てます。
TypeScript
// Keep the call behind one typed function — timeouts, 402s,
// and retries live inside it, not at every call site.
export async function routeTicket(text: string): Promise<string> {
const answers = await 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.',
},
},
},
})
const team = answers.team
return team.type === 'choice' && team.confidence >= 0.7 ? team.choice : 'triage'
}よくある質問
Decisions API の公式 OpenAI SDK 例はありますか？
ありません。OpenAI は Decisions API の SDK メソッドやリクエストスキーマを公開していません——client.decisions.create を示すコードはすべて創作です。このページはプレーンな HTTP を使います。
型にコードジェネレーターは必要ですか？
いいえ——このページのインターフェイスが契約全体をカバーしています。そのままプロジェクトにコピーしてください。監査できる小ささで、コードと一緒にバージョン管理できます。
構造化されたコンテキストを送るには？
state は文字列だけでなく JSON オブジェクトや配列を受けます——json 本文に dict をそのまま渡せば、モデルがコンテキストとして読みます。
ブラウザでデシジョンを実行
セットアップ不要——新規訪問者の 1 クレジットでプレイグラウンドから実際に呼べます。