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

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

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

익스프레스 모드 가입

@gmail.com Google 계정이 있는 개발자는 익스프레스 모드에서 Agent Platform을 사용할 수 있습니다.

  • 신규 사용자: Google Cloud 의 신규 사용자는 무료 등급에서 익스프레스 모드 계정에 가입하여 지정된 할당량 내에서 최대 90일 동안 Agent Platform을 무료로 사용해 볼 수 있습니다. 무료 등급에 가입할 때는 결제 정보를 제공하지 않아도 됩니다. 결제 계정을 추가하여 유료 등급으로 업그레이드할 수 있습니다.

    익스프레스 모드의 Agent Platform은 Google Cloud 무료 프로그램과 별개이며 이 프로그램을 통해 사용할 수 없습니다. Google Cloud 무료 프로그램에 참여하는 경우 시작하기 섹션의 다른 빠른 시작을 참고하세요.

익스프레스 모드에서 Agent Platform에 가입하려면 Google Cloud 콘솔에서 익스프레스 모드에 액세스하세요.

익스프레스 모드로 이동

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

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

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

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

  • 핵심 Agent Studio 기능 다양한 생성형 AI 모델의 프롬프트를 빠르게 테스트하고 맞춤설정할 수 있으며, 해당 코드를 가져와 애플리케이션에서 사용할 수 있습니다.
  • API 키 애플리케이션에서 빠르게 인증하세요.
  • 신규 Google Cloud 사용자를 위한 90일간의 무료 등급 신규 Google Cloud 사용자의 무료 등급 90일 한도 동안 익스프레스 모드를 지원하는 Agent Platform API를 할당량 한도까지 무료로 사용할 수 있습니다. 결제 정보를 제공하지 않아도 됩니다. 결제를 사용 설정하면 언제든지 할당량 한도를 늘릴 수 있습니다.

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

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

항목 무료 등급의 Agent Platform 익스프레스 모드 전체 Agent Platform
시간 제한 90일 무제한
사용 가능한 서비스 기본 생성형 AI 서비스 Agent Platform을 비롯한 모든 Google Cloud 서비스
데이터 소스 Google Drive Google Cloud에서 사용 가능한 모든 데이터 소스
할당량 무료 등급 한도 익스프레스 모드에서 사용 가능한 모델 및 비율 제한을 참고하세요. 표준 사용한 만큼만 지불 한도입니다. 비율 제한을 참고하세요.
API 엔드포인트의 표준 형식 프로젝트 ID와 위치 대신 API 키를 지정합니다. 예를 들면 다음과 같습니다.
https://aiplatform.googleapis.com/v1/publishers/google/models/{model}:streamGenerateContent?key={API_KEY} 		프로젝트 ID와 위치를 지정합니다. 예를 들면 다음과 같습니다.
https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:streamGenerateContent

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

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

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

Gemini 2.0 모델의 경우Google Cloud 콘솔의 익스프레스 모드에서 Live API를 사용할 수 없습니다. Express 모드에서 Live API를 사용하려면 Agent Platform API 또는 Google 생성형 AI SDK를 사용하세요.

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

다음 세 단계로 애플리케이션에서 Agent Platform API로 요청을 보낼 수 있습니다.

  1. 익스프레스 모드에 가입한 후 Agent Studio를 사용하여 Agent Platform 기능을 빠르게 사용해 보세요.

    Agent Studio로 이동

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

  2. UI로 구현한 항목의 코드를 가져옵니다.

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

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

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

    사용자 인증 정보로 이동

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

    Python

    Python용 Google Gen 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-2.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}/locations/{location}/publishers/google/models/{model}:streamGenerateContent
익스프레스 모드의 엔드포인트 URL https://aiplatform.googleapis.com/v1/publishers/google/models/{model}:streamGenerateContent?key={API_KEY}

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/{projectid}/locations/{location}/publishers/google/models/{model}:streamGenerateContent