Gemini API, 관리 에이전트 확장 업데이트 발표

Gemini API의 관리 에이전트 확장 업데이트 발표

새로운 기능 소개

Google DeepMind의 Philipp Schmid 개발자 관계 엔지니어와 Mariano Cocirio 제품 매니저는 Gemini API의 관리 에이전트에 대한 새로운 기능을 발표했습니다. 이번 업데이트는 비동기 상호작용을 위한 백그라운드 실행, 원격 MCP 서버 연결, 사용자 지정 함수 호출 및 상호작용 간 자격 증명 갱신을 포함합니다. 이러한 기능은 개발자 피드백과 제품 요구 사항을 직접적으로 반영하여 신뢰할 수 있고 프로덕션 준비가 된 에이전트를 구축할 수 있도록 돕습니다.

관리 에이전트의 기능

Gemini 상호작용 API의 관리 에이전트를 통해 단일 엔드포인트를 호출하면, Gemini가 격리된 클라우드 샌드박스 내에서 추론, 코드 실행, 패키지 설치, 파일 관리 및 웹 정보 처리를 수행합니다. AI 코딩 에이전트라면, Interactions API 스킬을 설치하도록 권장합니다: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api. JavaScript SDK인 @google/genai를 사용한 예제를 아래에서 확인할 수 있으며, Python이나 cURL에 대한 정보는 Antigravity 에이전트 문서를 참조하세요.

확장된 기능으로 자율 에이전트 구축

1. 장기 실행 백그라운드 작업: 장기 실행 작업을 위해 HTTP 연결을 유지하는 것은 취약할 수 있습니다. 서버에서 비동기적으로 상호작용을 실행하려면 background: true를 전달하세요. API는 즉시 ID를 반환하며, 클라이언트 애플리케이션은 이를 사용하여 상태를 폴링하거나 진행 상황을 스트리밍하거나 에이전트가 원격에서 작업을 완료하는 동안 나중에 다시 연결할 수 있습니다. 자세한 내용은 백그라운드 실행 가이드를 참조하세요.

2. 원격 MCP 서버 통합: 개인 데이터베이스나 내부 API에 접근하기 위해 사용자 지정 프록시 미들웨어를 작성하는 대신, 이제 관리 에이전트를 원격 모델 컨텍스트 프로토콜(MCP) 서버에 직접 연결할 수 있습니다. 원격 도구와 내장 샌드박스 기능을 혼합하여 사용할 수 있습니다. 상호작용 시 mcp_server 도구를 Google 검색이나 코드 실행과 함께 전달하여 에이전트가 보안 샌드박스에서 엔드포인트와 통신할 수 있도록 합니다. 외부 도구와 API로 에이전트를 확장할 때는 모범 사례를 따르세요.

3. 샌드박스 도구와 함께 사용자 지정 함수 호출: 로컬 실행을 위해 내장 샌드박스 도구와 함께 사용자 지정 도구를 추가하세요. API는 단계 매칭을 사용합니다. 내장 도구는 서버에서 자동으로 실행되며, 사용자 지정 함수는 상호작용을 requires_action으로 전환하여 클라이언트가 로컬 비즈니스 로직을 실행하도록 합니다.

4. 네트워크 자격 증명 갱신: 액세스 토큰과 단기 API 키는 만료됩니다. 기존 environment_id와 함께 새로운 네트워크 구성을 다음 상호작용에서 전달하여 자격 증명을 갱신하거나 키를 회전할 수 있습니다. 새로운 규칙은 즉시 이전 규칙을 대체합니다. 샌드박스는 파일 시스템 상태, 설치된 패키지 및 복제된 저장소를 그대로 유지합니다.

관리 에이전트 시작하기

이러한 업데이트는 관리 에이전트를 비동기 작업자로 전환하여 실제 개발 환경 내에서 애플리케이션을 차단하지 않고 작동할 수 있도록 합니다. Gemini 상호작용 API 개요와 관리 에이전트 빠른 시작 가이드를 확인하여 사용자 지정 에이전트 정의, 환경 구성, 네트워크 규칙 및 고급 스트리밍 패턴을 탐색하세요.