익스프레스 모드의 Gemini Enterprise Agent Platform 개요

익스프레스 모드의 Gemini Enterprise Agent Platform을 사용하면 가입하고 에서 생성형 AI 애플리케이션 빌드를 시작할 수 있습니다. Google Cloud이 간소화된 설정 환경은 조직, 결제, 프로젝트 관리를 간소화하여 Google Cloud API에 대한 액세스를 간소화합니다.

익스프레스 모드의 Agent Platform에 대해 자세히 알아보려면 Google Cloud 익스프레스 모드 FAQ를 참조하세요.

익스프레스 모드 가입

Agent Platform은 @gmail.com Google 계정이 있는 개발자를 위한 익스프레스 모드로 제공됩니다.

익스프레스 모드의 Agent Platform에 가입하려면콘솔 Google Cloud 에서 익스프레스 모드 를 엽니다.

익스프레스 모드로 이동

설정이 완료된 후 다음 튜토리얼 중 하나를 따라 익스프레스 모드에서 Agent Platform을 사용할 수 있습니다.

익스프레스 모드의 Agent Platform 알아보기

익스프레스 모드에 가입하면 Google Cloud 사용자를 대신하여 API를 사용 설정합니다. 이 프로세스는 백그라운드에서 진행되므로 리소스를 수동으로 구성하지 않고도 Agent Platform을 사용할 수 있습니다.

익스프레스 모드에 가입하면 다음 항목에 액세스할 수 있습니다.

기존 Google Cloud 사용자이거나 결제를 사용 설정한 후에는 90 일 무료 등급이 삭제됩니다. 확장된 할당량 한도와 추가 Google Cloud 기능에 액세스하려면 유료 등급으로 전환합니다. 할당량이 증가하면 사용한 만큼만 비용을 지불하면 됩니다. 언제든지 익스프레스 모드를 종료하고 모든 Google Cloud 서비스와 기능을 사용할 수 있습니다.

다음 표에는 익스프레스 모드 환경과 전체 Agent Platform 환경 간의 차이점이 나와 있습니다.

항목 무료 등급의 Agent Platform 익스프레스 모드 전체 Agent Platform
시간 제한 90일 무제한
사용 가능한 서비스 기본 생성형 AI 서비스 Agent Platform을 비롯한 모든 Google Cloud 서비스
데이터 소스 Google Drive 에서 사용 가능한 모든 데이터 소스 Google Cloud
Quota 무료 등급 한도. 익스프레스 모드에서 사용 가능한 모델 및 비율 제한을 참조하세요. 표준 종량제 한도. 비율 제한을 참조하세요.
API 엔드포인트의 표준 형식 프로젝트 ID 또는 위치 없이 전역 엔드포인트를 사용하고 x-goog-api-key HTTP 헤더 (또는 key 쿼리 매개변수)에 API 키를 전달합니다. 예를 들면 다음과 같습니다.
https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent 		프로젝트 ID와 위치를 지정합니다. 예를 들면 다음과 같습니다.
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

익스프레스 모드에서 사용 가능한 모델 및 비율 제한

Gemini Flash 모델을 비롯한 여러 모델을 익스프레스 모드에서 사용해 볼 수 있습니다. 다음 표에는 익스프레스 모드에서 사용 가능한 모델과 비율 제한이 나와 있습니다.

모델 카테고리 사용 가능한 모델 분당 최대 요청 수
Gemini gemini-3-pro-image 동적
gemini-3.1-flash-image 동적
gemini-3.1-pro-preview 동적
gemini-3-flash-preview 동적
gemini-2.5-pro 10
gemini-2.5-flash-image 10
gemini-2.5-flash 10
gemini-2.5-flash-lite 10

익스프레스 모드에서는 위 표에 나열된 모델만 지원됩니다. Gemini 3.8 Live(gemini-3.8-live) 및 Gemini 2.5 Flash Live API 네이티브 오디오(gemini-live-2.5-flash-native-audio)와 같은 전용 Gemini Live API 모델은 익스프레스 모드에서 지원되지 않으며 익스프레스 모드의Google Cloud 콘솔에서는 Gemini Live API를 사용할 수 없습니다. 지원되는 Gemini Live API 모델을 사용하려면, 익스프레스 모드에서 표준 Google Cloud 계정으로 업그레이드하세요.

익스프레스 모드 워크플로의 Agent Platform

