AI 개발자 도구 설정 구성

Gemini Enterprise의 AI 개발자 도구 설정 페이지를 사용하여 개발자 도구를 구성하고, 보안 및 규정 준수 제어를 적용하고, 조직의 모델 가용성을 관리합니다.

시작하기 전에

다음 항목이 있는지 확인합니다.

  • 인보이스 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가 사용 설정되어 있어야 합니다.

    • Gemini Enterprise API (discoveryengine.googleapis.com): Gemini Enterprise의 핵심 플랫폼 서비스, 보안 및 규정 준수 제어, 설정 관리를 제공합니다.

    • Business AI Code API (businessaicode.googleapis.com): Gemini Enterprise의 Antigravity에 AI 기반 코드 생성을 제공합니다. 승인된 보안 주체가 프로젝트에서 서비스에 연결할 수 있도록 프로젝트에서 이 API를 사용 설정해야 합니다.

    콘솔 Google Cloud 에서 AI 개발자 도구 전환 버튼을 사용 설정하면 시스템에서 프로젝트 구성을 확인하고 아직 사용 설정하지 않은 경우 이러한 필수 API를 자동으로 사용 설정합니다.

AI 개발자 도구 사용 설정

AI 개발자 도구의 사용 가능 여부는 Gemini Enterprise 구독 유형에 따라 다릅니다.

  • 새로운 Standard, Plus 또는 사용한 만큼만 지불 구독: AI 개발자 도구는 해당 위치 또는 리전에서 지원되는 경우 구독을 구매한 위치에서 기본적으로 사용 설정됩니다.

  • 기존 구독: 관리자는 Google Cloud 콘솔에서 각 위치에 대해 AI 개발자 도구를 수동으로 사용 설정하여 라이선스가 부여된 사용자를 위한 도구를 활성화해야 합니다.

기존 Gemini Enterprise 구독에 대해 AI 개발자 도구를 수동으로 사용 설정하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Gemini Enterprise 로 이동합니다.

    Gemini Enterprise

  2. 설정 을 클릭하고 AI 개발자 도구 탭을 선택합니다.

  3. AI 개발자 도구 전환 버튼을 사용 설정합니다.

  4. 보안, 규정 준수, 모델 가용성 섹션에서 설정을 구성합니다.

보안 설정 구성

관리자는 개발자 인터페이스 전반에서 무단 데이터 노출을 방지할 수 있습니다. 이 섹션의 설정을 사용하여 외부 소스에 대한 액세스를 제한하고 자동 실행 권한을 관리합니다. 예를 들어 사용자가 안전 규칙을 재정의하지 못하도록 필수 보안 정책을 적용하고 AI 에이전트가 터미널 명령어를 실행하거나 링크를 선택하기 전에 승인을 요청할 수 있습니다.

보안 정책 관리

보안 정책을 구성하여 AI 에이전트가 작업 폴더 외부의 로컬 파일에 액세스하고 개발자 작업공간에서 터미널 명령어를 실행하는 방식을 제어할 수 있습니다.

설정 설명 기본 상태
파일 액세스 정책 외부 지정된 작업 폴더 외부의 파일에 액세스하기 위한 에이전트의 권한 수준을 지정합니다. 다음 옵션을 사용할 수 있습니다.
  • 거부: 에이전트가 작업 폴더 외부의 파일에 액세스하지 못하도록 합니다.
  • 항상 묻기: 에이전트가 작업 폴더 외부의 파일에 액세스하기 전에 사용자에게 권한을 요청합니다.
  • 허용: 에이전트가 프롬프트 없이 작업 폴더 외부의 파일에 액세스하도록 허용합니다.
 거부
터미널 자동 실행 모드 에이전트가 터미널 명령어를 자동으로 실행하여 다단계 워크플로를 간소화하도록 하려면 이 설정을 사용 설정합니다. 다음 옵션을 사용할 수 있습니다.
  • 검토 필요: 터미널 명령어를 실행하기 전에 승인을 요청합니다.
  • 샌드박스에서 진행: 안전하고 격리된 환경에서 명령어를 자동으로 실행합니다.
  • 항상 진행: 프롬프트 없이 현재 환경에서 명령어를 자동으로 실행합니다.
 항상 진행
샌드박스 모드 에이전트 도구를 안전하고 격리된 로컬 샌드박스로 제한하려면 이 설정을 사용 설정합니다. 사용 중지됨

외부 웹 액세스 관리

보안 정책에 따라 데이터 무단 반출을 방지하기 위해 외부 웹사이트에 대한 에이전트 액세스를 제어해야 하는 경우 이러한 설정을 사용하면 브라우저 액세스를 제한하거나 허용된 URL 목록으로 제한할 수 있습니다.

설정 설명 기본 상태
브라우저 액세스 외부 웹 액세스를 제어하려면 이 설정을 사용 설정합니다. 이렇게 하면 데이터 무단 반출을 방지하고 조직 경계를 정의할 수 있습니다. 사용 중지됨
허용된 URL 에이전트가 브라우저에서 액세스할 수 있는 허용된 URL 목록을 지정합니다. 구성되면 시스템에서 다른 모든 URL을 차단합니다.

