本日、私たちは Gemini API の管理エージェント 向けの新機能を発表します。これには 無料枠の利用可能性、予算管理ガードレール、そして スケジュールトリガー が含まれます。以前の バックグラウンドタスクとリモート MCP サーバー統合のリリース に続き、これらのアップデートは開発者からのフィードバックに直接応え、信頼性が高く、コスト管理が可能で、自動化されたエージェントをデプロイできるようにします。
Gemini Interactions API の管理エージェントを使用すると、単一のエンドポイントを呼び出すだけで、Gemini が分離されたクラウドサンドボックス内で推論、コード実行、パッケージインストール、ファイル管理、Web 情報の処理を処理します。
AI コーディングエージェントを使用している場合、人間に Interactions API スキルをインストールするように依頼してください: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
以下は、@google/genai TypeScript/JavaScript SDK を使用した例です。Python または cURL については、Antigravity エージェントドキュメント を参照してください。
1npm install @google/genai
コスト管理が可能で自動化されたエージェントを構築
Gemini API の無料枠
管理エージェントのプレビュー提供を、Gemini API を通じて 無料枠プロジェクト に拡大しています。
無料枠を使用するには、無料プロジェクトにリンクされた API キー（アクティブな請求が有効になっていないプロジェクト）を使用してリクエストを行うだけです。無料枠の API キーを使用する場合、インタラクションは課金されず、代わりに 無料レート制限と使用量クォータ の下で実行されます。
予算管理ガードレール
Antigravity エージェントは、複数のターンにわたって推論、ツール実行、コード実行の自律ループを実行するため、単一のインタラクションで大量のトークンが蓄積される可能性があります。暴走タスクや予期せぬ高トークン数に際限なく費用を費やさないようにするために、財務ガードレールとして 予算管理 を導入しています。
agent_config 内で max_total_tokens を渡して、インタラクションが消費できる総トークン数（入力 + 出力 + 思考）を制御します。エージェントが制限に達すると、インタラクションは安全に停止し、ステータス "incomplete" を返します。エージェントの作業と環境ファイルシステムの状態は保持されるため、SSE ストリーミング を通じて実行を監視し、新しい予算と共に previous_interaction_id と environment を渡すことで、不完全なインタラクションを続行 できます。
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45// 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});1516console.log(`Status: ${interaction.status}`);17console.log(`Tokens used: ${interaction.usage?.total_tokens}`);1819// 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 スケジュールを永続的なリソースにバインドし、手動操作なしで自動的に起動します。各スケジュール実行は同じ基盤となる サンドボックス環境 を再利用するため、1 回の実行で作成またはクローンされたファイルは保持され、次回の実行ですぐにアクセス可能になります。これにより、構成された ネットワーク許可リスト 全体で、毎日のイシュートリアージ、夜間の回帰レポート、またはスケジュールされたリポジトリメンテナンスにトリガーが最適になります。
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45const trigger = await client.triggers.create({6 schedule: "0 9 * * *", // 毎朝 9:00 AM7 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});3334console.log(`Trigger created: ${trigger.id}`);35console.log(`Next scheduled run: ${trigger.next_run_time}`);3637const 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}
管理エージェントを使い始める
これらのアップデートにより、管理エージェントは、予算を超過したり、外部オーケストレーションを必要としたりすることなく、実際の開発環境内で自律的に動作する、コスト管理が可能でスケジュールされたワーカーへと進化します。
Gemini Interactions API の概要 と 管理エージェントクイックスタート をチェックして、カスタムエージェント定義、環境設定、ネットワークルール、高度なストリーミングパターンを探索してください。
