チームがすでに使用しているツールを接続します。

担当者のいる一つのワークフロー、一つの承認済みモデル、一つのテストキーから始めます。非本番環境で接続し、応答と利用記録を確認してから、意図的に拡張します。

ワークスペースに提供された New API のベースURLを使用し、モデルファミリーに合った互換エンドポイントを選択します。APIリファレンスには、現在のパス、必須ヘッダー、リクエストフィールドが記載されています。

サーバー上、またはクライアントツールのシークレットストアに保管し、可能であれば環境変数を通じて供給します。フロントエンドのバンドル、ソース管理、スクリーンショット、ログに露出させないでください。

すべてのモデルで互換性があるわけではありません。New API は、該当する場合、Chat Completions、Responses、Anthropic Messages、Gemini GenerateContent などの互換形式をサポートします。形式を切り替える前に、モデルとエンドポイントのドキュメントを確認してください。

モデルカタログとワークスペースの権限を組み合わせて使用します。モデルがカタログに表示されても、そのチームまたはキーに対して承認するには、管理者の許可が必要な場合があります。

401ではキーとヘッダー、403では権限またはモデルアクセス、404ではパスとモデルの互換性、429ではクォータまたはレート制限を確認してください。リクエストIDを保持し、解決しない障害についてはAPIリファレンスまたはサポート窓口を確認してください。

ローンチ前にクォータを設定し、一時的な応答にはバックオフを伴う上限付きの再試行を用い、利用状況とエラー率を監視します。認証または権限の失敗をむやみに再試行しないでください。

正確なエンドポイントパス、ヘッダー、リクエストスキーマ、ストリーミング動作、メディアフィールド、プロバイダー固有の制約が必要なときはいつでも利用してください。このページでは統合のワークフローを説明し、リファレンスがコントラクトを定義します。