2026년 10월 8일자 Gemini API 출시 노트에 따르면, Deep Research 에이전트인 deep-research-pro-preview-12-2025가 비권장(deprecated)됨이 공지되었습니다. 제공 종료일은 2026년 10월 23일이며, 공지 후 약 2주밖에 남지 않았습니다.

제공 종료 후에도 기존 ID를 계속 사용하면 요청이 실패할 것으로 예상됩니다. Deep Research를 통합한 배치 처리, 사내 리서치 도구, 보고서 자동 생성 등을 운영하고 있다면 빠른 대응이 필요합니다.

마이그레이션 자체는 interactions.create의 agent 파라미터를 수정하는 것만으로 가능하지만, 마이그레이션할 대상은 2가지가 있습니다. 용도에 맞춰 선택해야 하므로 본 기사에서 선택 방법을 정리했습니다.

📌 영향을 받는 사람

• deep-research-pro-preview-12-2025를 직접 지정하는 개발자
• Interactions API (interactions.create)로 Deep Research를 호출하는 앱 운영자
• 설정 파일이나 환경 변수에 에이전트 ID가 포함된 팀

마이그레이션 대상 선택 흐름은 다음과 같습니다.

💡 팁
제공 자료에는 처리 시간이나 비용의 구체적인 차이는 기재되어 있지 않습니다. 실제 서비스 전환 전에 실제 쿼리로 품질, 소요 시간, 요금을 확인하는 것을 권장합니다.

릴리스 노트 페이지의 'Last updated'가 2026-10-07 UTC에서 2026-10-09 UTC로 변경되었습니다. 상기 공지 추가에 따른 업데이트이므로 기능에는 영향이 없습니다.

⚠️ Breaking Change
2026년 10월 23일 이후, 기존 ID인 deep-research-pro-preview-12-2025를 지정한 요청은 실패할 것으로 예상됩니다.

점검 사항: 코드, 설정 파일, 환경 변수, IaC(Infrastructure as Code), 문서에서 기존 ID를 검색합니다. -
용도 판별: UI 전용 실시간 표시라면 deep-research-preview-04-2026을 선택하고, 포괄적인 자동 조사가 필요하다면 deep-research-max-preview-04-2026을 선택합니다.
대체: interactions.create의 agent 파라미터를 새 ID로 변경합니다. -
검증: 스테이징 환경에서 출력 품질, 소요 시간, 오류 여부를 확인합니다. -
배포: 10월 23일 이전에 운영 환경에 반영합니다.

기존 ID 검색에는 다음 명령어를 사용할 수 있습니다.

grep -rn 

interaction = client.interactions.create(
agent="deep-research-max-preview-04-2026",

...기존 입력 파라미터

...

import os
DEEP_RESEARCH_AGENT = os.getenv(
"DEEP_RESEARCH_AGENT",
...

⚠️ 주의

위 내용은 수정해야 할 부분을 보여주기 위한 예시입니다. SDK의 버전이나 호출 방식에 따라 설명이 다를 수 있으므로, 최신 공식 문서를 확인해 주세요.

-
`deep-research-pro-preview-12-2025`는 **2026년 10월 23일에 제공 종료**됩니다. 유예 기간은 약 2주입니다. - 마이그레이션할 대상은 용도에 따라 선택하세요.
- 속도・효율・UI 스트리밍 →
`deep-research-preview-04-2026`

- 포괄성・자동 정보 수집 및 정리 →
`deep-research-max-preview-04-2026`

- 속도・효율・UI 스트리밍 →
- 작업의 핵심은
`interactions.create`
의 `agent` 파라미터 변경입니다. 기존 ID를 정리하고, 새 ID로 검증하며, 기한 내에 배포하는 작업을 이번 주 안에 진행하세요.
- 이름에 `preview`가 붙기 때문에, 앞으로도 ID 교체가 발생할 수 있습니다. ID는 설정에서 외부화(outsource)해 두는 것이 안전합니다.