AI 코딩 · 2026년 7월 9일 · 약 7분

Gemini API Managed Agents 사용법, background 실행과 remote MCP로 긴 AI 작업을 맡기는 방법

Google이 Gemini API Managed Agents에 background 실행, remote MCP 서버, custom function calling, credential refresh를 추가했다. 긴 AI 에이전트 작업을 제품에 붙일 때 무엇을 먼저 설계해야 하는지 정리했다.

• Gemini API Managed Agents
• Gemini API
• remote MCP
• AI 에이전트
• background execution

출처: Google The Keyword

Google이 2026년 7월 7일 Gemini API의 Managed Agents 기능을 확장했습니다. 핵심은 긴 작업을 서버에서 비동기로 돌리는 background 실행, 외부 도구와 연결하는 remote MCP 서버, custom function calling, 그리고 토큰이나 API 키를 바꿔도 같은 작업 환경을 이어가는 credential refresh입니다.

초보자에게는 이름이 어렵게 들릴 수 있지만 방향은 단순합니다. AI에게 “자료를 찾고, 코드를 실행하고, 파일을 만들고, 내부 도구를 호출하는” 일을 맡길 때 일반 채팅 응답처럼 한 번에 기다리지 않아도 됩니다. Google은 Managed Agents가 격리된 클라우드 샌드박스에서 추론, 코드 실행, 패키지 설치, 파일 관리, 웹 정보 사용을 한 엔드포인트로 다루도록 설계됐다고 설명합니다.

핵심 키워드

• Gemini API Managed Agents 사용법
• Gemini background execution
• Gemini remote MCP
• AI 에이전트 비동기 작업
• Gemini API 에이전트 개발

무엇이 달라졌나

기존 모델 API는 짧은 요청과 응답에 잘 맞았습니다. 하지만 제품 안의 에이전트 작업은 더 깁니다. 저장소를 분석하거나, 보고서를 만들거나, 여러 도구를 거쳐 결과를 검토해야 합니다. 이번 업데이트는 그런 작업을 “계속 연결해 둔 HTTP 요청”이 아니라 서버 쪽 interaction으로 다루게 해줍니다.

background 실행은 채팅이 아니라 작업 큐에 가깝다

Google 안내에 따르면 background: true를 넘기면 API가 즉시 interaction ID를 반환하고, 앱은 그 ID로 상태를 조회하거나 진행 상황을 스트리밍하고 나중에 다시 연결할 수 있습니다. 사용자는 화면을 닫았다가 돌아와도 “작업이 어디까지 왔는지” 확인할 수 있어야 합니다.

제품에 붙일 때 먼저 정할 것

• 작업 상태를 대기, 진행 중, 사람 확인 필요, 완료, 실패로 나눠 보여준다.
• 긴 작업은 예상 소요 시간과 중단 버튼을 함께 둔다.
• 최종 결과만 저장하지 말고 중요한 도구 호출과 사용자 승인 지점을 기록한다.
• 실패 시 같은 interaction을 다시 이어갈지, 새 작업으로 재시작할지 기준을 정한다.
• 민감한 데이터가 들어가는 작업은 처음부터 샌드박스와 네트워크 범위를 제한한다.

remote MCP는 내부 도구 연결을 단순하게 만든다

remote MCP 서버 지원은 개발자에게 특히 중요합니다. 예전에는 에이전트가 사내 데이터베이스나 업무 API를 쓰게 하려면 별도 프록시와 도구 호출 규칙을 직접 만들어야 했습니다. 이제는 interaction에 mcp_server 도구를 함께 넘겨 Gemini의 샌드박스에서 외부 도구와 통신하는 구조를 설계할 수 있습니다.

복사해서 쓰는 첫 설계 프롬프트

개발자가 바로 코드를 붙이기 전에, 에이전트 작업 범위를 먼저 잡아두면 실패가 줄어듭니다. 아래 템플릿의 대괄호만 바꿔 넣고 Gemini나 다른 코딩 도구에게 설계 검토를 먼저 맡겨보세요.

Managed Agents 설계 템플릿

• 목표: Gemini API Managed Agents로 [업무 이름]을 처리한다.
• 작업 길이: 평균 [예상 시간]이 걸리므로 background 실행을 쓴다.
• 사용 도구: [Google Search / code execution / remote MCP 서버 / custom function]을 사용한다.
• 사람 확인: [데이터 변경 / 고객 발송 / 비용 발생] 전에는 반드시 승인 상태로 멈춘다.
• 상태 표시: 사용자에게 대기, 진행 중, 확인 필요, 완료, 실패 중 하나를 보여준다.
• 보안 기준: 민감 정보는 로그에 남기지 않고, 외부 도구는 필요한 읽기 권한부터 시작한다.

처음부터 자동 실행 범위를 넓히지 않는다

Managed Agents가 강력해질수록 중요한 것은 “무엇을 자동화할 수 있나”보다 “어디서 멈출 것인가”입니다. background 실행은 작업을 오래 끌고 갈 수 있고, remote MCP는 내부 도구까지 연결할 수 있습니다. 그래서 첫 적용은 읽기 전용 분석, 초안 생성, 검토 목록 만들기처럼 되돌리기 쉬운 일부터 시작하는 편이 안전합니다.

흔한 실수와 쉬운 수정

• 실수: 완료될 때까지 화면을 비워 둔다. 수정: 진행 상태와 마지막 작업 메시지를 보여준다.
• 실수: MCP 도구에 넓은 쓰기 권한을 준다. 수정: 읽기 전용 도구로 시작하고 변경 작업은 별도 승인으로 분리한다.
• 실수: 토큰 만료를 예외 상황으로만 처리한다. 수정: credential refresh 흐름을 정상 시나리오에 넣는다.
• 실수: 모든 결과를 곧바로 사용자에게 보여준다. 수정: 내부 로그와 사용자용 요약을 나눠 저장한다.
• 실수: “에이전트가 알아서 판단”하게 둔다. 수정: 중단 기준, 금지 작업, 사람 확인 조건을 프롬프트와 코드 양쪽에 둔다.

오늘 바로 해볼 작은 실험은 간단합니다. 실제 고객 데이터가 없는 샘플 문서와 읽기 전용 도구 하나를 준비하고, background 실행으로 “자료를 읽고 체크리스트를 만드는” 작업만 맡겨보세요. 그다음 상태 조회, 재연결, 실패 처리, 승인 대기 화면이 자연스러운지 확인하면 됩니다.