Google, Gemini 에이전트 구축의 기본 방식으로 Interactions API 채택

Google은 Interactions API를 일반 가용성(General Availability, GA) 단계로 전환하며, 이제 Gemini 모델 및 에이전트와 작업하기 위한 기본 API라고 밝혔습니다.

이것이 지금 중요한 이유는 Google이 단순히 또 다른 엔드포인트(endpoint)를 추가하는 것이 아니기 때문입니다. Google은 개발자들에게 에이전트 형태의 API가 새로운 Gemini 작업의 기본 경로임을 알리고 있습니다. 기존의 generateContent API는 계속 지원되지만, 모든 최첨단(frontier) 에이전트 기능을 가장 먼저 제공받지는 못할 수도 있습니다.

Google의 발표 내용

Google은 2025년 12월에 시작된 퍼블릭 베타(public beta)를 거쳐 Interactions API가 이제 일반 가용성(GA) 상태가 되었다고 밝혔습니다. 이번 GA 릴리스는 안정적인 스키마(schema)를 제공하며, Google AI Studio, Gemini API 문서 및 새로운 코드 스니펫(code snippets) 전반에 걸쳐 Interactions API를 기본값으로 설정합니다.

개발자에게 중요한 요소들은 다음과 같습니다:

• 모델과 에이전트를 위한 단일 엔드포인트. 개발자는 일반적인 추론(inference)을 위해 모델 ID를 전달하거나, 더 오래 지속되는 자율 작업(autonomous tasks)을 위해 에이전트 ID를 전달할 수 있습니다.

• 관리형 에이전트 (Managed Agents). 단일 API 호출로 에이전트가 추론하고, 코드를 실행하며, 웹을 탐색하고, 파일을 관리할 수 있는 원격 Linux 샌드박스(sandbox)를 프로비저닝할 수 있습니다. Google은 Antigravity 에이전트가 기본값이며, 지침(instructions), 기술(skills), 데이터 소스를 사용하여 커스텀 에이전트를 정의할 수 있다고 밝혔습니다.

• 백그라운드 실행 (Background execution). background=True를 설정하면 서버가 긴 작업을 비동기(asynchronously) 방식으로 실행할 수 있습니다.

• 도구 혼합 (Tool mixing). Google Search 및 Google Maps와 같은 내장 도구를 하나의 요청에서 커스텀 함수와 결합할 수 있으며, 도구 결과로 텍스트뿐만 아니라 이미지도 반환될 수 있습니다.

• 딥 리서치 (Deep Research) 업그레이드. Google은 속도/깊이 에이전트 변체, 협업 계획(collaborative planning), 네이티브 차트 및 인포그래픽, 그리고 이미지, PDF, 오디오를 활용한 멀티모달 그라운딩(multimodal grounding)을 나열했습니다.

• 미디어 생성 훅 (Media generation hooks). 해당 게시물은 Nano Banana 2를 이용한 이미지 생성 및 Google Image Search 그라운딩, Lyria 3를 이용한 음악, 그리고 다중 화자 텍스트 음성 변환(text-to-speech)을 언급했습니다.

• 비용 제어 (Cost controls). Flex 및 Priority 티어(tier)를 통해 팀은 낮은 비용과 낮은 지연 시간(latency) 중 하나를 선택할 수 있습니다. Google은 Flex가 50%의 비용 절감을 제공한다고 밝혔습니다.

• 상태 유지 (State retention). 유료 티어 사용자는 지난 55일 동안의 과거 상호작용(interactions)을 검색할 수 있습니다.

Google은 또한 스키마(schema)를 기존의 역할 기반 메시지 형식에서 벗어나도록 변경하고 있습니다. 새로운 모델에서는 각 작업이 사용자 입력(user input), 사고(thought), 함수 호출(function call), 모델 출력(model output) 등과 같이 유형이 지정된 단계(typed step)로 이루어집니다.

개발자가 주목해야 하는 이유

만약 Gemini를 기반으로 구축하고 있다면, 이는 기본 아키텍처(architecture) 결정 사항을 변화시킵니다.

단순한 채팅이나 추출(extraction) 호출의 경우, generateContent가 여전히 지원됩니다. 하지만 제품에 장기 실행 작업(long-running tasks), 에이전트 상태(agent state), 도구 호출(tool calls), 웹 또는 지도 그라운딩(grounding), 멀티모달 출력(multimodal outputs) 또는 원격 실행(remote execution)이 필요하다면, Google은 명확하게 Interactions API로 여러분을 유도하고 있습니다.

더 큰 신호는 새로운 기능들이 어디에 먼저 적용될 것인가에 관한 것입니다. Google은 기존 API가 "당분간" 새로운 메인라인 Gemini 모델들을 계속 지원할 것이라고 말하지만, 장기 실행 모델과 에이전트를 위한 최첨단 기능(frontier capabilities)은 점점 더 Interactions API에만 독점적으로 제공될 것으로 예상하고 있습니다.

이것이 바로 팀들이 주의를 기울여야 할 대목입니다. 오늘 새로운 Gemini 통합을 시작한다면, 위험 요소는 기존 API가 내일 당장 작동을 멈추는 것이 아닙니다. 위험은 새로운 에이전트 기능이 나중에 제공되거나, 아예 제공되지 않는 경로 위에서 구축하는 것입니다.

실질적인 다음 단계

엔지니어링 팀이라면, 이를 공포에 질린 재작성(rewrite) 작업이 아닌 마이그레이션 계획(migration-planning) 항목으로 취급해야 합니다.

• 새로운 Gemini 에이전트 프로젝트는 Interactions API로 시작해야 합니다.
• 기존의 generateContent 앱은 계속 실행될 수 있지만, 팀은 어떤 워크플로가 백그라운드 실행(background execution), 관리형 에이전트(managed agents), 또는 내장된 도구 조합(built-in tool combinations)으로부터 이점을 얻을 수 있는지 감사(audit)해야 합니다.
• 래퍼 라이브러리(Wrapper libraries) 및 내부 SDK가 지원되는지 확인해야 합니다. Google은 LiteLLM, Eigent, Agno를 초기 지원 파트너로 명시했습니다.
• 비용에 민감한 워크로드는 Gemini 에이전트 호출이 대화형 채팅(interactive chat)과 동일한 지연 시간/비용 프로필로 실행되어야 한다고 가정하기보다 Flex 티어(Flex tier)를 테스트해야 합니다.

주의 사항 (Caveats)

Google은 Gemini Omni 지원이 곧 출시될 예정이며, 현재 완전히 제공되는 것은 아니라고 밝혔습니다. 또한, "관리형 에이전트(Managed Agents)"는 런타임(runtime)의 더 많은 부분이 Google 측에 위치함을 의미하므로, 민감한 코드나 규제 대상 데이터를 다루는 팀은 프로덕션 워크플로를 이전하기 전에 샌드박스(sandbox) 동작, 보관(retention), 로깅(logging) 및 데이터 제어 항목을 검토해야 합니다.

이번 발표에서 기존 API가 폐기(deprecated)되는 것은 아닙니다. Google은 현재의 경로를 차단하는 것이 아니라, 플랫폼이 나아갈 방향을 제시하고 있는 것입니다.

출처 (Sources)

• Google 발표: https://blog.google/innovation-and-ai/technology/developers-tools/interactions-api-general-availability/
• Google 뉴스 시그널: https://news.google.com/rss/search?q=Interactions%20API%20Gemini%20models%20agents&hl=en-US&gl=US&ceid=US:en