무슨 일이 일어났나

구글이 Interactions API를 정식(GA)으로 풀었어. 이제 이게 Gemini 모델이랑 에이전트를 다루는 기본 인터페이스야. 2025년 12월에 공개 베타로 나온 뒤 약 반년 만에 스키마를 고정하고 GA로 올렸어.

뭐가 바뀌었나

  • Managed Agents: API 호출 한 번이면 원격 리눅스 샌드박스가 떠. 그 안에서 에이전트가 코드를 실행하고 웹을 돌아다니고 파일을 관리해
  • 백그라운드 실행: 호출에 background=True만 주면 서버가 그 작업을 비동기로 돌려. 오래 걸리는 작업을 던져두고 결과만 받는 식이야
  • 도구·미디어 확장: 구글 검색이나 지도 같은 기본 도구를 직접 만든 함수랑 섞어 쓰고, 도구 결과가 텍스트랑 같이 이미지도 돌려줘
  • 비용 티어: Flex와 Priority 티어를 두고 비용을 50%까지 줄일 수 있어

어떤 의미인가

API 하나로 모델 호출부터 에이전트 실행, 도구 연결, 백그라운드 작업까지 다 묶었어. 그동안 Gemini로 에이전트를 붙이려면 호출 단위로 상태를 직접 들고 다녔는데, 이제 서버가 상태와 실행을 맡아줘. LiteLLM, Eigent, Agno 같은 연동도 바로 쓸 수 있어서, Gemini 기반으로 에이전트를 만드는 사람이라면 이쪽으로 옮길지 따져볼 만해.

주의할 점

기존 generateContent API가 사라지는 건 아니야. 계속 쓸 수 있지만 새 프런티어 기능은 Interactions API 쪽으로 단계적으로 옮겨간다고 하니, 지금 돌아가는 코드를 급히 바꿀 필요는 없어. 비용 50% 절감도 모든 호출이 아니라 Flex·Priority 티어 조건이라, 본인 작업이 그 조건에 맞는지부터 보는 게 나아.