Gemini APIマネージドエージェント：3.6 Flash、フックなどの新機能

Gemini APIのマネージドエージェント（Managed Agents）が大幅にアップデートされ、デフォルトモデルがGemini 3.6 Flashになりました。さらに、環境フック（Environment Hooks）、予算制御、スケジュールトリガー、無料ティアアクセスといった新機能が追加され、開発者はより信頼性が高く、本番環境に即したエージェントを構築できるようになります。これらの機能は、以前リリースされたバックグラウンドタスクやリモートMCPサーバー統合を基盤としています。

マネージドエージェントはGemini Interactions APIを通じて、単一のAPI呼び出しで、隔離されたクラウドサンドボックス内での推論、コード実行、パッケージインストール、ファイル管理、Web検索を調整します。AIコーディングアシスタントを利用している場合、ターミナルでnpx skills add google-gemini/gemini-skills --skill gemini-interactions-apiを実行すると、Interactions APIスキルを簡単に追加できます。

Gemini 3.6 Flashがデフォルトモデルに

antigravity-preview-05-2026エージェント以降、マネージドエージェントはデフォルトでGemini 3.6 Flashを実行します。コード変更は不要で、次回のインタラクションから自動的に適用されます。また、agent_config.modelパラメータを指定することで、モデルを明示的に選択することも可能です。低コストが求められる場合はGemini 3.5 Flash-Liteを、特定のモデルに固定したい場合はそのモデルを指定します。サポートされるモデルは以下の通りです：

• Gemini 3.6 Flash（デフォルト）：推論、コーディング、ツール利用にバランスの取れたモデル。
• Gemini 3.5 Flash：汎用的なエージェントワークフロー向けの前世代モデル。
• Gemini 3.5 Flash-Lite：Gemini 3.5ファミリーの中で最も低レイテンシーかつ低コスト。

環境フック：サンドボックス内でのツール呼び出しの制御

環境フックを使用すると、エージェントがサンドボックス内でツールを呼び出す前後でカスタムスクリプトを実行できます。環境に.agents/hooks.jsonを追加し、pre_tool_executionまたはpost_tool_executionイベントのハンドラーを定義します。matcherフィールドは正規表現をサポートしており、パイプで複数のツールを指定したり、アスタリスクですべてを対象とできます。

• code_executionやwrite_fileの前にセキュリティゲートスクリプトを実行し、拒否の判断をモデルコンテキストに渡す。
• すべてのツール実行後に自動フォーマットスクリプトを実行し、コードスタイルを統一する。

フックはHTTPタイプもサポートし、外部エンドポイントに直接POSTリクエストを送信できます。AIネイティブ投資銀行のOffdealは、post_tool_executionフックを利用してリモートサンドボックス内で自動画像検証を実現し、会社のロゴが正しい企業、適切なサイズとアスペクト比、透明背景、白スライド上での高いコントラストを満たすことを確認しています。

コスト管理と自動化機能

マネージドエージェントは無料ティアプロジェクトでも利用可能になり、アクティブな課金がないプロジェクトでもAPIキーを使ってエージェントワークフローを試せます。マルチターンの自律ループによるトークン消費を抑えるため、max_total_tokensパラメータで上限を設定できます。制限に達すると実行は安全に一時停止され、ステータスが「incomplete」になります。環境状態は保持されるため、previous_interaction_idと新しい予算を指定して続行可能です。

スケジュールトリガーにより、エージェント、環境、プロンプト、cronスケジュールをバインドした永続リソースを作成し、手動介入なしで定期的にタスクを実行できます。各実行は同じサンドボックスを再利用するため、ファイルは実行間で保持されます。

新しいEnvironments APIを使用すると、コードからサンドボックスセッションの一覧表示、検査、削除が可能です。切断後に環境IDを回復したり、パイプライン完了後にサンドボックスをクリーンアップして7日間のTTLを待たずに済みます。

これらのアップデートにより、マネージドエージェントはコスト管理可能でスケジュール可能な自律ワーカーへと進化し、外部オーケストレーションなしで実際の開発環境内で自律的に動作します。詳細なカスタムエージェント定義、環境設定、ネットワークルール、高度なストリーミングパターンについては、Gemini Interactions APIの概要とマネージドエージェントのクイックスタートをご覧ください。