Android 스튜디오의 Gemini 에이전트 모드는 Gemini와의 채팅으로 해결할 수 있는 작업보다 더 복잡한 다단계 개발 작업을 처리할 수 있도록 설계되었습니다. 대략적인 목표를 설명하면 에이전트가 계획을 생성하고 실행하여 필요한 도구를 호출하고, 여러 파일에 걸쳐 변경사항을 적용하고, 버그를 반복적으로 수정합니다. 이 상담사 지원 워크플로를 통해 복잡한 문제를 해결하고 개발 프로세스를 가속화할 수 있습니다.
시스템 요구사항
에이전트 모드는 Android 스튜디오 Narwhal 기능 출시 Canary 4부터 사용할 수 있습니다. Android 스튜디오의 최신 미리보기 버전을 다운로드합니다.
시작하기
Android 스튜디오에서 에이전트 모드를 시작하려면 다음 단계를 따르세요.
- 사이드바에서 Gemini
를 클릭합니다. 필요한 경우 로그인하고 온보딩합니다.
- 에이전트 탭을 선택합니다.
- 에이전트가 수행할 작업을 설명합니다.
상담사가 작업을 완료하는 단계를 진행하는 동안 변경사항을 검토하고 승인할 수 있습니다.
선택사항: 변경사항을 자동으로 승인하려면 에이전트 옵션
> 변경사항 자동 승인을 선택합니다.
사용 사례
다음은 에이전트가 지원할 수 있는 사용 사례의 몇 가지 예입니다.
빌드 오류를 수정합니다. '내 프로젝트의 빌드 오류 수정'과 같은 프롬프트를 사용하여 에이전트에게 빌드 오류를 수정해 달라고 요청하면 권장 수정사항이 적용되고, 솔루션을 확인하기 위해 프로젝트가 빌드되며, 문제가 해결될 때까지 이 과정이 반복됩니다.
에이전트 모드는 UI 요소를 자체적으로 추가하거나 업데이트할 수 있습니다. 예를 들어 에이전트에게 '사용자 환경설정에서 다크 모드를 기본값으로 설정해 줘'라고 요청하면 관련 파일을 검색하고 작업을 완료하기 위한 변경사항을 제안합니다. 실행 중인 기기 도구 창에서 UI 업데이트를 즉시 미리 볼 수 있습니다.
앱을 프로토타입으로 만들고 테스트할 때는 모의 데이터가 유용합니다. 가짜 데이터를 직접 수동으로 만드는 대신 에이전트에게 이 작업을 맡길 수 있습니다. 여기서는 에이전트에게 '가짜 데이터에 세션 두 개를 더 추가해'라고 요청했습니다. 관련 파일을 찾아
mockSessions목록에 두 개의 이벤트를 더 추가합니다.
사용해 볼 만한 다른 프롬프트:
- '<module>의 <class>에 대한 단위 테스트를 작성해 줘.'
- '현재 열려 있는 파일의 문서를 생성해 줘.'
- '앱 제목을 <현재 이름>에서 <새 이름>으로 변경해 줘.'
- 'null 포인터 예외를 해결해 줘.'
- '<구성 가능한 이름> 구성 가능 항목을 새 파일로 이동하여 코드를 리팩터링해 줘. 모든 가져오기가 업데이트되었는지 확인하세요.'
- '앱의 홈 화면에 '팔로우'라는 새 버튼을 추가하여 주제 목록으로 이동합니다.'
- '<컴포저블 이름> 컴포저블에서 <수정자 이름> 수정자의 패딩을 줄여줘.'
- '소셜 미디어에 공유할 공유 버튼을 만들어 줘.'
Gemini API 키 추가
Android 스튜디오의 기본 에이전트 모드에는 제한된 컨텍스트 창이 있는 무료 일일 할당량이 있습니다. 컨텍스트 윈도우를 확장하려면 자체 Gemini API 키를 추가하여 Gemini 2.5 Pro로 최대 100만 개의 토큰을 활용하면 됩니다.
컨텍스트 윈도우가 클수록 Gemini에 더 많은 안내, 코드, 첨부파일을 보낼 수 있으므로 대답의 품질이 더욱 높아집니다. 이는 에이전트와 함께 작업할 때 특히 유용합니다. 컨텍스트가 클수록 Gemini 2.5 Pro가 복잡하거나 장기 실행되는 작업을 추론할 수 있기 때문입니다.
API 키를 가져오는 방법은 다음과 같습니다.
- Google AI Studio에 로그인하고 API 키 받기 버튼을 클릭하여 키를 가져옵니다.
- Android 스튜디오에서 File (macOS의 경우 Android 스튜디오) > Settings > Tools > Gemini로 이동하여 Gemini API 키를 입력합니다.
- Android 스튜디오에서 Gemini를 다시 실행하고 에이전트 모드에서 훨씬 더 나은 대답을 받아보세요.
개인 API 키와 연결된 Gemini API 사용에는 추가 요금이 부과되므로 Gemini API 키를 안전하게 보호하세요. AI Studio에서 API 키 가져오기 > 사용량 및 결제를 통해 Gemini API 키 사용량을 모니터링할 수 있습니다.
MCP 서버 추가
Android 스튜디오의 Gemini 에이전트는 모델 컨텍스트 프로토콜 (MCP)을 사용하여 외부 도구와 상호작용할 수 있습니다. 이 기능은 에이전트 모드가 도구를 사용하고 외부 환경으로 지식과 기능을 확장하는 표준화된 방법을 제공합니다.
Android 스튜디오에서 MCP 호스트에 연결할 수 있는 도구는 다양합니다. 예를 들어 Github MCP 서버와 통합하여 Android 스튜디오에서 직접 풀 요청을 만들 수 있습니다. 자세한 내용은 MCP 예시 서버를 참고하세요.
MCP 서버를 추가하려면 mcp.json 파일을 만들어 스튜디오의 구성 디렉터리에 배치합니다. 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 스튜디오의 MCP 통합에는 몇 가지 중요한 제한사항이 있습니다.
- MCP 서버는 stdio 전송을 구현해야 합니다.
- 스트리밍 HTTP 전송과 MCP 리소스 및 프롬프트 템플릿은 아직 지원되지 않습니다.
에이전트 작동 방식
에이전트 모드에서는 사용 가능한 도구 목록과 함께 프롬프트가 Gemini API로 전송됩니다. 도구는 기술로 생각할 수 있습니다. 파일 검색, 파일 읽기, 파일 내 텍스트 검색, 구성한 MCP 서버 사용 등의 기능을 포함합니다.
에이전트에게 작업을 부여하면 에이전트가 계획을 세우고 필요한 도구를 파악합니다. 이러한 도구 중 일부를 사용하려면 상담사가 사용하기 전에 권한을 부여해야 할 수 있습니다. 권한을 부여하면 에이전트가 도구를 사용하여 필요한 작업을 실행하고 결과를 Gemini API로 다시 전송합니다. Gemini는 작업 결과를 처리하고 다른 대답을 생성합니다. 이 행동 및 평가 주기는 작업이 완료될 때까지 계속됩니다.