Gemini API Managed Agents: 무료 티어, 트리거 및 추가 기능

@GoogleAIStudio
영어1일 전 · 2026년 7월 16일
184K
710
73
35
419

TL;DR

Google AI Studio가 Gemini API Managed Agents를 위한 무료 티어 액세스, 예산 관리 및 예약 트리거 기능을 도입하여 자율적이고 비용 효율적인 작업 자동화를 지원합니다.

오늘은 Gemini API 의 Managed Agents 에 새로운 기능이 추가되었음을 발표합니다. 여기에는 무료 등급 이용 가능, 예산 관리 가드레일, 예약 실행 트리거가 포함됩니다. 이전에 출시된 백그라운드 작업 및 원격 MCP 서버 통합에 이어, 이번 업데이트는 개발자 피드백을 직접 반영하여 안정적이고 비용이 통제되며 자동화된 에이전트를 배포할 수 있도록 합니다.

Gemini Interactions API 의 Managed Agents 를 사용하면 단일 엔드포인트를 호출하기만 하면 Gemini 가 격리된 클라우드 샌드박스 내에서 추론, 코드 실행, 패키지 설치, 파일 관리 및 웹 정보 처리를 처리합니다.

AI 코딩 에이전트를 사용하는 경우, 사용자에게 Interactions API 스킬을 설치하도록 요청하세요: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

다음은 @google/genai TypeScript/JavaScript SDK를 사용한 예제입니다. Python 또는 cURL의 경우 Antigravity 에이전트 문서를 참조하세요.

bash
1npm install @google/genai

비용이 통제된 자동화 에이전트 구축

Gemini API 의 무료 등급 이용 가능

Managed Agents 의 프리뷰 이용 가능 범위를 Gemini API 의 무료 등급 프로젝트로 확장합니다.

무료 등급을 사용하려면 무료 프로젝트에 연결된 API 키(활성 결제가 설정되지 않은 프로젝트)를 사용하여 요청하면 됩니다. 무료 등급 API 키를 사용하는 경우, 상호작용에 대한 요금이 청구되지 않으며 무료 속도 제한 및 사용량 할당량에 따라 실행됩니다.

예산 관리 가드레일

Antigravity 에이전트는 여러 턴에 걸쳐 추론, 도구 실행 및 코드 실행의 자율적인 루프를 실행하므로, 단일 상호작용으로 상당한 토큰이 누적될 수 있습니다. 통제 불능의 작업이나 예상치 못하게 높은 토큰 수에 끝없이 비용을 지출하지 않도록 하기 위해, 예산 관리를 재정적 가드레일로 도입합니다.

agent_config 내에 max_total_tokens 를 전달하여 상호작용이 소비할 수 있는 총 토큰(입력 + 출력 + 사고)을 제어합니다. 에이전트가 한도에 도달하면 상호작용이 안전하게 중지되고 status: "incomplete" 를 반환합니다. 에이전트의 작업 및 환경 파일 시스템 상태는 보존되므로, SSE 스트리밍을 통해 실행을 모니터링하고, 새로운 예산과 함께 previous_interaction_idenvironment 를 전달하여 중단된 지점에서 바로 불완전한 상호작용을 계속할 수 있습니다.

typescript
1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. 최대 10,000 토큰으로 제한된 엄격한 예산 관리로 다단계 감사 시작
6const interaction = await client.interactions.create({
7 agent: "antigravity-preview-05-2026",
8 input: "Clone https://github.com/google/guava, audit all modules in guava/src for deprecated classes and internal utilities, and generate a comprehensive migration audit report with code examples in /workspace/migration_audit.md.",
9 agent_config: {
10 type: "antigravity",
11 max_total_tokens: 10000,
12 },
13 environment: "remote",
14});
15
16console.log(`Status: ${interaction.status}`);
17console.log(`Tokens used: ${interaction.usage?.total_tokens}`);
18
19// 2. "continue" 전송 시 계속 가능
20if (interaction.status === "incomplete") {
21 const continuation = await client.interactions.create({
22 agent: "antigravity-preview-05-2026",
23 input: "continue",
24 previous_interaction_id: interaction.id,
25 environment: interaction.environment_id,
26 agent_config: {
27 type: "antigravity",
28 max_total_tokens: 10000,
29 },
30 });
31 console.log(`Continuation status: ${continuation.status}`);
32}

트리거를 통한 예약 실행

외부 스케줄링 스크립트를 실행하거나 cron 작업을 위한 전용 인프라를 유지 관리하는 대신, 이제 예약 트리거를 사용하여 반복적인 에이전트 작업을 자동화할 수 있습니다.

트리거는 에이전트, 환경, 프롬프트 및 cron 일정을 수동 개입 없이 자동으로 실행되는 지속적인 리소스로 바인딩합니다. 각 예약 실행은 동일한 기본 샌드박스 환경을 재사용하므로, 한 번 실행에서 생성되거나 복제된 파일은 다음 실행에도 유지되어 즉시 액세스할 수 있습니다. 따라서 트리거는 구성된 네트워크 허용 목록 내에서 일일 이슈 분류, 야간 회귀 보고 또는 예약된 저장소 유지 관리에 이상적입니다.

typescript
1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const trigger = await client.triggers.create({
6 schedule: "0 9 * * *", // 매일 오전 9:00
7 time_zone: "America/Los_Angeles",
8 display_name: "daily-issue-solver",
9 interaction: {
10 agent: "antigravity-preview-05-2026",
11 input: [
12 {
13 type: "text",
14 text: "Review open PRs in our repo for new comments and address feedback. Check for new issues labeled 'accepted', skip any tracked in /workspace/solved-issues/, fix the rest, and open PRs. Save reports to /workspace/solved-issues/.",
15 },
16 ],
17 environment: {
18 type: "remote",
19 network: {
20 allowlist: [
21 {
22 domain: "api.github.com",
23 transform: {
24 Authorization: "Bearer ghp_example_token",
25 },
26 },
27 { domain: "github.com" },
28 ],
29 },
30 },
31 },
32});
33
34console.log(`Trigger created: ${trigger.id}`);
35console.log(`Next scheduled run: ${trigger.next_run_time}`);
36
37const executions = await client.triggers.listExecutions(trigger.id);
38for (const ex of executions.trigger_executions) {
39 console.log(`${ex.id}: ${ex.status} (${ex.start_time} - ${ex.end_time})`);
40}

Managed Agents 시작하기

이번 업데이트를 통해 Managed Agents 는 비용이 통제되고 예약된 작업자로 전환되어, 실제 개발 환경 내에서 자율적으로 작동하며 예산을 초과하거나 외부 오케스트레이션이 필요하지 않습니다.

Gemini Interactions API 개요Managed Agents 빠른 시작을 확인하여 사용자 정의 에이전트 정의, 환경 구성, 네트워크 규칙 및 고급 스트리밍 패턴을 살펴보세요.

YouMind에서 다시 만들기

Turn one viral article into a full content workflow

Collect the source, decode the pattern, create assets, draft the story, and distribute from one AI workspace.

Explore YouMind
크리에이터를 위해

당신의 Markdown을 깔끔한 𝕏 글로

직접 쓴 장문을 올릴 때 이미지, 표, 코드 블록을 𝕏에 맞게 정리하는 일은 번거롭습니다. YouMind는 전체 Markdown 초안을 깔끔하고 바로 게시할 수 있는 𝕏 글로 바꿔 줍니다.

Markdown → 𝕏 사용해 보기

분석할 패턴 더 보기

최근 바이럴 아티클

더 많은 바이럴 아티클 보기