2025년 3월 11일 기준, 새로운 Agents 플랫폼의 핵심 구성 요소를 공개했습니다. 자세한 내용은 Responses API, Web Search, File Search, Computer Use를 포함한 Tools, 그리고 Agents SDK 및 Tracing에 대한 API 문서를 참고하세요.
자동 업그레이드 없음: 현재 Assistants, Threads, Runs는 v2로 자동 마이그레이션되지 않습니다. 수동으로 마이그레이션을 선택하지 않는 한 v1 API에서 계속 접근 가능하며 정상적으로 동작합니다.
두 버전 모두 접근 가능: v1과 v2 API 버전 모두 완전히 사용 가능합니다. 즉, 기존 어시스턴트에는 v1을 계속 사용하거나 v2가 제공하는 새로운 기능과 개선 사항을 살펴볼 수 있습니다.
토큰 사용량 차이: v1과 v2 간에는 토큰 사용량에 차이가 있을 수 있으며, 특히 file_search 및 retrieval 같은 도구에서 두드러질 수 있습니다. v2의 file_search 도구는 보통 v1의 retrieval 도구보다 평균적으로 더 적은 토큰을 사용하지만, 원하신다면 v1 버전 헤더를 사용해 기존 retrieval 도구를 계속 사용할 수도 있습니다.
마이그레이션 옵션: Playground UI와 업데이트된 SDK 버전은 v2 버전의 API를 사용하도록 전환되었지만, Assistants는 자동으로 업그레이드되지 않습니다. 통합에 사용할 API 버전은 유연하게 선택할 수 있습니다. Assistant 객체에는 기본 API 버전이 없으므로, 원한다면 2024년 말까지 기존 버전을 계속 사용할 수 있습니다. Assistants v1에서 v2로의 마이그레이션에 대한 자세한 내용은 이 마이그레이션 가이드를 확인하세요.