2025년 3월 11일 현재, 새로운 에이전트 플랫폼의 구성 요소를 출시했습니다. 자세한 내용은 Responses API, Web Search, File Search, Computer Use 등의 도구, 그리고 Tracing이 포함된 Agents SDK에 대한 API 문서를 참조하세요.
자동 업그레이드 없음: 현재 사용 중인 어시스턴트, 스레드, 실행은 v2로 자동 마이그레이션되지 않습니다. 수동으로 마이그레이션하지 않는 한 기존 항목은 v1 API에서 계속 접근하고 사용할 수 있습니다.
두 버전 모두 이용 가능: v1과 v2 API 버전을 모두 자유롭게 이용할 수 있습니다. 따라서 기존 어시스턴트에는 v1을 계속 사용하거나, v2에서 제공하는 새로운 기능과 개선 사항을 살펴볼 수 있습니다.
토큰 사용량 차이: v1과 v2는 토큰 사용량이 다를 수 있으며, 특히 file_search 및 retrieval 같은 도구에서 차이가 날 수 있습니다. v2의 file_search 도구는 일반적으로 v1의 retrieval 도구보다 평균 토큰 사용량이 적지만, 원하는 경우 v1 버전 헤더를 사용해 기존 retrieval 도구를 계속 사용할 수 있습니다.
마이그레이션 옵션: Playground UI와 최신 SDK 버전은 API v2를 사용하며, Assistants API 요청에는
OpenAI-Beta: assistants=v2헤더를 포함해야 합니다. Assistants API v1은 지원 중단 예정이므로, 남아 있는 모든 v1 통합을 v2로 마이그레이션해야 합니다. Assistants v1에서 v2로 마이그레이션하는 방법에 관한 자세한 내용은 이 마이그레이션 가이드를 참조하세요.