エラー分類
- 認証：キーやアカウント状態を修正
- 検証：リクエストを修正
- レート制限：ジッター付き待機
- タイムアウト：冪等な処理だけ再試行
- 上流障害：検証済み代替だけを使用
記録する情報
- リクエストID
- モデル名
- HTTPステータス
- エラーコード
- 試行回数
- 処理時間
完全なAPIキーや不要な機密プロンプトをログに残さないでください。
よくある質問
再試行は何回が適切ですか？
エラー種別と許容レイテンシに応じた少数の上限を設定します。万能な回数はありません。
ツール操作を再試行できますか？
冪等であるか、冪等キーにより前回結果を確認できる場合だけです。