Gemini API のマネージド エージェントは、構成可能なエージェント ハーネスを提供します。1 回の API 呼び出しで、エージェントが推論、コードの実行、ファイルの管理、ウェブの自律的な閲覧を行う Linux サンドボックスがプロビジョニングされます。
クイックスタート
最初のエージェント呼び出しを行い、レスポンスをストリーミングして、カスタム エージェントを構築します。
Antigravity エージェント
デフォルト エージェントの機能、ツール、マルチモーダル入力、料金。
AI Studio のエージェント
コードを記述せずにエージェントのプロトタイピングを行うためのビジュアル プレイグラウンド。
利用可能なマネージド エージェント
- 反重力エージェント: Gemini 3.5 Flash を搭載した汎用マネージド エージェント。Google がホストする安全な Linux サンドボックス内でコードを実行し、ファイルを管理し、ウェブを検索します。独自の指示、スキル、データで拡張して、カスタム エージェントを構築できます。
- Deep Research: 市場分析、デュー デリジェンス、文献レビューなどのユースケース向けに、複数ステップからなるリサーチタスクを計画、実行、統合する自律型リサーチ エージェント。
セキュリティとベスト プラクティス
すべてのエージェントは、OS レベルで分離されたサンドボックス環境で実行されます。サンドボックスは、デフォルトで無制限の下りネットワーク アクセス権を持っています。許可リストを使用して、ネットワーク アクセスを制限または無効にできます。
ネットワーク アクセス
デフォルトでは、環境には無制限のアウトバウンド ネットワーク アクセスがあります。network 許可リストを使用して、下り（外向き）トラフィックを特定のドメインまたはワイルドカード パターンに制限します。構成の詳細については、ネットワーク許可リスト（AI Studio）またはネットワーク ルール（API）をご覧ください。
外部ツールと API
外部ツールや API を接続して、エージェントを拡張できます。信頼できるソースのツールのみを使用し、権限を必要最小限の範囲に限定します。認証情報は、下り（外向き）プロキシ ヘッダー変換を介して安全に挿入され、サンドボックス内で公開されることはありません。エージェントはアクセス可能な認証情報を使用できるため、完全なスコープを付与してもよい認証情報のみを提供してください。
- 最小権限のサービス アカウントまたは API キーを使用します。
- 有効期間の長い鍵よりも有効期間の短いトークンを優先します。
- 完全なスコープを付与してもよい認証情報のみを指定してください。
- 認証情報を定期的にローテーションします。
ヘッダー変換の構成の詳細については、認証情報をご覧ください。
人間による監視
特に、データを変更するタスクや外部システムとやり取りするタスクについては、出力をデプロイする前に必ず検証してください（生成されたコード、データ変換、構成の変更など）。
料金
マネージド エージェントは、Gemini モデルのトークンとツールの使用量に基づく従量課金制モデルを使用します。1 回のインタラクションで複数の推論ループがトリガーされ、通常は 10 万～ 300 万個のトークンが消費されます。プレビュー期間中は、環境コンピューティングの料金は発生しません。タスクごとの内訳については、推定費用をご覧ください。
上限
| 上限 | 説明 |
|---|---|
| 環境の有効期間 | 環境は、非アクティブ状態が 7 日間続くと完全に削除されます。 |
| VM のスピンダウン | VM は、リソースを節約するために、操作が行われない状態がしばらく続くとシャットダウンします。次のリクエストは、状態を復元します（コールド スタート）。 |
| プリインストールされているソフトウェア | Python 3.12 と Node.js 22 を使用する Ubuntu ベースの環境。環境のベースイメージの詳細については、プリインストールされたソフトウェアをご覧ください。 |
| 最大エージェント数 | 管理対象エージェントは最大 1,000 個まで作成できます。 |
エージェント フレームワーク
次のフレームワークと SDK を使用して、Gemini でエージェントを構築することもできます。
- LangChain / LangGraph: グラフ構造を使用して、ステートフルで複雑なアプリケーション フローとマルチエージェント システムを構築します。
- LlamaIndex: Gemini エージェントをプライベート データに接続して、RAG 強化ワークフローを実現します。
- CrewAI: 共同作業を行うロールプレイングの自律型 AI エージェントをオーケストレートします。
- Vercel AI SDK: JavaScript/TypeScript で AI を活用したユーザー インターフェースとエージェントを構築します。
- Google ADK: 相互運用可能な AI エージェントを構築してオーケストレートするためのオープンソース フレームワーク。
- Antigravity SDK: Google Antigravity を支える同じツール、エージェント ループ、コンテキスト管理を使用して、自律型 AI エージェントを構築します。Python でプログラミングできます。