Ringkasan Gemini Enterprise Agent Platform dalam mode ekspres

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dengan Gemini Enterprise Agent Platform dalam mode ekspres, Anda dapat mendaftar dan mulai membangun aplikasi AI generatif di Google Cloud. Pengalaman penyiapan yang disederhanakan ini memudahkan akses ke API Google Cloud dengan menyederhanakan pengelolaan organisasi, penagihan, dan project.

Untuk mempelajari lebih lanjut Agent Platform dalam mode ekspres, lihat FAQ mode ekspres Google Cloud.

Mendaftar ke mode ekspres

Agent Platform tersedia dalam mode ekspres untuk developer dengan @gmail.com Akun Google:

• Pengguna baru: Pengguna baru Google Cloud dapat mendaftar ke akun mode ekspres dalam paket gratis untuk mencoba Agent Platform secara gratis hingga 90 hari, dalam kuota yang ditentukan. Anda tidak perlu memberikan informasi penagihan untuk mendaftar di tingkat gratis. Anda dapat mengupgrade ke paket berbayar dengan menambahkan akun penagihan.

  Agent Platform dalam mode ekspres terpisah dari, dan tidak tersedia melalui, Google Cloud Program Gratis. Jika Anda mengikuti Google Cloud Program Gratis, lihat panduan memulai lainnya di bagian Mulai.

Untuk mendaftar ke Agent Platform dalam mode ekspres, buka Express Mode dari konsol Google Cloud :

Buka Mode Ekspres

Setelah penyiapan selesai, Anda dapat mulai menggunakan Agent Platform dalam mode ekspres dengan mengikuti salah satu tutorial:

• Tutorial: Agent Studio dalam mode ekspres
• Tutorial: Agent Platform API dalam mode ekspres

Mempelajari Agent Platform dalam mode ekspres

Saat Anda mendaftar ke mode ekspres, Google Cloud API akan diaktifkan untuk Anda. Proses ini terjadi di latar belakang, sehingga Anda dapat mulai menggunakan Agent Platform tanpa perlu mengonfigurasi resource secara manual.

Saat mendaftar ke mode ekspres, Anda akan mendapatkan akses ke hal berikut:

• Fitur inti Agent Studio. Uji dan sesuaikan perintah untuk berbagai model AI generatif, dan dapatkan kode yang sesuai untuk digunakan dalam aplikasi Anda.
• Kunci API. Mengautentikasi permintaan dari aplikasi Anda.
• Paket gratis untuk pengguna Google Cloud baru selama 90 hari. Selama batas 90 hari tingkat gratis untuk pengguna Google Cloud baru, Anda dapat menggunakan Agent Platform API yang mendukung mode ekspres secara gratis, hingga kuota mereka. Anda tidak perlu memberikan informasi penagihan. Anda dapat meningkatkan batas kuota kapan saja dengan mengaktifkan penagihan.

Jika Anda adalah pengguna Google Cloud lama atau setelah mengaktifkan penagihan, paket gratis 90 hari akan dihapus. Anda beralih ke paket berbayar untuk mengakses batas kuota yang diperpanjang dan fitur Google Cloud tambahan. Seiring peningkatan kuota, Anda hanya membayar sesuai penggunaan. Kapan saja, Anda dapat memilih untuk mengakhiri mode ekspres dan mulai menggunakan semua layanan dan kemampuan Google Cloud .

Tabel berikut mencantumkan perbedaan antara pengalaman mode ekspres dan pengalaman Agent Platform lengkap:

Item	Mode ekspres Agent Platform di Paket Gratis	Full Agent Platform
Batas waktu	90 hari	Tidak terbatas
Layanan yang tersedia	Layanan AI generatif dasar.	Semua Google Cloud layanan, termasuk Agent Platform.
Sumber data	Google Drive	Semua sumber data yang tersedia di Google Cloud.
Kuota	Batas paket gratis. Lihat Model dan pembatasan kapasitas yang tersedia dalam mode ekspres.	Batas bayar sesuai penggunaan standar. Lihat Batas kecepatan.
Format standar endpoint API	Gunakan endpoint global tanpa project ID atau lokasi, dan teruskan kunci API Anda di header HTTP x-goog-api-key (atau parameter kueri key). Contoh: https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent	Tentukan project ID dan lokasi. Contoh: https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

