Am 11. März 2025 haben wir die Bausteine unserer neuen Agents-Plattform veröffentlicht. Details finden Sie in unserer API-Dokumentation zu unserer 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 stehen Ihnen vollständig zur Verfügung. Das bedeutet, dass Sie v1 weiterhin für Ihre bestehenden Assistants verwenden oder die neuen Funktionen und Verbesserungen von v2 erkunden können.
Unterschiede bei der Token-Nutzung: Zwischen v1 und v2 kann es Unterschiede bei der Token-Nutzung geben, insbesondere bei Tools wie file_search und retrieval. Das file_search-Tool in v2 verbraucht im Durchschnitt zwar in der Regel weniger Token als das retrieval-Tool in v1, Sie können aber weiterhin das ältere retrieval-Tool mit dem v1-Versionsheader verwenden, wenn Sie möchten.
Migrationsoptionen: Während die Playground-Oberfläche und die aktualisierten SDK-Versionen auf die Verwendung der v2-Version der API migriert wurden, werden Ihre Assistants nicht automatisch aktualisiert. Sie haben die Flexibilität, auszuwählen, welche API-Version Sie für Ihre Integration verwenden möchten. Denken Sie daran: Für Assistant-Objekte gibt es keine standardmäßige API-Version. Sie können die ältere Version daher bei Bedarf bis Ende 2024 weiterverwenden. Weitere Informationen zur Migration von Assistants v1 zu v2 finden Sie in diesem Migrationsleitfaden.