Gemini 개발에서 중요한 변화는 “새 API가 하나 더 생겼다”는 점이 아닙니다. Google이 모델 호출, 도구 사용, 에이전트 실행을 하나의 흐름으로 다루도록 기본 인터페이스를 재정렬했다는 점입니다.
Interactions API는 Gemini 모델과 에이전트의 새 기본 인터페이스입니다. 2025년 12월 베타로 제공되기 시작했고, Google 문서 기준으로 2026년 6월 일반 제공 상태가 됐습니다.1 Google AI Studio와 문서에서는 기존 generateContent 인터페이스를 대체하는 방향으로 안내되고 있습니다. 다만 기존 API는 계속 작동하며 지원됩니다.1
핵심은 ‘응답 생성’이 아니라 ‘작업 흐름’이다
기존 generateContent 중심의 사용 방식은 입력을 보내고 결과를 받는 구조에 가깝습니다. 반면 Interactions API는 하나의 작업을 Interaction이라는 단위로 기록합니다. 이 안에는 사용자 입력, 모델의 중간 단계, 도구 호출, 최종 출력이 순서대로 담깁니다.1
이 차이는 에이전트 개발에서 특히 중요합니다. 실제 에이전트 작업은 한 번의 답변으로 끝나지 않는 경우가 많습니다. 검색하고, 도구를 호출하고, 파일을 다루고, 중간 결과를 바탕으로 다시 판단해야 합니다. Interactions API는 이런 과정을 예외적인 구현이 아니라 API의 기본 모델로 다룹니다.
즉, 개발자가 직접 대화 상태와 중간 실행 과정을 모두 엮어야 했던 부담을 줄이고, 모델과 에이전트가 수행한 흐름을 더 명확하게 추적할 수 있게 합니다.
상태 관리와 백그라운드 실행이 에이전트에 맞춰진다
Interactions API는 previous_interaction_id를 통해 이전 흐름을 이어갈 수 있습니다. 개발자가 매 요청마다 전체 대화 기록을 다시 구성하지 않아도 서버가 맥락을 관리할 수 있습니다.1 멀티턴 챗봇이나 업무 자동화 에이전트처럼 긴 흐름을 유지해야 하는 서비스에 유용한 변화입니다.
백그라운드 실행도 중요한 기능입니다. 오래 걸리는 작업은 background=true로 서버에서 비동기 처리할 수 있습니다.2 리서치, 코드 실행, 파일 처리처럼 시간이 필요한 작업을 사용자 요청과 분리해 처리하기에 적합합니다.
Google은 Managed Agents도 Interactions API와 연결하고 있습니다. 단일 호출로 격리된 Linux 환경에서 추론, 도구 사용, 코드 실행, 파일 작업을 수행하는 에이전트를 실행할 수 있다고 설명합니다.3 개발자는 실행 환경을 직접 구성하는 부담을 줄이고, 제품 경험과 에이전트 동작 설계에 더 집중할 수 있습니다.
도구와 미디어 생성까지 하나의 흐름으로 본다
Interactions API가 중요한 이유는 단순히 대화 상태를 관리하기 때문만은 아닙니다. Google Search, Maps 같은 도구 체이닝과 이미지·음악·음성 생성 같은 멀티모달 기능도 같은 인터페이스 방향 안에서 다뤄집니다.
이는 Gemini를 “텍스트를 생성하는 모델”로만 쓰는 것이 아니라, 외부 도구와 미디어 생성 기능을 조합해 작업을 수행하는 에이전트 플랫폼으로 쓰겠다는 방향에 가깝습니다. 따라서 앞으로 새 기능을 검토할 때도 “어떤 모델을 호출할 것인가”뿐 아니라 “어떤 상호작용 흐름을 설계할 것인가”가 더 중요해집니다.
프로토타입에서 운영으로 가는 길도 정리된다
SDK 전략도 함께 봐야 합니다. Google Gen AI SDK는 Gemini Developer API와 Gemini Enterprise Agent Platform의 Gemini API를 모두 지원하는 통합 인터페이스를 제공합니다.4 일부 예외를 제외하면 한 플랫폼에서 실행되는 코드는 다른 플랫폼에서도 실행됩니다.4
이 말은 Gemini Developer API로 빠르게 프로토타입을 만들고, 이후 기업용 Agent Platform으로 이전할 때 코드를 크게 다시 쓰지 않아도 된다는 뜻입니다.4 Interactions API는 단순한 호출 방식 변경이 아니라, 실험에서 운영까지 이어지는 개발 경로를 정리하는 역할을 합니다.
지금 무엇을 적용해야 할까
새 Gemini 프로젝트라면 Interactions API를 기본 선택지로 검토하는 편이 자연스럽습니다. 특히 다음과 같은 경우라면 우선순위가 높습니다.
멀티턴 대화가 필요한 서비스
Google Search, Maps 등 도구 호출을 포함하는 작업
백그라운드에서 오래 실행되는 에이전트
코드 실행, 파일 처리, 리서치 자동화
이미지·음성·음악 생성이 포함된 멀티모달 기능
반대로 단순 텍스트 생성만 사용하는 기존 서비스라면 즉시 이전할 필요는 없습니다. generateContent는 계속 지원됩니다. 다만 새 기능과 에이전트 중심 기능은 Interactions API를 기준으로 확장될 가능성이 높습니다.
따라서 지금 필요한 판단은 “당장 모두 마이그레이션할 것인가”가 아닙니다. 새 프로젝트의 기본 인터페이스를 Interactions API로 바꾸고, 기존 프로젝트는 기능 확장이나 에이전트화가 필요한 시점에 전환을 검토하는 것이 현실적인 접근입니다.
1Interactions API | Gemini API | Google AI for Developers
2Interactions API: our primary interface for Gemini models and agents
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.