Model yang tersedia dan pembatasan kapasitas dalam mode ekspres

Anda dapat mencoba beberapa model dalam mode ekspres, termasuk model Gemini Flash. Tabel berikut mencantumkan model yang tersedia dalam mode ekspres, beserta batas kapasitasnya:

Kategori model	Model yang tersedia	Permintaan maksimum per menit
Gemini	gemini-3-pro-image	Dinamis
	gemini-3.1-flash-image	Dinamis
	gemini-3.1-pro-preview	Dinamis
	gemini-3-flash-preview	Dinamis
	gemini-2.5-pro	10
	gemini-2.5-flash-image	10
	gemini-2.5-flash	10
	gemini-2.5-flash-lite	10

Hanya model yang tercantum dalam tabel sebelumnya yang didukung dalam mode ekspres. Model Gemini Live API khusus, seperti Gemini 3.8 Live (gemini-3.8-live) dan Gemini 2.5 Flash Live API Native Audio (gemini-live-2.5-flash-native-audio), tidak didukung dalam mode ekspres, dan Gemini Live API tidak tersedia di konsolGoogle Cloud dalam mode ekspres. Untuk menggunakan model Gemini Live API yang didukung, lakukan upgrade dari mode ekspres ke akun Google Cloud standar.

Alur kerja Agent Platform dalam mode ekspres

Anda dapat mulai mengirim permintaan dari aplikasi Anda ke API Agent Platform dalam tiga langkah:

1. Setelah mendaftar ke mode ekspres, gunakan Agent Studio untuk mencoba fitur Agent Platform:

   Buka Agent Studio

   Misalnya, pilih Agent Studio > Create prompt untuk membuat dan mengoptimalkan multimodal prompting menggunakan berbagai model Gemini.

2. Dapatkan kode untuk apa yang Anda terapkan dengan UI.

   Di halaman perintah, klik Build with code > Get code. Panel akan terbuka dan menampilkan kode yang secara terprogram mengirimkan permintaan yang sama dengan yang Anda terapkan di UI. Anda bisa mendapatkan kode untuk bahasa pemrograman atau curl. Anda dapat menggunakan Google Colab untuk mencoba kode Python.

3. Gunakan kunci API Anda untuk melakukan autentikasi dengan Agent Platform API.

   Di konsol Google Cloud dalam mode ekspres, buka APIs & Services > Credentials:

   Buka Kredensial

   Kemudian, salin Kunci API Generative Language ke dalam kode Anda di tempat yang bertuliskan "YOUR_API_KEY". Contoh:

   Python

   Google Gen AI SDK for Python tersedia di PyPI dan GitHub:

   • google-genai di PyPI
   • python-genai di GitHub

   Untuk mempelajari lebih lanjut, lihat referensi Python SDK (terbuka di tab baru).

   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

Yang berbeda dalam mode ekspres

Agent Platform dalam mode ekspres menyediakan subset fitur untuk AI generatif. Oleh karena itu, beberapa dokumentasi Agent Platform tidak relevan jika Anda mendaftar dalam mode ekspres. Untuk mengetahui detail tentang endpoint API yang tersedia dalam mode ekspres, lihat referensi REST API Agent Platform dalam mode ekspres.

Selain itu, pelanggan di Google Cloud biasanya menggunakan organisasi dan project untuk menggunakan resource (misalnya, untuk memanggil endpoint API). Saat menggunakan Agent Platform dalam mode ekspres, Anda tidak perlu mengkhawatirkan organisasi atau project. Namun, Anda mungkin melihatnya disebutkan dalam beberapa dokumentasi Google Cloud yang Anda referensikan saat menggunakan Agent Platform dalam mode ekspres. Anda tetap dapat menggunakan dokumentasi, tetapi abaikan konsep dan petunjuk yang merujuk ke organisasi dan project. Selain itu, lokasi yang Anda pilih saat mendaftar dalam mode ekspres akan digunakan di seluruh pengalaman Anda.

