Gemini API の管理型エージェントが、デフォルトで Gemini 3.6 Flash になりました。新しい環境フックにより、サンドボックス内でのツール呼び出しをブロック、リント、監査できます。また、予算管理、スケジュールトリガー、無料枠アクセスも追加されました。
Gemini API の管理型エージェント に、環境フック、モデル選択、無料枠アクセスが追加されました。これらの機能は、バックグラウンドタスクとリモート MCP サーバー統合を導入した以前のリリースを基盤としています。
Gemini Interactions API の管理型エージェントを使用すると、単一の API 呼び出しで、分離されたクラウドサンドボックス内での推論、コード実行、パッケージインストール、ファイル管理、ウェブ検索を調整できます。
AI コーディングアシスタントを使用している場合は、ターミナルで以下を実行して、Interactions API スキルへのアクセスを許可します：npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
以下は、@google/genai TypeScript/JavaScript SDK を使用した例です。Python または cURL の場合は、反重力エージェントのドキュメント を参照してください。
1npm install @google/genai
Gemini 3.6 Flash がデフォルトに
antigravity-preview-05-2026 エージェントは、デフォルトで Gemini 3.6 Flash を実行するようになりました。コードの変更は必要ありません。次のインタラクションから自動的に適用されます。
また、インタラクションまたは管理型エージェントを作成する際に、agent_config.model を渡すことで、モデルを明示的に選択することもできます。Gemini 3.5 Flash-Lite を使用してコストを抑えたり、好みのモデルに固定したりできます。
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45const interaction = await client.interactions.create({6 agent: "antigravity-preview-05-2026",7 input: "package.json 内のすべての依存関係を監査し、古いパッケージをアップグレードし、npm test を実行してビルドを確認してください。",8 environment: "remote",9 agent_config: {10 type: "antigravity",11 model: "gemini-3.5-flash-lite",12 },13});1415console.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 イベントでハンドラーを実行します。
1{2 "security-gate": {3 "pre_tool_execution": [4 {5 "matcher": "code_execution|write_file",6 "hooks": [7 {8 "type": "command",9 "command": "python3 /.agents/hooks-scripts/gate.py",10 "timeout": 1011 }12 ]13 }14 ]15 },16 "auto-format": {17 "post_tool_execution": [18 {19 "matcher": "*",20 "hooks": [21 {22 "type": "command",23 "command": "python3 /.agents/hooks-scripts/auto_lint.py",24 "timeout": 1525 }26 ]27 }28 ]29 }30}
この設定では：
- security-gate グループは、code_execution または write_file 呼び出しの前に gate.py を実行します。スクリプトが {"decision": "deny", "reason": "..."} を返した場合、ツール呼び出しはスキップされ、拒否理由がモデルのコンテキストに渡されます。
- auto-format グループは、すべてのツール終了後に auto_lint.py を実行し、コードスタイルを適用します。
- フックは、外部エンドポイントに直接 POST する http タイプのハンドラーもサポートします。
完全な HTTP フック定義と障害処理のセマンティクスについては、フックのドキュメント を参照してください。
チームはすでにフックを使用して、本番環境に対応した検証パイプラインを構築しています。例えば、AI ネイティブ投資銀行の OffDeal は、post_tool_execution フックを使用して、リモートサンドボックス内で自動画像検証を実行しています。
OffDeal は AI ネイティブの投資銀行であり、Archie は私たちの銀行員が毎日使用する AI アナリストです。銀行員が使用できるデッキに求められる条件の一つは会社のロゴです。バイヤーテーブル、スポンサーカラム、トゥームストーングリッドなど、1 つのデッキに 30 以上のロゴが含まれることも多く、それぞれが正しい会社のもので、適切なサイズとアスペクト比であり、名前が含まれ、背景が透明で、白いスライドに配置したときに高いコントラストがなければなりません。
エージェントフック以前は、これを Gemini の管理型エージェントで行うことはできませんでした。サンドボックスはリモートにあるため、検証コードを実行する場所がありませんでした。フックを使えば、Archie が会社リストを書き込んだ瞬間に、post_tool_execution フックがサンドボックス内でパイプラインをトリガーし、候補を取得し、ピクセルレベルの品質チェックを実施し、Gemini Vision で各ロゴを検証し、デッキに許可される画像のみを含む承認済みファイルのマニフェストを公開します。
— Alston Lin, OffDeal 創業者兼 CTO
コスト管理と自動化機能
無料枠の利用
管理型エージェントが 無料枠プロジェクト で利用可能になりました。開発者は、アクティブな請求がないプロジェクトの API キー を使用して、エージェントワークフローを試すことができます。
予算管理
管理型エージェントはマルチターンの自律ループを実行するため、複雑なタスクは大量のトークン予算を消費する可能性があります。タスクの暴走を防ぐために、agent_config 内で max_total_tokens を渡すことで、総消費量（入力 + 出力 + 思考）を制限できます。
エージェントが制限に達すると、実行は安全に一時停止され、インタラクションは status: "incomplete" を返します。環境状態は保持されるため、新しい予算で previous_interaction_id を渡すことで、停止した場所から続行 できます。
1const interaction = await client.interactions.create({2 agent: "antigravity-preview-05-2026",3 input: "このリポジトリ内のすべてのモジュールを監査し、移行レポートを生成してください。",4 agent_config: {5 type: "antigravity",6 max_total_tokens: 10000,7 },8 environment: "remote",9});
トリガーによるスケジュール実行
スケジュールトリガー を使用して、定期的なエージェントタスクを自動化します。トリガーは、エージェント、環境、プロンプト、cron スケジュールを永続的なリソースにバインドし、手動操作なしで実行されます。各実行は同じサンドボックスを再利用するため、ファイルは実行間で保持されます。
Environments API
Environments API を使用すると、コードからサンドボックスセッションを一覧表示、検査、削除できます。切断後に環境 ID を回復したり、7 日間の TTL を待たずにパイプライン終了時にサンドボックスをクリーンアップしたりできます。
管理型エージェントを使い始める
これらのアップデートにより、管理型エージェントは、予算を超過したり外部オーケストレーションを必要としたりすることなく、実際の開発環境内で自律的に動作する、コスト管理されたスケジュール型ワーカーに変わります。
Gemini Interactions API の概要 と管理型エージェントクイックスタート を参照して、カスタムエージェント定義、環境設定、ネットワークルール、高度なストリーミングパターンを確認してください。
