제미나이 API 에이전트 대폭 업데이트: 백그라운드 실행 및 MCP 지원
Google DeepMind는 Gemini API의 관리형 에이전트(Managed Agents) 기능을 대폭 확장하여 백그라운드 비동기 실행, 원격 MCP 서버 연동, 사용자 정의 함수 호출 및 네트워크 자격 증명 갱신 기능을 추가했습니다. 이를 통해 개발자들은 복잡한 설정이나 불안정한 연결 유지 없이도, 실제 운영 환경에 적용할 수 있는 안정적인 자율형 AI 에이전트를 더욱 쉽게 구축할 수 있게 되었습니다.
제미나이 API에서 관리형 에이전트(Managed Agents) 확장: 백그라운드 작업, 원격 MCP 등 2026년 7월 7일 · 공유하기 x.com Facebook LinkedIn 메일 링크 복사
비동기 상호작용을 위한 백그라운드 실행, 원격 MCP 서버 연결, 사용자 정의 함수 및 자격 증명 갱신과 같은 새로운 기능에 대한 지원을 추가합니다.
Philipp Schmid, Developer Relations Engineer, Google DeepMind Mariano Cocirio, Product Manager, Google DeepMind
오늘 우리는 Gemini API의 관리형 에이전트를 위한 새로운 기능을 발표합니다. 여기에는 백그라운드 실행(background execution), 원격 MCP 서버 연동(remote MCP server integration), 사용자 정의 함수 호출(custom function calling), 그리고 상호작용 간의 자격 증명 갱신(refreshing credentials)이 포함됩니다. 이번 업데이트는 개발자 피드백과 제품 요구 사항을 직접적으로 반영하여, 여러분이 신뢰할 수 있고 프로덕션 환경에 적합한 에이전트를 구축할 수 있도록 돕습니다.
Gemini Interactions API의 관리형 에이전트를 사용하면 단일 엔드포인트만 호출하면 되며, Gemini가 분리된 클라우드 샌드박스 내에서 추론, 코드 실행, 패키지 설치, 파일 관리 및 웹 정보 검색을 모두 처리해 줍니다. 만약 여러분이 AI 코딩 에이전트라면, 담당자에게 Interactions API 스킬을 설치해 달라고 요청하세요: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api.
아래는 @google/genai JavaScript SDK를 사용한 예시입니다. Python이나 cURL 예시는 Antigravity 에이전트 문서를 확인하시기 바랍니다.
확장된 기능으로 자율형 에이전트 구축하기
장기 실행되는 백그라운드 실행
오랫동안 실행되는 작업을 위해 HTTP 연결을 계속 열어두는 것은 불안정합니다. background: true 매개변수를 전달하면 서버에서 상호작용을 비동기적으로 실행할 수 있습니다. API는 즉시 ID를 반환하며, 클라이언트 애플리케이션은 이 ID를 사용하여 에이전트가 원격으로 작업을 마치는 동안 상태를 폴링하거나, 진행 상황을 스트리밍하거나, 나중에 다시 연결할 수 있습니다. 자세한 내용은 백그라운드 실행 가이드를 참조하세요.
원격 MCP 서버 연동
개인 데이터베이스나 내부 API에 접근하기 위해 별도의 프록시 미들웨어를 작성하는 대신, 이제 관리형 에이전트를 원격 MCP(Model Context Protocol) 서버에 직접 연결할 수 있습니다. 원격 도구와 내장된 샌드박스 기능을 조합하여 사용할 수 있습니다. 상호작용 시 Google 검색이나 코드 실행과 함께 mcp_server 도구를 전달하면, 에이전트가 보안 샌드박스 내에서 여러분의 엔드포인트와 통신할 수 있습니다. 외부 도구와 API로 에이전트를 확장할 때는 모범 사례를 따르시기 바랍니다.
샌드박스 도구와 함께 사용하는 사용자 정의 함수 호출
로컬 실행을 위해 내장된 샌드박스 도구와 함께 사용자 정의 도구를 추가할 수 있습니다. API는 단계 일치(step matching)를 사용합니다. 내장 도구는 서버에서 자동으로 실행되는 반면, 사용자 정의 함수는 상호작용을 requires_action 상태로 전환하여 클라이언트가 로컬 비즈니스 로직을 실행할 수 있도록 합니다.
네트워크 자격 증명 갱신
액세스 토큰 및 단기 API 키는 만료됩니다. 다음 상호작용 시 기존 environment_id와 함께 새로운 네트워크 구성을 전달하여 자격 증명을 갱신하거나 키를 교체할 수 있습니다. 새로운 규칙은 기존 규칙을 즉시 대체합니다. 샌드박스는 파일 시스템 상태, 설치된 패키지 및 복제된 리포지토리를 그대로 유지합니다.
관리형 에이전트 시작하기
이번 업데이트를 통해 관리형 에이전트는 애플리케이션을 차단하지 않고 실제 개발 환경 내에서 작동하는 비동기 작업자로 탈바꿈했습니다. 사용자 정의 에이전트 정의, 환경 구성, 네트워크 규칙 및 고급 스트리밍 패턴을 살펴보려면 Gemini Interactions API 개요 및 관리형 에이전트 빠른 시작 가이드를 확인해 보세요.