Saat memanggil endpoint REST API dalam mode ekspres, gunakan format endpoint global untuk mode ekspres dan autentikasi dengan kunci API Anda:

URL endpoint standar	https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
URL endpoint dalam mode ekspres	https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

Perhatikan detail endpoint dan autentikasi berikut saat mengirim permintaan REST dalam mode ekspres:

• Jalur model penayang ({model}): Dalam Referensi REST API Agent Platform dalam mode ekspres, template endpoint seperti https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent dan https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent menggunakan {model} untuk merepresentasikan jalur resource model penayang lengkap (publishers/google/models/MODEL_ID). Keduanya di-resolve ke URL endpoint yang sama.
• Header autentikasi kunci API: Anda tidak perlu meneruskan kunci API sebagai parameter kueri. Teruskan kunci API Anda di header HTTP x-goog-api-key (misalnya, -H "x-goog-api-key: API_KEY"). Jika lingkungan klien tidak memungkinkan Anda menyetel header HTTP, Anda dapat meneruskan parameter kueri sistem key sebagai gantinya (?key=API_KEY). Untuk mengetahui informasi selengkapnya, lihat Menggunakan kunci API.

Melihat dan mengelola kunci API

Untuk melakukan autentikasi dengan endpoint API Agent Platform yang mendukung mode ekspres, gunakan kunci API yang dibuat untuk Anda selama pendaftaran atau kunci apa pun yang telah Anda buat dalam mode ekspres. Kunci API adalah string terenkripsi yang dibuat otomatis untuk Anda saat Anda mendaftar dalam mode ekspres. Kunci API ini dapat dilihat dan dikelola di halaman APIs & Services.

Untuk mempelajari lebih lanjut praktik terbaik dalam mengelola kunci API, lihat Praktik terbaik untuk mengelola kunci API.

Untuk melihat dan mengelola kunci API Anda, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Kunci API:

   Buka Kunci API

Mengaktifkan dan mengelola penagihan

Anda dapat meningkatkan kuota dan menghapus batas 90 hari dengan mengaktifkan penagihan.

Setelah mengaktifkan penagihan, Anda hanya membayar sesuai penggunaan. Anda juga dapat menyimpan perintah dan menggunakan setelan tambahan di Google Cloud konsol yang berwarna abu-abu jika penagihan tidak diaktifkan.

Untuk mengelola penagihan, lakukan tindakan berikut:

1. Buka halaman Ringkasan Agent Studio dalam mode ekspres.

   Buka Agent Studio

2. Di konsol Google Cloud dalam mode ekspres, buka Billing:

   Buka Penagihan

3. Mengelola akun penagihan Anda.

Mulai gunakan semua kemampuan dan layanan Google Cloud

Mode ekspres dirancang untuk membantu Anda memulai. Jika Anda siap menggunakan layananGoogle Cloud lain atau memerlukan kontrol yang lebih besar terhadap lingkungan Anda, Anda dapat mengalihkan akun mode ekspres ke akun Google Cloud standar. Proses ini terkadang disebut upgrade.

Anda dapat mulai menggunakan semua kemampuan dan layanan yang tersedia di Google Cloud dalam project Anda dengan mengupgrade akun mode ekspres Anda.

Untuk melakukan upgrade dari mode ekspres, lakukan hal berikut:

1. Buka halaman Ringkasan Agent Studio dalam mode ekspres.

   Buka Agent Studio

2. Klik Aktifkan sekarang dan ikuti petunjuknya.

Setelah mengupgrade dari mode ekspres, tentukan ID project dan lokasi Anda, bukan kunci API saat memanggil endpoint REST API. Contoh:

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