AI 에이전트를 만들 때 어려운 부분은 모델이 답을 잘 생성하게 하는 것만이 아닙니다. 실제 서비스에서는 코드 실행, 파일 처리, 도구 연결, 상태 유지, 네트워크 접근, 인증 정보 관리까지 함께 다뤄야 합니다.
Gemini API Managed Agents는 이 실행 계층을 API로 관리하려는 접근입니다. 개발자가 에이전트 런타임을 직접 조립하기보다, 관리형 환경에서 에이전트를 만들고 실행하고 외부 도구와 연결할 수 있게 합니다.
Managed Agents가 관리하는 것
Managed Agents API는 단일 API 호출로 관리형 자율 에이전트를 만들 수 있게 합니다. 각 에이전트는 Antigravity 하네스를 기반으로 한 샌드박스 환경에서 실행되며, 추론, 계획, 도구 사용, 코드 실행, 웹 검색, 파일 읽기와 쓰기를 수행할 수 있습니다.1
아키텍처는 크게 두 인터페이스로 나뉩니다.
Agents API: 에이전트를 생성하고 실행 환경을 구성하는 제어 영역
Interactions API: 배포된 에이전트와 런타임에 통신하는 데이터 영역
즉, 에이전트를 만들고 환경을 설정하는 일과, 실제 작업을 지시하고 결과를 받는 일이 분리됩니다.1 이 구분은 운영 측면에서 중요합니다. 에이전트의 실행 조건을 미리 정의해 두고, 실제 사용자 요청은 별도의 상호작용 흐름으로 처리할 수 있기 때문입니다.
이번 업데이트가 의미하는 변화
2026년 7월 7일 발표된 업데이트의 핵심은 Managed Agents를 더 긴 작업과 더 넓은 도구 연결에 쓸 수 있게 한 것입니다.2
가장 눈에 띄는 변화는 백그라운드 실행입니다. 시간이 오래 걸리는 작업을 서버에서 비동기로 실행하고, 클라이언트는 작업 ID를 통해 상태를 확인할 수 있습니다.2 리포트 생성, 코드 분석, 대량 파일 정리처럼 즉시 응답이 어려운 작업에 적합합니다.
또 하나의 변화는 원격 MCP 서버 연결입니다. MCP는 모델이 외부 도구와 데이터에 표준 방식으로 접근하게 하는 프로토콜입니다. Managed Agents는 원격 MCP 서버 연결을 지원하며, 샌드박스 도구와 사용자 지정 함수 호출도 함께 사용할 수 있습니다.2 이는 에이전트가 고립된 대화형 모델을 넘어, 실제 업무 시스템과 연결되는 실행 주체에 가까워진다는 뜻입니다.
운영 관점에서는 자격 증명 갱신과 키 교체도 중요합니다. 기존 environment_id를 유지한 상태에서 새 네트워크 구성을 전달하면 토큰 갱신이나 키 교체가 가능하고, 파일·패키지·저장소 상태는 유지됩니다.2 에이전트를 다시 만들지 않고도 실행 환경의 접근 정보를 관리할 수 있다는 점에서 실무적인 개선입니다.
샌드박스는 장점이자 설계 기준이다
Managed Agents API에서 만든 에이전트는 기본적으로 격리된 샌드박스 환경에서 작동합니다.1 기본 상태의 에이전트는 외부 시스템, 네트워크, 사용자 인증 정보에 접근할 수 없습니다.1
이 제약은 불편함이 아니라 안전장치에 가깝습니다. 외부 데이터 소스 마운트나 네트워크 허용 목록 같은 실행 환경 구성은 Agents API를 통해 명시적으로 설정해야 합니다.1 따라서 Managed Agents를 도입할 때는 “에이전트가 무엇을 할 수 있는가”보다 “무엇에 접근하도록 허용할 것인가”를 먼저 정해야 합니다.
언제 Managed Agents를 선택할까
Managed Agents는 빠른 PoC, 내부 자동화, 문서 처리, 코드 분석, 장시간 실행되는 작업처럼 실행 환경을 빠르게 확보해야 하는 경우에 유리합니다. 에이전트가 추론만 하는 것이 아니라 파일을 읽고 쓰고, 코드를 실행하고, 도구를 호출해야 한다면 관리형 런타임의 가치가 커집니다.
다만 모든 경우에 정답은 아닙니다. 네트워크 통제, 감사, 비용 관리, 멀티클라우드 전략, 세밀한 런타임 제어가 핵심이라면 자체 오케스트레이션과 함께 비교해야 합니다.
결국 Managed Agents의 가치는 “에이전트를 만들 수 있다”가 아니라 “에이전트의 실행 환경까지 API로 다룰 수 있다”는 데 있습니다. 도입 여부를 판단할 때는 기능 목록보다 권한, 연결 범위, 운영 통제 수준을 기준으로 보는 것이 실용적입니다.
1Agent Platform의 관리형 에이전트 API 개요
2Expanding Managed Agents in Gemini API: background tasks, remote MCP and more
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.