Android Studio のエージェント モードの Gemini は、Gemini とのチャットだけではできない、複雑なマルチステージ開発タスクを処理するように設計されています。大まかな目標を記述すると、エージェントが計画を作成して実行し、必要なツールを呼び出して複数のファイルに変更を加え、バグを反復的に修正します。このエージェント支援ワークフローにより、複雑な課題に取り組んで開発プロセスを加速できます。
システム要件
エージェント モードは、Android Studio Narwhal Feature Drop Canary 4 以降で利用できます。Android Studio の最新プレビュー バージョンをダウンロードします。
始める
Android Studio でエージェント モードを開始する手順は次のとおりです。
- サイドバーの Gemini
をクリックします。必要に応じてログインしてオンボーディングを行います。 - [エージェント] タブを選択します。
- エージェントに実行させるタスクを記述します。
エージェントがタスクを完了する手順を進める際に、変更を確認して承認できます。
省略可: 変更を自動的に承認するには、[エージェント オプション
] > [変更を自動承認] を選択します。
ユースケース
エージェントがサポートできるユースケースの例を以下に示します。
ビルドエラーを修正します。「プロジェクトのビルドエラーを修正」などのプロンプトを使用してエージェントにビルドエラーの修正を依頼すると、推奨される修正が適用され、プロジェクトがビルドされてソリューションが検証され、問題が解決するまで反復処理されます。
エージェント モードでは、UI 要素をすべて独自に追加または更新できます。たとえば、「ユーザー設定でダークモードをデフォルトに設定」するようにエージェントに指示すると、関連するファイルを検索し、タスクを完了するための変更を提案します。UI の更新は、[実行中のデバイス] ツール ウィンドウですぐにプレビューできます。
アプリのプロトタイプ作成とテストでは、モックデータがあると便利です。偽のデータを自分で手動で作成する代わりに、そのタスクをエージェントに任せることができます。ここでは、エージェントに「偽のデータに 2 つのセッションを追加」するよう依頼しています。関連するファイルが検出され、
mockSessionsリストに 2 つのイベントが追加されます。
試すことができる他のメッセージ:
- 「<module> の <class> の単体テストを作成します。」
- 「現在開いているファイルのドキュメントを生成します。」
- 「アプリのタイトルを <現在の名前> から <新しい名前> に変更してください。」
- 「null ポインタ例外を解決してください。」
- 「<composable name> コンポーザブルを新しいファイルに移動して、コードをリファクタリングします。すべてのインポートが更新されていることを確認してください。」
- 「アプリのホーム画面に、トピックのリストに移動する [フォロー] という新しいボタンを追加します。」
- 「<composable name> コンポーザブルで、<modifier name> 修飾子のパディングを減らしてください。」
- 「ソーシャル メディアで共有するための共有ボタンを作成します。」
Gemini API キーを追加する
Android Studio のデフォルトのエージェント モードには、コンテキスト ウィンドウが制限された無料の 1 日あたりの割り当てがあります。コンテキスト ウィンドウを拡張するには、独自の Gemini API キーを追加して、Gemini 2.5 Pro で最大 100 万トークンを利用できます。
コンテキスト ウィンドウが大きくなると、Gemini に送信できる指示、コード、添付ファイルが増え、より質の高い回答が得られます。これは、エージェントと連携する場合に特に便利です。コンテキストが広くなると、Gemini 2.5 Pro は複雑なタスクや長時間実行タスクを推論できるようになります。
API キーを取得するには:
- Google AI Studio にログインし、[API キーを取得] ボタンをクリックしてキーを取得します。
- Android Studio で、[File]（macOS では [Android Studio]）> [Settings] > [Tools] > [Gemini] に移動して、Gemini API キーを入力します。
- Android Studio で Gemini を再起動すると、エージェント モードからの回答がさらに改善されます。
個人の API キーに関連付けられた Gemini API の使用には追加料金が適用されるため、Gemini API キーを安全に保管してください。AI Studio で Gemini API キーの使用状況をモニタリングするには、[API キーを取得 > 使用状況と課金] に移動します。
MCP サーバーを追加する
Android Studio のエージェントの Gemini は、Model Context Protocol（MCP）を使用して外部ツールとやり取りできます。この機能により、エージェント モードでツールを使用し、外部環境で知識と機能を拡張するための標準化された方法が提供されます。
Android Studio には、MCP ホストに接続できる多くのツールがあります。たとえば、Github MCP サーバーと統合して、Android Studio から直接 pull リクエストを作成できます。その他のアイデアについては、MCP のサンプル サーバーをご覧ください。
MCP サーバーを追加するには、mcp.json ファイルを作成して Studio の構成ディレクトリに配置します。mcp.json ファイルの形式は次のとおりです。
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
},
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
},
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
このファイルに含める command と args の正確な内容については、統合する MCP サーバーのドキュメントをご覧ください。MCP サーバーのソフトウェア要件によっては、Node.js や Docker などのツールをインストールすることも必要になる場合があります。
制限事項
Android Studio の MCP 統合には、いくつかの重要な制限があります。
- MCP サーバーは stdio トランスポートを実装する必要があります。
- ストリーミング HTTP トランスポート、MCP リソース、プロンプト テンプレートのサポートはまだサポートされていません。
エージェントの仕組み
エージェント モードでは、使用可能なツールのリストとともにプロンプトが Gemini API に送信されます。ツールはスキルと考えることができます。ファイルの検索、ファイルの読み取り、ファイル内のテキストの検索、構成した MCP サーバーの使用などが含まれます。
エージェントにタスクを渡すと、エージェントは計画を立て、必要なツールを特定します。これらのツールの中には、エージェントが使用できるように、管理者が権限を付与する必要があるものもあります。権限を付与すると、エージェントはツールを使用して必要なアクションを実行し、結果を Gemini API に返します。Gemini はアクションの結果を処理し、別のレスポンスを生成します。このアクションと評価のサイクルは、タスクが完了するまで続きます。