Android Studio 的代理模式下的 Gemini 旨在处理复杂的多阶段开发任务，这些任务超出了您仅通过与 Gemini 聊天所能完成的范围。您可以描述一个概要目标，代理将创建并执行计划，调用必要的工具，更改多个文件，并迭代修复 bug。借助此由客服人员协助的工作流程，您可以应对复杂的挑战，从而加快开发流程。
系统要求
代理模式从 Android Studio Narwhal 功能更新 Canary 4 开始提供。下载最新的预览版 Android Studio。
开始使用
如需在 Android Studio 中以代理模式开始使用，请按以下步骤操作：
- 点击边栏中的 Gemini
。登录并完成初始配置（如果需要）。 - 选择客服人员标签页。
- 描述您希望代理执行的任务。
客服人员在完成任务的过程中，您可以选择审核并批准所有更改。
可选：如需自动批准更改，请依次选择代理选项
> 自动批准更改。
用例
以下是该客服助手可帮助您处理的一些用例示例：
修正构建错误。当您使用“修复我项目中的构建错误”等提示指示智能体修复构建错误时，它会应用建议的修复程序，构建项目以验证解决方案，并进行迭代，直到问题得到解决。
代理模式可以自行添加或更新界面元素。例如，您可以要求代理“在用户偏好设置中将深色模式设为默认”，它会搜索相关文件并建议更改以完成任务。您可以在 Running devices 工具窗口中立即预览界面更新。
在对应用进行原型设计和测试时，使用模拟数据会很有帮助。您可以将此任务交给代理，而不是自己手动创建虚构数据。在这里，我们要求客服人员“向虚构数据中再添加两个会话”。它会找到相关文件，并向
mockSessions列表中添加另外两个事件。
其他一些可尝试的提示：
- “为 <module> 中的 <class> 编写单元测试。”
- “为当前打开的文件生成文档。”
- “将应用名称从<当前名称>更改为<新名称>。”
- “解决 null 指针异常。”
- “将 <composable name> 可组合项移至新文件，以重构代码。 Ensure all imports are updated."
- “向应用的主屏幕添加一个名为“关注”的新按钮，该按钮可将您定向到主题列表。”
- “在 <composable name> 可组合项中，请减小 <modifier name> 修饰符的内边距。”
- “创建用于分享到社交媒体的分享按钮。”
添加您的 Gemini API 密钥
Android Studio 中的默认代理模式具有免费的每日配额，但上下文窗口有限。如需扩大上下文窗口，您可以添加自己的 Gemini API 密钥，以便使用 Gemini 2.5 Pro 中的多达 100 万个 token。
上下文窗口越大，您可以向 Gemini 发送的说明、代码和附件就越多，从而获得更高质量的回答。这在与代理进行交互时特别有用，因为更广泛的上下文可让 Gemini 2.5 Pro 推理复杂或长时间运行的任务。
如需获取 API 密钥，请执行以下操作：
- 登录 Google AI Studio，然后点击“获取 API 密钥”按钮获取密钥。
- 在 Android Studio 中，依次前往 File（在 macOS 上为 Android Studio）> Settings > Tools > Gemini，输入您的 Gemini API 密钥。
- 在 Android Studio 中重新启动 Gemini，从 Agent 模式获得更出色的回答。
请务必妥善保管您的 Gemini API 密钥，因为与个人 API 密钥关联的 Gemini API 用量会产生额外费用。您可以在 AI Studio 中依次选择 Get API Key > Usage & Billing，监控 Gemini API 密钥的使用情况。
添加 MCP 服务器
Android Studio 代理中的 Gemini 可以使用模型上下文协议 (MCP) 与外部工具交互。此功能为代理模式提供了一种标准化的方式来使用工具，并通过外部环境扩展知识和功能。
您可以在 Android Studio 中使用多种工具连接到 MCP 主机。例如，您可以与 Github MCP 服务器集成，以便直接从 Android Studio 创建拉取请求。如需更多想法，请参阅 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 服务器的文档。您可能还需要安装 Node.js 或 Docker 等工具，具体取决于 MCP 服务器的软件要求。
限制
Android Studio 的 MCP 集成存在一些重要的限制：
- MCP 服务器必须实现 stdio 传输。
- 尚不支持流式 HTTP 传输以及 MCP 资源和提示模板。
代理的工作原理
在代理模式下，系统会将您的问题以及可用的工具列表发送到 Gemini API。您可以将工具视为技能：包括搜索文件、读取文件、搜索文件中的文本、使用您配置的任何 MCP 服务器等。
当您向客服人员分配任务时，它会制定计划并确定所需的工具。您可能需要先授予代理相应权限，代理才能使用其中的某些工具。您授予权限后，代理便会使用该工具执行必要的操作，并将结果发送回 Gemini API。Gemini 会处理操作结果并生成另一个回答。此行动和评估循环会持续到任务完成为止。