OpenAI가 Assistants API의 서비스 종료일을 2026년 8월 26일로 공식 확정했습니다. 사용 중인 소프트웨어가 이 API를 사용한다면 기능 중단을 방지하기 위해 마감일 전에 코드를 마이그레이션해야 합니다. 이 공지는 2025년 8월 20일 OpenAI API deprecations 목록에 처음 올라왔으나, OpenAI는 최종 종료 시점의 정확한 시간을 공개하지 않았습니다.
새로운 구조의 작동 방식
기존 시스템을 대체하기 위해 OpenAI는 개발자들에게 Responses API와 Conversations API를 안내합니다. 공식 Assistants migration guide에는 기존 구성 요소가 어떻게 전환되는지 자세히 나와 있습니다:
- Assistants는 프롬프트로 바뀝니다.
- Threads는
Conversations로 변경됩니다. - Runs는
Responses가 됩니다. - Run steps는 일반 항목(items)으로 전환됩니다.
응답은 직접 입력 항목이나 대화 객체를 사용할 수 있습니다. 이러한 변화는 백엔드 작업 부담을 늘립니다. 이제 대화 기록 정리, 요청 재시도, 툴 호출 루프 등을 포함한 오케스트레이션을 애플리케이션 코드에서 직접 처리해야 합니다.
주의해야 할 두 가지 함정
첫째, OpenAI는 기존 Threads를 새로운 Conversations로 자동 변환하는 도구를 제공하지 않습니다. 개발자가 직접 처리해야 합니다. 가이드에서는 새로운 대화를 새 API로 먼저 라우팅한 뒤, 기존 대화 기록은 필요할 때만 복사할 것을 권장합니다.
둘째, 프롬프트 마이그레이션에도 자체 마감일이 있습니다. 가이드에 프롬프트 객체가 언급되어 있지만, OpenAI는 재사용 가능한 프롬프트 객체 역시 지원 중단될 예정이라고 경고합니다. 아키텍처를 확정하기 전에 해당 일정을 확인해야 합니다.
문서에서 검증되지 않은 부분
OpenAI 문서는 종료일과 새로운 구조를 확인해 주지만, 기존과 동일한 속도나 가격을 보장하지는 않습니다. 두 시스템 간의 지연 시간, 토큰 비용, 출력 품질을 검증한 외부 결과는 아직 없습니다. 또한 문서에서는 모든 계정이나 리전에서 전면적인 서비스 중단이 동시에 발생하는지 여부도 명시하지 않았습니다.
마이그레이션 테스트 방법
마이그레이션을 일찍 시작하세요. 마감 직전까지 미루지 마세요.
먼저 코드베이스에 있는 모든 어시스턴트, 스레드, 런, 커스텀 툴, 파일 경로를 정리하는 것부터 시작하세요. 다음으로 Responses API와 Conversations API를 사용하는 테스트 플로우를 하나 만듭니다. 저장된 대화와 다단계 툴 호출을 두 시스템 모두에서 다시 실행해 보세요. 출력 품질, 토큰 사용량, 지연 시간, 오류 복구 기능을 나란히 비교합니다. 새 애플리케이션이 안정적으로 작동한다는 확신이 들 때까지 두 경로 모두 모니터링 가능하도록 유지하세요.