구글 제미나이 에이전트, 개발자가 고른 서버에서 도구 실행

구글이 11월 11일 제미나이 API의 관리형 에이전트에 자체 샌드박스를 연결할 수 있게 했다. 개발자가 에이전트에 보고서 정리나 코드 테스트를 맡기면, 작업에 필요한 파일을 읽고 프로그램을 실행하는 곳을 직접 정할 수 있다. 샌드박스는 이런 작업을 다른 시스템에서 분리해 실행하는 환경이다. 구글이 제공하는 샌드박스는 계속 기본 선택지로 남는다.

변경된 것은 도구가 실행되는 장소다. 제미나이 모델 호출과 에이전트가 다음 행동을 정하는 과정, 진행 상황을 앱에 전달하는 일은 구글 쪽에서 이뤄진다. 데이토나의 연동 문서에 따르면 에이전트가 도구를 요청할 때 구글이 실행 환경에 해당 작업을 전달하고, 그곳에서 파일을 읽거나 바꾼 결과가 구글로 돌아온다. 개발자가 고른 서버에서 파일을 처리해도 도구의 결과는 에이전트가 이어서 판단하는 데 쓰인다.

작업을 처리할 서버를 고른다

개발자가 운영하는 샌드박스에서 구글 쪽으로 HTTPS 연결을 시작한다. 구글은 이 연결을 받기 위해 개발자 쪽 방화벽의 인바운드 포트를 열 필요가 없다고 설명했다. 구글이 등록한 실행 환경과 앱에서 보내는 작업은 환경 식별자로 연결된다. 앱은 제미나이 API로 요청을 보내면서 어느 환경이 도구 작업을 맡을지 지정한다.

구글은 버셀, 모달, 데이토나, 플라이닷아이오, 구글 클라우드, 클라우드플레어, E2B를 출시 파트너로 소개했다. 이 중 구글 클라우드의 연결 예시는 클라우드 런을 사용한다. 문서에는 파트너가 운영하는 샌드박스 외에 개발자가 직접 운영하는 도커 또는 루트리스 포드맨 컨테이너를 연결하는 선택지도 있다. 데이토나의 예시에서는 앱이 구글에 작업을 요청하고 데이토나가 격리된 컴퓨터를 제공한다. 앱이 동작하는 서버와 도구가 실행되는 곳을 이렇게 따로 구성할 수 있다.

작업이 끝난 뒤 파일을 보관하는 방식

구글은 5월 19일 관리형 에이전트를 처음 공개했을 때 구글이 호스팅하는 리눅스 샌드박스에서 파일 작업과 프로그램 실행을 맡겼다. 이 환경에서는 작업 시작 때 파일을 넣거나 작업 디렉터리를 묶어서 내려받는 기능을 제공한다. 구글의 환경 문서는 해당 파일 스냅샷과 초기 자료 주입, 네트워크 설정 옵션을 구글 호스팅에 한정한다. 개발자가 운영하는 환경에서는 파일을 어디에 둘지, 작업이 끝나면 환경을 언제 지울지 그쪽에서 정한다. 구글 호스팅의 경우 15분간 작업이 없으면 상태를 저장하고 실행을 중지한다. 이후 마지막 활동을 기준으로 7일 동안 환경을 보관하며, 그 안에 같은 환경을 지정해 작업을 재개할 수 있다.

데이토나는 파일의 수명이 달라지는 두 가지 구성을 문서에 실었다. 샌드박스 하나를 계속 실행하는 구성에서는 후속 요청이 앞선 요청에서 남긴 파일을 찾을 수 있다. 데이토나가 설명한 다른 구성은 요청 하나마다 새 샌드박스를 만들고 작업이 끝나면 그 공간을 삭제한다. 같은 문서에 따르면 두 번째 구성에서는 요청마다 환경을 준비하는 데 몇 초가 더 든다.

샌드박스에 남긴 파일과 제미나이 API의 작업 기록은 각각 다른 곳에서 관리한다. 구글은 유료 프로젝트가 저장 설정을 켜고 보낸 요청을 AI 스튜디오의 로그에서 볼 수 있다고 안내한다. 해당 프로젝트는 보관 기간으로 7일, 14일, 28일, 55일을 설정할 수 있다. 이 기간은 프로젝트의 요청 기록에 적용된다. 앱은 앞선 요청의 식별자를 다음 호출에 넣어 대화를 이어갈 수 있다. 데이토나에서 작업 공간을 삭제하는 시점은 별도로 정해지므로, 새 요청이 앞선 대화를 이어가더라도 이전에 작성한 파일을 다시 열 수 있는지는 샌드박스 구성에 달려 있다.

구글 호스팅과 자체 실행의 요금

관리형 에이전트와 실행 환경은 공개 프리뷰다. 구글은 프리뷰 기간에 자신이 호스팅하는 샌드박스의 컴퓨팅 비용을 청구하지 않는다고 안내한다. 모델 사용량과 과금 대상 도구의 비용에는 별도 요금이 적용된다. 구글의 가격표는 에이전트 사용료를 모델이 처리한 토큰과 호출한 도구를 기준으로 설명한다.

개발자가 별도 사업자의 샌드박스를 연결하면 그 환경의 컴퓨팅 자원은 해당 사업자의 요금 체계를 따른다. 예를 들어 데이토나는 샌드박스가 실행되는 동안 예약된 CPU·메모리·디스크 자원을 기준으로 과금하며, 중지 상태에서도 샌드박스를 유지하면 예약된 디스크에 요금을 청구한다고 안내한다. 데이토나에서 샌드박스를 삭제하면 그 환경의 자원 요금은 끝난다. 별도로 저장한 스냅샷은 이후에도 저장 요금이 붙는다.