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: Deine bestehenden Assistants, Threads und Runs werden nicht automatisch zu v2 migriert. Sie bleiben über die v1-API zugänglich und funktionsfähig, sofern du sie nicht manuell migrierst.
Zugriff auf beide Versionen: Du kannst uneingeschränkt auf die API-Versionen v1 und v2 zugreifen. Du kannst also v1 weiterhin für deine bestehenden Assistants verwenden oder die neuen Funktionen und Verbesserungen von v2 ausprobieren.
Unterschiede beim Token-Verbrauch: Der Token-Verbrauch kann sich zwischen v1 und v2 unterscheiden, insbesondere bei Tools wie file_search und retrieval. Das Tool file_search in v2 verbraucht im Durchschnitt meist weniger Tokens als das Tool retrieval in v1. Du kannst das ältere Tool retrieval aber weiterhin mit dem v1-Versionsheader verwenden.
Migrationsoptionen: Die Benutzeroberfläche des Playground und aktuelle SDK-Versionen verwenden v2 der API. Anfragen an die Assistants API müssen den Header
OpenAI-Beta: assistants=v2enthalten. Assistants API v1 ist veraltet. Verbleibende v1-Integrationen sollten zu v2 migriert werden. Weitere Informationen zur Migration von Assistants v1 zu v2 findest du in diesem Migrationsleitfaden.