Gemini API, 관리형 에이전트의 새로운 기능 공개

Gemini API 관리형 에이전트의 새로운 기능

Gemini 3.6 Flash 기본 설정

Gemini API의 관리형 에이전트는 이제 기본적으로 Gemini 3.6 Flash를 사용합니다. 이는 코드 변경 없이 자동으로 적용되며, 다음 상호작용에서 자동으로 선택됩니다. 사용자는 agent_config.model을 통해 명시적으로 모델을 선택할 수도 있습니다. 비용을 절감하고 싶다면 Gemini 3.5 Flash-Lite를 사용할 수 있으며, 선호하는 모델을 고정할 수도 있습니다.

import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all dependencies in package.json, upgrade outdated packages, and verify the build by running npm test.",
  environment: "remote",
  agent_config: {
    type: "antigravity",
    model: "gemini-3.5-flash-lite",
  },
});
console.log(interaction.output_text);

지원되는 모델은 다음과 같습니다:

Gemini 3.6 Flash (gemini-3.6-flash, 기본값): 추론, 코딩, 도구 사용에 적합한 균형 잡힌 모델.
Gemini 3.5 Flash (gemini-3.5-flash): 일반적인 에이전트 워크플로우에 적합한 이전 세대 모델.
Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite): Gemini 3.5 계열에서 가장 낮은 지연 시간과 비용.

환경 훅: 샌드박스 내에서 도구 호출 차단, 린트 및 감사

환경 훅을 사용하면 에이전트가 샌드박스 내에서 도구를 호출하기 전후에 사용자 정의 스크립트를 실행할 수 있습니다. .agents/hooks.json 파일을 환경에 추가하면 런타임이 pre_tool_execution 또는 post_tool_execution 이벤트에서 핸들러를 실행합니다. matcher 필드는 정규 표현식을 지원하여 여러 도구를 대상으로 하거나 *로 모든 것을 포착할 수 있습니다.

{
  "security-gate": {
    "pre_tool_execution": [
      {
        "matcher": "code_execution|write_file",
        "hooks": [
          {
            "type": "command",
            "command": "python3 /.agents/hooks-scripts/gate.py",
            "timeout": 10
          }
        ]
      }
    ]
  },
  "auto-format": {
    "post_tool_execution": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "python3 /.agents/hooks-scripts/auto_lint.py",
            "timeout": 15
          }
        ]
      }
    ]
  }
}

이 구성에서는:

security-gate 그룹이 code_execution 또는 write_file 호출 전에 gate.py를 실행합니다. 스크립트가 {"decision": "deny", "reason": "..."}를 반환하면 도구 호출이 건너뛰어지고 거부 이유가 모델의 컨텍스트에 전달됩니다.
auto-format 그룹이 모든 도구가 완료된 후 auto_lint.py를 실행하여 코드 스타일을 강제합니다.

훅은 외부 엔드포인트에 직접 POST하는 HTTP 타입 핸들러도 지원합니다. 완전한 HTTP 훅 정의와 실패 처리 의미론은 훅 문서를 참조하세요.

비용 제어 및 자동화 기능

무료 티어 이용 가능성

관리형 에이전트는 이제 무료 티어 프로젝트에서도 사용할 수 있습니다. 개발자는 활성 결제가 없는 프로젝트의 API 키를 사용하여 에이전트 워크플로우를 실험할 수 있습니다.

예산 제어

관리형 에이전트가 다중 턴 자율 루프를 실행하기 때문에 복잡한 작업은 상당한 토큰 예산을 소모할 수 있습니다. 무한정 실행되는 작업을 방지하기 위해 agent_config에 max_total_tokens를 전달하여 총 소비량(입력 + 출력 + 사고)을 제한할 수 있습니다. 에이전트가 한계에 도달하면 실행이 안전하게 일시 중지되고 상호작용은 상태: "incomplete"로 반환됩니다. 환경 상태는 보존되며, 새로운 예산과 함께 previous_interaction_id를 전달하여 중단된 지점에서 계속할 수 있습니다.

const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all modules in this repo and generate a migration report.",
  agent_config: {
    type: "antigravity",
    max_total_tokens: 10000,
  },
  environment: "remote",
});

트리거를 사용한 예약 실행

예약 트리거를 사용하여 반복적인 에이전트 작업을 자동화할 수 있습니다. 트리거는 에이전트, 환경, 프롬프트 및 크론 스케줄을 지속적인 리소스로 바인딩하여 수동 개입 없이 실행됩니다. 각 실행은 동일한 샌드박스를 재사용하므로 파일이 실행 간에 지속됩니다.

환경 API

환경 API를 사용하면 코드에서 샌드박스 세션을 나열, 검사 및 삭제할 수 있습니다. 연결이 끊긴 후 환경 ID를 복구하거나 파이프라인이 완료되면 샌드박스를 정리할 수 있습니다.

관리형 에이전트 시작하기

이 업데이트는 관리형 에이전트를 비용이 제어되고 예약된 작업자로 변환하여 실제 개발 환경 내에서 자율적으로 작동할 수 있게 합니다. 예산을 초과하지 않으면서 외부 오케스트레이션이 필요하지 않습니다. Gemini Interactions API 개요와 관리형 에이전트 빠른 시작을 확인하여 사용자 정의 에이전트 정의, 환경 구성, 네트워크 규칙 및 고급 스트리밍 패턴을 탐색하세요.

파이랩 정리