본문 바로가기

개발이야기

Gemini Managed Agents — background 실행·원격 MCP·자격증명 갱신 실무 가이드

반응형

핵심 요약

Google2026년 7월 7일 Gemini API Managed Agents 기능 확장발표했다(〈Google Blog〉 2026.07.07). Interactions API에서 ①background execution(background=true, store=true) ②원격 MCP 서버 연동 ③custom function calling(requires_action) ④network credential refresh(environment_id) 지원한다. 에이전트(antigravity-preview-05-2026 )가 격리 클라oud 샌드박스 에서 코드 실행·패키지 설치·웹 접근 며, 장시간 작업 HTTP 연결 없이 서버 비동기 완료 가능하다(〈Google AI Developers〉 2026.07.07).

무슨 일이 있었나

Background execution (〈Google AI Developers Docs〉)

`json

{

"background": true,

"store": true,

"agent": "antigravity-preview-05-2026",

"input": "..."

}

`

  • 즉시 interaction ID 반환폴링·스트리밍 재연결
  • Deep research·장시간 추론·코드 실행 적합
  • in_progress 상태 다음 체인 400 에러완료 대기 필수

Remote MCP (〈Google Blog〉 2026.07.07)

  • tools type: mcp_server + URL + headers
  • 프록시 미들웨어 없이 샌드박스 사내 API 직접
  • Streamable HTTP transport(JSON-RPC over POST) 필수(〈Google Cloud Docs〉)

Credential refresh

  • 만료 토큰 갱신: 동일 environment_id + network config
  • 파일시스템·설치 패키지 유지 샌드박스

Custom function calling

  • 로컬 실행 필요 로직 requires_action 상태 클라이언트 처리 재개

GA 맥락

  • Interactions API GA(2026년 6월) 이후 대규모 Managed Agents 기능 확장(〈7minAI〉 2026.07.07)

시장의 해석

단일 엔드포인트 에이전트

OpenAI ChatGPT Work·Codex 통합, Anthropic Claude Code 브라우저, Google Managed Agents 2026년 하반기 패턴'모델 API + 실행 환경 + 도구 (MCP)' 일원화다. Google 차별점GCS 기반 샌드박스 상태 유지공식 MCP HTTP 연동이다.

MCP를 프로덕션에

로컬 MCP(stdio) 개발 하지만 배포 어렵다. 원격 MCP + Managed Agent 조합'에이전트 사내 DB 코드 PR 올린다' API 호출 체인으로 만든다. , OAuth 스코프·X-Goog-User-Project 헤더(BigQuery MCP) 클라oud IAM 설계 선행 돼야 한다.

고유 인사이트: background + MCP 조합 체크 3가지 — ①interaction 완료 다음 금지런타임 MCP override 에이전트 기본 tools 완전 대체(Google Cloud Docs) ③preview agent 버전 . Antigravity Jira MCP 이기 ①③ 부터 PoC 하면 프로덕션 장애 인다.

체크포인트와 리스크

  • 체크포인트
  • Managed agents quickstart 실행
  • MCP 서버 Streamable HTTP 준수 여부
  • environment_id 재사용 credential 로테이션 테스트
  • Api-Revision 헤더 최신 확인
  • 리스크 요인
  • MCP URL·토큰 프롬프트 주입
  • 장시간 background 작업 비용
  • preview 모델 Breaking change

마무리

7/7 Managed Agents 업데이트Gemini '채팅 API' 에서 '호스팅 에이전트 런타임' 으로 올리마일스톤이다. 10줄 quickstart background=true 작업 mcp_server 사내 연동 PoC 현실적 로드맵이다. Google Cloud IAM·MCP Tool User 역할 설정 먼저 끝내 인프라 병목 있다.

참고 자료