이 설정은 Antigravity 브라우저 에이전트에만 적용됩니다. 채팅창에 /browser 명령어를 입력하여 Antigravity에서 브라우저 에이전트를 실행할 수 있습니다.

 없음. 기본적으로 차단되는 URL은 없습니다.
브라우저 JavaScript 자동 실행 모드 에이전트가 JavaScript를 실행하여 고급 웹 기반 코딩 및 테스트 작업을 지원하도록 하려면 이 설정을 사용 설정합니다. 다음 옵션을 사용할 수 있습니다.
  • 사용 중지됨: 에이전트가 JavaScript를 실행하지 못하도록 합니다.
  • 검토 요청: 에이전트가 JavaScript를 실행하기 전에 사용자에게 승인을 요청합니다.
  • 허용됨: 에이전트가 JavaScript를 자동으로 실행하도록 허용합니다.
 사용 중지됨

모델 컨텍스트 프로토콜 (MCP) 관리

모델 컨텍스트 프로토콜 (MCP) 서버에 대한 액세스를 구성하여 AI 에이전트가 추가 데이터 소스 및 도구에 안전하게 액세스할 수 있도록 할 수 있습니다.

설정 설명 기본 상태
MCP 서버 모델 컨텍스트 프로토콜 (MCP) 서버에 대한 액세스를 관리하여 AI의 데이터 컨텍스트를 안전하게 확장하려면 이 설정을 사용 설정합니다. 사용 중지됨
허용된 서버 구성 이 설정을 사용하면 관리자가 MCP 서버 액세스를 위한 특정 서버 구성을 정의할 수 있습니다. 관리자는 로컬 및 원격 MCP 서버의 구성이 포함된 JSON 객체로 허용 목록을 정의합니다. UI는 다음 필드에 대한 실시간 유효성 검사를 제공합니다.
  • 로컬 MCP 서버 (local_servers):
    • id (문자열): MCP 서버의 고유 식별자입니다.
    • command (문자열, 선택사항): 로컬 MCP 서버를 실행하는 명령어입니다. 지정된 경우 사용자의 로컬 구성을 재정의합니다.
    • args (문자열 배열, 선택사항): 명령어로 전달되는 인수입니다. 지정된 경우 사용자의 로컬 구성을 재정의합니다.
  • 원격 MCP 서버 (remote_servers):
    • id (문자열): MCP 서버의 고유 식별자입니다.
    • url (문자열, 선택사항): 원격 MCP 서버의 엔드포인트 URL입니다. 커스텀 원격 서버에 필요하며 사전 구성된 원격 서버에는 선택사항입니다.

구성 예시

{
  "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 사용 중지됨

모델 가용성 구성

이 섹션의 설정을 사용하여 특정 AI 모델을 승인하고 액세스 수준을 관리합니다. 이렇게 하면 개발자가 조직의 안전 및 사용 정책을 준수하는 AI 모델만 사용할 수 있습니다. 예를 들어 개발자에게 실험을 위한 미리보기 모델에 대한 액세스 권한을 부여하거나 승인된 모델만 사용하도록 도구를 제한할 수 있습니다.

모델을 구성하기 전의 주요 고려사항

모델을 구성하기 전에 다음 사항을 고려하세요.

  • 정책 정렬: Gemini Enterprise에서 모델을 사용 설정해도 Gemini Enterprise Agent Platform 조직 정책이 재정의되지는 않습니다. 표준 할당량을 초과하는 사용한 만큼만 지불 요청이 실패하지 않도록 허용된 모델이 두 플랫폼에서 모두 일치하는지 확인하세요.

  • 데이터 레지던시: 미리보기 모델과 Gemini 3 Pro Image 모델은 global 리전에서만 사용할 수 있습니다. 따라서 미국 또는 EU 멀티 리전에서 데이터 상주 (DRZ) 또는 머신러닝 (ML) 리전 처리 약정을 지원하지 않습니다. 자세한 내용은 Gemini Enterprise Standard 및 Plus 버전과 Gemini Notebook의 데이터 레지던시를 참조하세요.

  • 결제 정보 공개: Antigravity는 백그라운드 작업에 Gemini Flash Lite를 사용하고 이미지 생성에 Gemini 3 Pro Image를 사용합니다. 이러한 모델을 사용하면 결제 요금이 발생할 수 있습니다. 자세한 내용은 비용 보기를 참조하세요.

승인된 모델 구성

승인된 모델을 구성하여 AI 개발자 도구에서 사용할 수 있는 AI 모델을 제어할 수 있습니다.

설정 설명 기본 상태
Antigravity 승인 모델 프로젝트 내에서 Antigravity 도구가 사용할 수 있는 AI 모델을 지정하려면 이 설정을 사용 설정합니다. Gemini Enterprise AI 개발자 도구에서는 Made by Google 모델만 사용할 수 있습니다. 지원되는 모델에 대한 자세한 내용은 지원되는 모델 목록의 Enterprise 열을 참조하세요.