2025年3月11日現在、新しい Agents プラットフォームの構成要素をリリースしました。詳細は、Responses API の API ドキュメント、Web Search、File Search、Computer Use を含む Tools、および Tracing を備えた Agents SDK をご覧ください。
自動アップグレードなし：現在の Assistants、Threads、Runs は v2 に自動的には移行されません。手動で移行を選択しない限り、v1 API のままでアクセスでき、引き続き動作します。
両バージョンへのアクセス：v1 と v2 の両方の API バージョンを問題なくご利用いただけます。つまり、既存の assistants には v1 を使い続けることも、v2 が提供する新機能や改善点を試すこともできます。
トークン使用量の違い：v1 と v2 では、特に file_search や retrieval などのツールでトークン使用量に差が出る場合があります。v2 の file_search ツールは、v1 の retrieval ツールと比べて平均的に消費トークンが少ない傾向がありますが、必要であれば v1 の version header を指定して、従来の retrieval ツールも引き続き利用できます。
移行オプション：Playground UI と更新された SDK バージョンは v2 版の API を使うように移行されましたが、Assistants は自動的にアップグレードされません。統合で使用する API バージョンは柔軟に選択できます。なお、Assistant オブジェクトには既定の API バージョンがないため、希望する場合は 2024 年末まで旧バージョンを使い続けることも可能です。Assistants v1 から v2 への移行に関する詳細は、この 移行ガイド をご覧ください。