Gemini Enterprise의 AI 개발자 도구 설정 페이지를 사용하여 개발자 도구를 구성하고, 보안 및 규정 준수 제어를 시행하고, Google Antigravity 기능을 사용 설정 또는 중지하고, 조직의 모델 가용성을 관리할 수 있습니다.
시작하기 전에
다음 항목이 있는지 확인합니다.
인보이스 Cloud Billing 계정: AI 개발자 도구를 사용하려면 프로젝트에 Cloud Billing이 사용 설정되어 있어야 합니다. AI 개발자 도구는 인보이스 계정에서만 사용할 수 있습니다. 자세한 내용은 Cloud Billing 계정 유형을 참조하세요.
지원되는 버전: AI 개발자 도구에 액세스하려면 사용자가 Gemini Enterprise Standard, Plus, Standard Emerging Market 또는 사용한 만큼만 지불 버전을 구독해야 합니다.
지원되는 리전: 리전별 사용 가능 여부 및 기능 제한에 대한 자세한 내용은 Gemini Enterprise Standard 및 Plus 버전과 Gemini Notebook의 데이터 레지던시를 참조하세요.
필수 역할: AI 개발자 도구 설정을 구성하려면 Gemini Enterprise 관리자(
roles/discoveryengine.agentspaceAdmin) 역할이 있어야 합니다.필수 API: 프로젝트에 다음 API가 사용 설정되어 있어야 합니다.
- Discovery Engine API (
discoveryengine.googleapis.com): Gemini Enterprise의 핵심 플랫폼 서비스, 보안 및 규정 준수 제어, 설정 관리를 제공합니다. Business AI Code API (
businessaicode.googleapis.com): Gemini Enterprise의 Antigravity를 위한 AI 기반 코드 생성을 제공합니다. 승인된 주 구성원이 프로젝트에서 서비스에 도달할 수 있도록 프로젝트에서 이 API를 사용 설정해야 합니다.
Google Cloud 콘솔에서 AI 개발자 도구 전환 버튼을 사용 설정하면 시스템에서 프로젝트 구성을 확인하고 아직 사용 설정하지 않은 경우 필요한 API를 자동으로 사용 설정합니다.
- Discovery Engine API (
AI 개발자 도구 사용 설정
AI 개발자 도구의 사용 가능 여부는 Gemini Enterprise 구독 유형에 따라 다릅니다.
새 Standard, Plus 또는 사용한 만큼만 지불 구독: 해당 위치 또는 리전에서 지원되는 경우 구독을 구매한 위치에서 AI 개발자 도구가 기본적으로 사용 설정됩니다.
기존 구독: 관리자가 각 위치의 Google Cloud 콘솔에서 AI 개발자 도구를 수동으로 사용 설정해야 라이선스가 있는 사용자가 도구를 활성화할 수 있습니다.
기존 Gemini Enterprise 구독에 AI 개발자 도구를 수동으로 사용 설정하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise로 이동합니다.
설정을 클릭하고 AI 개발자 도구 탭을 선택합니다.
AI 개발자 도구 전환 버튼을 사용 설정합니다.
보안 설정을 지정합니다.
관리자는 개발자 인터페이스에서 승인되지 않은 데이터 노출을 방지할 수 있습니다. 이 섹션의 설정을 사용하여 외부 소스에 대한 액세스를 제한하고 자동 실행 권한을 관리합니다. 예를 들어 필수 보안 정책을 시행하여 사용자가 안전 규칙을 재정의하지 못하도록 하고, AI 에이전트가 터미널 명령어를 실행하거나 링크를 선택하기 전에 승인을 요구할 수 있습니다.
보안 정책 관리
보안 정책을 구성하여 AI 에이전트가 작업 폴더 외부의 로컬 파일에 액세스하고 개발자 작업공간에서 터미널 명령어를 실행하는 방법을 제어할 수 있습니다.
| 설정 | 설명 | 기본 상태 |
|---|---|---|
| 파일 액세스 정책 외부 |
지정된 작업 폴더 외부의 파일에 액세스하기 위한 에이전트의 권한 수준을 지정합니다. 사용할 수 있는 옵션은 다음과 같습니다.
|
거부 |
| 터미널 자동 실행 모드 |
에이전트가 터미널 명령어를 자동으로 실행하여 다단계 워크플로를 간소화할 수 있도록 이 설정을 사용 설정합니다.
사용할 수 있는 옵션은 다음과 같습니다.
|
항상 진행 |
| 샌드박스 모드 | 에이전트 도구를 안전하고 격리된 로컬 샌드박스로 제한하려면 이 설정을 사용 설정하세요. | 사용 중지됨 |
외부 웹 액세스 관리하기
보안 정책에서 데이터 무단 반출을 방지하기 위해 외부 웹사이트에 대한 상담사 액세스를 제어해야 하는 경우 이러한 설정을 통해 브라우저 액세스를 제한하거나 허용된 URL 목록으로 제한할 수 있습니다.
| 설정 | 설명 | 기본 상태 |
|---|---|---|
| 브라우저 액세스 | 외부 웹 액세스를 제어하려면 이 설정을 사용 설정하세요. 이렇게 하면 데이터 무단 반출을 방지하고 조직 경계를 정의할 수 있습니다. | 사용 중지됨 |
| 허용된 URL |
에이전트가 브라우저에서 액세스할 수 있는 허용된 URL 목록을 지정합니다.
구성하면 시스템에서 다른 모든 URL을 차단합니다.
이 설정은 Antigravity 브라우저 에이전트에만 적용됩니다. 채팅 입력란에 |
없음 기본적으로 URL은 차단되지 않습니다. |
| 브라우저 JavaScript 자동 실행 모드 |
에이전트가 JavaScript를 실행하여 고급 웹 기반 코딩 및 테스트 작업을 지원하도록 하려면 이 설정을 사용 설정하세요.
사용할 수 있는 옵션은 다음과 같습니다.
|
사용 중지됨 |
모델 컨텍스트 프로토콜 (MCP) 관리
모델 컨텍스트 프로토콜 (MCP) 서버에 대한 액세스를 구성하여 AI 에이전트가 추가 데이터 소스와 도구에 안전하게 액세스하도록 할 수 있습니다.
| 설정 | 설명 | 기본 상태 |
|---|---|---|
| MCP 서버 |
모델 컨텍스트 프로토콜 (MCP) 서버에 대한 액세스를 관리하여 AI의 데이터 컨텍스트를 안전하게 확장하려면 이 설정을 사용 설정하세요.
Android 스튜디오 및 JetBrains IDE와 같이 Agent Client Protocol(ACP)을 지원하는 IDE를 사용하려면 MCP가 필요합니다. 이러한 환경에서는 IDE가 시행 대상이 아닌 자체 MCP 도구를 삽입할 수 있으므로 관리자 제어가 최선을 다해 작동합니다. |
사용 중지됨 |
| 허용된 서버 구성 |
이 설정을 사용하면 관리자가 MCP 서버 액세스를 위한 특정 서버 구성을 정의할 수 있습니다. 관리자는 로컬 및 원격 MCP 서버의 구성이 포함된 JSON 객체로 허용 목록을 정의합니다. UI는 다음 필드에 대한 실시간 검증을 제공합니다.
구성 예시{ "mcpServers": { "local_servers": [ { "id": "gopls-mcp-server", "command": "go", "args": [ "run", "golang.org/x/tools/gopls@latest", "mcp" ] } ], "remote_servers": [ { "id": "bigquery" }, { "id": "custom-remote-server", "url": "https://mcp.example.com/mcp" } ] } } |
구성되지 않음 |
규정 준수 설정 구성
조직이 규제 대상 업종에서 운영되거나 특정 내부 정책이 있는 경우 규정 준수를 위해 AI 상호작용의 감사 로그를 유지해야 할 수 있습니다. 이 섹션의 설정을 사용하면 법률 및 규제 요구사항을 충족하도록 로깅 및 데이터 보관 정책을 구성할 수 있습니다.
| 설정 | 설명 | 기본 상태 |
|---|---|---|
| 프롬프트 및 응답 로깅 | 이 설정을 사용 설정하면 개발자와 AI 간의 상호작용을 기록하여 사용량 측정항목을 계산하고 보안 검토를 위한 감사 추적을 유지할 수 있습니다. 시스템은 조직의 프로젝트 내에 로그를 안전하게 저장하며, Google 은 모델 학습 또는 검토자의 검토를 위해 이 로그에 액세스하지 않습니다. | 사용 중지됨 |
| 메타데이터 로깅 | 이 설정을 사용 설정하면 서드 파티 모델 토큰 소비를 포함하여 조직 전반에서 사용량과 분석을 추적하는 데 도움이 되는 제품 메타데이터를 기록할 수 있습니다. 시스템은 조직의 프로젝트 내에 로그를 안전하게 저장하며, Google 은 모델 학습 또는 검토자의 검토를 위해 이 로그에 액세스하지 않습니다. | 사용 중지됨 |
기능 설정 구성
일부 Antigravity 기능은 개발자가 복잡한 작업을 처리하는 데 도움이 되는 고급 멀티 에이전트 기능을 제공합니다. 이러한 기능은 토큰 사용량과 비용을 증가시킬 수 있으므로 이 섹션의 설정을 사용하여 조직의 사용자에 대한 액세스를 제어하세요. 사용 설정된 기능에 액세스하려면 사용자가 Antigravity 앱 버전 2.18.0 이상 또는 Antigravity CLI 버전 1.2.10 이상을 사용해야 합니다.
기능을 사용 설정 또는 중지하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise로 이동합니다.
설정을 클릭하고 AI 개발자 도구 탭을 선택합니다.
기능 섹션에서 수정을 클릭합니다.
각 기능의 전환 버튼을 사용 설정 또는 사용 중지합니다.
설정 설명 기본 상태 /boost명령어사용자가 계층화된 멀티 에이전트 계층 구조를 실행하여 복잡한 알고리즘 문제와 심층 디버깅 작업을 해결할 수 있도록 이 설정을 사용 설정합니다. 자세한 내용은 심층 추론 강화를 참조하세요. 사용 설정됨 /teamwork-preview명령어사용자가 자율 하위 에이전트의 조정된 프레임워크를 배포하여 대규모 장기 프로젝트를 실행할 수 있도록 하려면 이 설정을 사용 설정하세요(프리뷰). 자세한 내용은 팀워크 에이전트 팀을 참조하세요. 사용 설정됨 저장을 클릭합니다.
모델 가용성 구성
이 섹션의 설정을 사용하여 특정 AI 모델을 승인하고 액세스 수준을 관리합니다. 이렇게 하면 개발자가 조직의 안전 및 사용 정책을 준수하는 AI 모델만 사용할 수 있습니다. 예를 들어 개발자에게 실험용 프리뷰 모델에 대한 액세스 권한을 부여하거나 승인된 모델만 사용하도록 도구를 제한할 수 있습니다.
모델을 구성하기 전 주요 고려사항
모델을 구성하기 전에 다음 사항을 고려하세요.
정책 조정: Gemini Enterprise에서 모델을 사용 설정해도 Gemini Enterprise Agent Platform 조직 정책이 재정의되지 않습니다. 표준 할당량을 초과하는 사용한 만큼만 지불 요청이 실패하지 않도록 하려면 허용되는 모델이 두 플랫폼에서 일치하는지 확인하세요.
데이터 레지던시: 프리뷰 모델과 Gemini 3 Pro Image 모델은
global리전에서만 사용할 수 있습니다. 따라서 미국 또는 EU 멀티 리전에서 데이터 상주 (DRZ) 또는 머신러닝 (ML) 리전 처리 약정을 지원하지 않습니다.서드 파티 모델 추론 및 데이터 처리: 서드 파티 모델은 관리자가 사용 설정하고 제공업체의 약관에 동의한 후에만 사용할 수 있습니다. 개발자가 사용 설정된 서드 파티 모델을 선택하면 Gemini Enterprise는 해당 요청에 필요한 프롬프트와 코드 컨텍스트를 Gemini 모델과 동일한 처리 및 보호 기능을 사용하여 모델에 전송합니다. 프롬프트와 대답은 모델 학습에 사용되지 않습니다. 서드 파티 모델 추론은
global,us,eu위치에서 사용할 수 있습니다. 국가 내 리전은 지원되지 않습니다. 모델에 액세스할 수 있는 국가 및 리전 목록을 보려면 Anthropic의 지원되는 국가 및 리전을 참조하세요. 데이터 레지던시에 대한 자세한 내용은 Gemini Enterprise Standard 및 Plus 버전과 Gemini Notebook의 데이터 레지던시를 참조하세요.하이브리드 실행 및 결제 공개: Gemini 모델은 조직의 풀링된 버전 시트 크레딧을 사용하며, 관리자가 사용 설정한 서드 파티 모델은 Cloud Billing 계정에서 사용한 만큼만 지불하는 사용량으로 청구됩니다. 개발자가 기본 추론, 계획, 도구 조정, 코드 생성 작업을 위해 사용 설정된 서드 파티 모델 (예: Anthropic Claude Opus 5.5 또는 Anthropic Claude Sonnet 5.5)을 선택하면 Antigravity는 백그라운드에서 경량 Gemini 모델을 계속 사용하여 컨텍스트 관리 및 요약과 같은 클라이언트 측 조정을 수행하고 Gemini 3 Pro Image를 사용하여 이미지를 생성합니다. 이러한 모델을 사용하면 요금이 청구될 수 있습니다. 자세한 내용은 할당량 및 초과분 및 서드 파티 모델 토큰 사용량 추적을 참조하세요.
승인된 모델 구성
승인된 모델을 구성하여 AI 개발자 도구에서 사용할 수 있는 AI 모델을 제어할 수 있습니다.
Antigravity 승인 모델 설정은 허용 목록으로 작동합니다.
- 기본 선택 (비어 있음): 필드가 비어 있으면 지원되는 모든 Gemini 모델이 허용됩니다. 새로 출시된 Google모델은 라이선스가 있는 사용자에게 자동으로 제공됩니다.
- 커스텀 모델 목록: 하나 이상의 특정 모델을 선택하면 선택한 모델만 허용됩니다. 선택하지 않은 모델과 새로 출시된 모델은 관리자가 수동으로 선택할 때까지 개발자가 사용할 수 없습니다.
승인된 모델을 구성하려면 다음 안내를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise로 이동합니다.
설정을 클릭한 다음 AI 개발자 도구 탭을 선택합니다.
모델 사용 가능 여부 섹션에서 수정을 클릭합니다.
Antigravity 승인 모델 필드에서 허용할 모델을 선택합니다. 지원되는 모든 모델을 허용하려면 필드를 비워 둡니다.
저장을 클릭합니다.
| 설정 | 설명 | 기본 상태 |
|---|---|---|
| Antigravity 승인 모델 | 프로젝트 내에서 Antigravity 도구가 사용할 수 있는 AI 모델을 지정합니다. 지원되는 모든 Gemini 모델을 허용하려면 필드를 비워 둡니다. 커스텀 모델 목록을 지정하면 설정이 허용 목록으로 작동하며 새로 출시되거나 선택되지 않은 모델을 수동으로 추가해야 사용할 수 있습니다. Google에서 만든 Gemini 모델 외에도 관리자는 Anthropic Claude Opus 5.5 및 Anthropic Claude Sonnet 5.5를 비롯한 서드 파티 모델을 사용 설정할 수 있습니다. 각 모델의 기능, 제한사항, 안전 평가에 대한 자세한 내용은 Anthropic Claude Opus 5.5 및 Anthropic Claude Sonnet 5.5의 모델 카드를 참조하세요. | 비어 있음 (모든 Gemini 모델 허용) 서드 파티 모델은 기본적으로 사용 중지되어 있으며 관리자 동의가 필요합니다. |
지원되는 모델
AI 개발자 도구 (Antigravity 앱, Antigravity CLI, IDE용 Antigravity)는 다음 Gemini 모델 및 파트너 모델을 지원합니다. 라이선스 사용자는 활성 Gemini Enterprise 라이선스 (Standard, Plus 또는 사용한 만큼만 지불)가 할당된 개발자입니다. 자세한 내용은 라이선스 관리를 참조하세요.
| 모델 표시 이름 | 제공업체 | Gemini Enterprise에서 사용 가능 여부 |
|---|---|---|
| Gemini 4 Argon | 기본 모델 선택이 활성화된 경우 라이선스가 부여된 사용자에게 기본적으로 사용 설정됩니다 (빈 목록). 사용자 지정 모델 목록이 구성된 경우 모델을 수동으로 선택해야 합니다. | |
| Gemini 3.8 Flash | 기본 모델 선택이 활성화된 경우 라이선스가 부여된 사용자에게 기본적으로 사용 설정됩니다. 사용자 지정 모델 목록이 구성된 경우 모델을 수동으로 선택해야 합니다. | |
| Gemini 3.7 Flash | 기본 모델 선택이 활성화된 경우 라이선스가 부여된 사용자에게 기본적으로 사용 설정됩니다. 사용자 지정 모델 목록이 구성된 경우 모델을 수동으로 선택해야 합니다. | |
| Gemini 3.6 Flash | 기본 모델 선택이 활성화된 경우 라이선스가 부여된 사용자에게 기본적으로 사용 설정됩니다. 사용자 지정 모델 목록이 구성된 경우 모델을 수동으로 선택해야 합니다. | |
| Gemini 3.1 Pro (프리뷰) | 기본 모델 선택이 활성화된 경우 라이선스가 부여된 사용자에게 기본적으로 사용 설정됩니다. 사용자 지정 모델 목록이 구성된 경우 모델을 수동으로 선택해야 합니다. | |
| Anthropic Claude Opus 5.5 | Anthropic | 기본적으로 사용 중지되어 있습니다. 관리자 선택이 필요합니다(서드 파티 모델 사용 설정 또는 사용 중지 참고). |
| Anthropic Claude Sonnet 5.5 | Anthropic | 기본적으로 사용 중지되어 있습니다. 관리자 선택이 필요합니다(서드 파티 모델 사용 설정 또는 사용 중지 참고). |
할당량 및 풀링된 버전 크레딧에 대한 자세한 내용은 할당량 및 초과분 및 초과분 구성을 참조하세요. 서드 파티 모델 가격 책정은 Anthropic Claude Opus 5.5 및 Anthropic Claude Sonnet 5.5의 Cloud Billing SKU를 참조하세요.
서드 파티 모델의 사고 수준
개발자는 Anthropic Claude Opus 5.5 및 Anthropic Claude Sonnet 5.5를 낮음, 중간, 높음, 최대의 사고 수준으로 사용할 수 있습니다. 각 수준은 모델 선택 도구에 별도의 항목으로 표시됩니다(예: Anthropic Claude Opus 5.5(높음)). 기본값은 보통입니다. 서드 파티 모델을 사용 설정하면 개발자가 모든 사고 수준을 사용할 수 있습니다. 개별 사고 수준을 제한할 수 없습니다.
서드 파티 모델 사용 설정 또는 사용 중지하기
서드 파티 모델은 사용한 만큼만 지불하는 사용량으로 청구되며 초과분이 필요합니다. 서드 파티 모델을 사용 설정하기 전에 초과 사용량을 사용 설정합니다. 나중에 초과 사용량이 사용 중지되면 초과 사용량이 다시 사용 설정될 때까지 개발자는 서드 파티 모델을 사용할 수 없습니다. 비용을 관리하려면 프로젝트에 월 지출 한도를 설정하면 됩니다. 이 한도는 서드 파티 모델을 포함한 모든 모델에 적용됩니다.
Google Cloud 콘솔에서 서드 파티 모델 (예: Anthropic Claude Opus 5.5 및 Anthropic Claude Sonnet 5.5)을 사용 설정하거나 관리하려면 다음 안내를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise로 이동합니다.
설정을 클릭한 다음 AI 개발자 도구 탭을 선택합니다.
Antigravity 승인 모델 설정에서 사용 설정하려는 서드 파티 모델의 전환 버튼을 사용 설정합니다.
표시되는 삽입된 서비스 약관 대화상자에서 서드 파티 약관을 검토하고 동의합니다.
서드 파티 모델을 사용 중지하면 개발자는 잠시 후 해당 모델에 액세스할 수 없게 됩니다.
모델 제공업체가 조직의 서드 파티 모델에 대한 액세스를 제한하는 경우 개발자는 해당 모델을 사용할 수 없습니다. 문제를 해결하려면 Google Cloud 지원팀에 문의하세요.
Antigravity에 로그인하고 모델을 선택하는 방법에 관한 개발자 안내는 Antigravity 엔터프라이즈 문서를 참고하세요.
서드 파티 모델의 보안 고려사항
서드 파티 모델을 비롯한 AI 모델은 파일, 웹페이지, 도구 출력 등 처리하는 콘텐츠에 숨겨진 요청 사항을 따를 수 있습니다. 이를 프롬프트 인젝션이라고 합니다. Antigravity는 개발자가 서드 파티 모델을 사용할 때 다음과 같은 보호 기능을 제공합니다.
- 관리자 선택: 서드 파티 모델은 기본적으로 사용 중지되어 있습니다. 개발자는 관리자가 사용 설정한 후에만 서드 파티 모델을 사용할 수 있습니다.
- 제공업체 안전 보호 조치: 서드 파티 모델에는 제공업체의 기본 제공 안전 보호 조치가 포함됩니다. 자세한 내용은 Claude 안전을 참조하세요.
- 보안 정책: 구성하는 보안 정책 및 외부 웹 액세스 설정은 개발자가 선택한 모델과 관계없이 에이전트에 적용됩니다.
권장사항
- 개발자에게 필요한 서드 파티 모델만 사용 설정하세요.
- 개발자가 명령어를 실행하기 전에 승인하도록 터미널 자동 실행 모드를 검토 필요 또는 샌드박스에서 진행으로 설정합니다.
- 파일 액세스 정책 외부를 거부로 설정된 상태로 유지합니다.
- 브라우저 액세스를 사용 설정하고 에이전트를 허용된 URL 목록으로 제한합니다.
- 신뢰할 수 없는 코드, 종속 항목 또는 웹 콘텐츠를 사용하는 프로젝트에 샌드박스 모드를 사용 설정합니다.
- 개발자가 에이전트가 제안하는 명령어와 코드 변경사항을 승인하기 전에 검토하도록 권장합니다.
- 프로젝트의 월 지출 한도를 설정합니다.
누락된 서비스 에이전트 수정
AI 개발자 도구는 프로젝트에서 Google관리형 서비스 에이전트를 사용하여 초과분 및 관리자 제어와 같은 요청을 처리합니다. 서비스 에이전트는 AI 개발자 도구 전환 버튼을 사용 설정하거나 Gemini Enterprise 구독을 구매하면 자동으로 생성됩니다.
프로젝트에 서비스 에이전트가 없으면 AI 개발자 도구의 요청이 다음과 유사한 오류와 함께 실패합니다.
Service agent SERVICE_AGENT_EMAIL not found.
이 오류를 해결하려면 다음 방법 중 하나를 사용하여 서비스 에이전트를 다시 만듭니다.
Google Cloud 콘솔 사용
Google Cloud 콘솔에서 Gemini Enterprise로 이동합니다.
설정을 클릭하고 AI 개발자 도구 탭을 선택합니다.
AI 개발자 도구 전환 버튼을 사용 중지합니다.
AI 개발자 도구 전환 버튼을 다시 사용 설정합니다.
전환 버튼을 사용 설정하면 프로젝트에 서비스 에이전트가 생성됩니다. 전환 버튼을 사용 중지했다가 다시 사용 설정해도 구성된 AI 개발자 도구 설정은 재설정되지 않습니다.
gcloud CLI 사용
서비스 에이전트를 만듭니다.
gcloud beta services identity create \ --service=businessaicode.googleapis.com \ --project=PROJECT_IDPROJECT_ID를 프로젝트의 ID로 바꿉니다.명령어 출력에는 서비스 에이전트의 이메일 주소가 포함됩니다.
서비스 에이전트에 비즈니스 AI 코드 서비스 에이전트(
roles/businessaicode.serviceAgent) 역할을 부여합니다.gcloud beta services identity create명령어는 이 역할을 자동으로 부여하지 않습니다.gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SERVICE_AGENT_EMAIL" \ --role="roles/businessaicode.serviceAgent"다음을 바꿉니다.
PROJECT_ID: 프로젝트의 ID입니다.SERVICE_AGENT_EMAIL: 이전 단계의 출력 또는 오류 메시지에 있는 서비스 에이전트의 이메일 주소입니다.
자세한 내용은 gcloud beta services identity create를 참조하세요.