Seit dem 11. März 2025 haben wir die Bausteine unserer neuen Agents-Plattform veröffentlicht. Details finden Sie in unserer API-Dokumentation zur Responses API, zu Tools wie Web Search, File Search und Computer Use sowie zu unserem Agents SDK mit Tracing.
Kein automatisches Upgrade: Ihre aktuellen Assistants, Threads und Runs werden nicht automatisch auf v2 migriert. Sie bleiben unter der v1-API zugänglich und funktionsfähig, sofern Sie sie nicht manuell migrieren.
Zugriff auf beide Versionen: Sowohl die v1- als auch die v2-API-Version sind für Sie vollständig verfügbar. Das bedeutet, Sie können v1 für Ihre bestehenden Assistants weiter nutzen oder die neuen Funktionen und Verbesserungen von v2 ausprobieren.
Unterschiede bei der Token-Nutzung: Es kann Unterschiede in der Token-Nutzung zwischen v1 und v2 geben, insbesondere bei Tools wie file_search und retrieval. Während das Tool file_search in v2 im Durchschnitt typischerweise weniger Tokens verbraucht als das Tool retrieval in v1, können Sie das ältere Tool retrieval mit dem v1-Version-Header weiterhin verwenden, wenn Sie möchten.
Migrationsoptionen: Während die Playground-UI und aktualisierte SDK-Versionen auf die v2-Version der API migriert wurden, werden Ihre Assistants nicht automatisch upgegradet. Sie haben die Flexibilität, zu wählen, welche API-Version Sie für Ihre Integration verwenden. Denken Sie daran: Für Assistant-Objekte gibt es keine Standard-API-Version, daher können Sie die ältere Version auf Wunsch bis Ende 2024 weiterverwenden. Weitere Informationen zur Migration von Assistants v1 auf v2 finden Sie in diesem Migrationsleitfaden.