다음 세 단계로 애플리케이션에서 Agent Platform API로 요청 전송을 시작할 수 있습니다.

  1. 익스프레스 모드에 가입한 후 Agent Studio를 사용하여 Agent Platform 기능을 사용해 봅니다.

    Agent Studio로 이동

    예를 들어 Agent Studio > 프롬프트 만들기 를 선택하여 다양한 Gemini 모델을 사용하여 멀티모달 프롬프트를 만들고 최적화합니다.

  2. UI로 구현한 코드 가져오기

    프롬프트 페이지에서 코드로 빌드 > 코드 가져오기 를 클릭합니다. UI에서 구현한 것과 동일한 요청을 프로그래매틱 방식으로 전송하는 코드가 표시된 패널이 열립니다. 프로그래밍 언어 또는 curl의 코드를 가져올 수 있습니다. Google Colab을 사용하여 Python 코드를 사용해 볼 수 있습니다.

  3. API 키를 사용하여 Agent Platform API로 인증합니다.

    익스프레스 모드의 Google Cloud 콘솔에서 API 및 서비스 > 사용자 인증 정보 를 엽니다.

    사용자 인증 정보로 이동

    그런 다음 Generative Language API 키를 "YOUR_API_KEY"라고 표시된 코드에 복사합니다. 예를 들면 다음과 같습니다.

    Python

    Python용 Google 생성형 AI SDK는 PyPI 및 GitHub에서 사용 가능합니다.

    자세한 내용은 Python SDK 참조 (새 탭에서 열기)를 확인하세요. 

    from google import genai

# TODO(developer): Update below line
API_KEY = "YOUR_API_KEY"

client = genai.Client(vertexai=True, api_key=API_KEY)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain bubble sort to me.",
)

print(response.text)
# Example response:
# Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

익스프레스 모드의 차이점

익스프레스 모드의 Agent Platform은 생성형 AI의 기능 하위 집합을 제공합니다. 따라서 익스프레스 모드에 가입한 경우 일부 Agent Platform 문서는 관련이 없습니다. 익스프레스 모드에서 사용 가능한 API 엔드포인트에 대한 자세한 내용은 익스프레스 모드의 Agent Platform REST API 참조를 확인하세요.

또한 고객은 일반적으로 Google Cloud 조직 및 프로젝트를 사용하여 리소스와 상호작용합니다 (예: API 엔드포인트 호출). 익스프레스 모드에서 Agent Platform을 사용하는 경우 조직 또는 프로젝트에 대해 걱정할 필요가 없습니다. 하지만 익스프레스 모드에서 Agent Platform을 사용하는 동안 참조하는 일부 Google Cloud 문서에 언급될 수 있습니다. 문서를 계속 사용할 수 있지만 조직 및 프로젝트를 참조하는 개념과 안내는 무시하세요. 또한 익스프레스 모드에 가입할 때 선택한 위치는 환경 전반에서 사용됩니다.

익스프레스 모드에서 REST API 엔드포인트를 호출할 때는 익스프레스 모드의 전역 엔드포인트 형식을 사용하고 API 키로 인증합니다.

표준 엔드포인트 URL https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
익스프레스 모드의 엔드포인트 URL https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

익스프레스 모드에서 REST 요청을 보낼 때는 다음 엔드포인트 및 인증 세부정보를 염두에 두세요.

API 키 보기 및 관리

익스프레스 모드를 지원하는 Agent Platform API 엔드포인트로 인증하려면 가입 중에 생성된 API 키 또는 익스프레스 모드에서 생성한 키를 사용합니다. API 키는 익스프레스 모드에 가입할 때 자동으로 생성되는 암호화된 문자열입니다. 이러한 API 키는 API 및 서비스 페이지에서 보고 관리할 수 있습니다.

API 키 관리 권장사항에 대한 자세한 내용은 API 키 관리 권장사항을 참조하세요.

API 키를 보고 관리하려면 다음 단계를 따르세요.

  1. 콘솔 Google Cloud 에서 API 키 페이지로 이동합니다.

    API 키로 이동

결제 사용 설정 및 관리

결제를 사용 설정하면 할당량을 늘리고 90일 제한을 삭제할 수 있습니다.

결제를 사용 설정한 후에는 사용한 만큼만 비용을 지불하면 됩니다. 또한 결제가 사용 설정되지 않은 경우 흐리게 표시되는 콘솔에서 프롬프트를 저장하고 추가 설정을 사용할 수 있습니다. Google Cloud

결제를 관리하려면 다음 단계를 따르세요.

  1. 익스프레스 모드의 Agent Studio 개요 페이지로 이동합니다.

    Agent Studio로 이동

  2. 익스프레스 모드의 Google Cloud 콘솔에서 결제 를 엽니다.

    결제로 이동

  3. 결제 계정을 관리합니다.

모든 Google Cloud 기능 및 서비스 사용 시작

익스프레스 모드는 시작하는 데 도움이 되도록 설계되었습니다. 다른 Google Cloud 서비스를 사용하거나 환경을 더 세부적으로 제어해야 하는 경우 익스프레스 모드 계정을 표준 Google Cloud 계정으로 전환할 수 있습니다. 이 프로세스를 업그레이드 라고도 합니다.

익스프레스 모드 계정을 업그레이드하여 프로젝트에서 사용 가능한 모든기능과 서비스를 사용할 수 있습니다. Google Cloud

익스프레스 모드에서 업그레이드하려면 다음 단계를 따르세요.

  1. 익스프레스 모드의 Agent Studio 개요 페이지로 이동합니다.

    Agent Studio로 이동

  2. 지금 활성화 를 클릭하고 안내에 따라 진행합니다.

익스프레스 모드에서 업그레이드한 후에는 REST API 엔드포인트를 호출할 때 API 키 대신 프로젝트 ID와 위치를 지정합니다. 예를 들면 다음과 같습니다.

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent