Panoramica della modalità express di Gemini Enterprise Agent Platform

Con Agent Platform in modalità express, puoi registrarti rapidamente e iniziare a creare applicazioni di AI generativa su Google Cloud. Questa esperienza di configurazione semplificata ottimizza l'accesso alle Google Cloud API semplificando l'organizzazione, la fatturazione e la gestione dei progetti.

Per saperne di più su Agent Platform in modalità express, consulta le domande frequenti sulla modalità express di Google Cloud.

Registrati alla modalità express

Agent Platform è disponibile in modalità express per gli sviluppatori con un @gmail.com Account Google:

Per registrarti ad Agent Platform in modalità express, accedi a Modalità express dalla Google Cloud console:

Vai alla modalità express

Una volta configurato, puoi iniziare a utilizzare Agent Platform in modalità express seguendo uno dei tutorial:

Scopri di più su Agent Platform in modalità express

Quando ti registri alla modalità express, Google Cloud abilita le API per tuo conto. Questo processo avviene in background, quindi puoi iniziare a utilizzare Agent Platform senza dover configurare manualmente le risorse.

Quando ti registri alla modalità express, hai accesso a:

  • Funzionalità principali di Agent Studio. Testa e personalizza rapidamente i prompt per diversi modelli di AI generativa e ottieni il codice corrispondente da utilizzare nella tua applicazione.
  • Una chiave API. Autenticati rapidamente dalla tua applicazione.
  • Livello senza costi per i nuovi Google Cloud utenti durante 90 giorni. Durante il limite di 90 giorni del livello senza costi per i nuovi Google Cloud utenti, puoi utilizzare senza costi le API Agent Platform che supportano la modalità express, fino ai rispettivi limiti di quota. Non devi fornire informazioni sulla fatturazione. Puoi aumentare i limiti di quota in qualsiasi momento abilitando la fatturazione.

Se sei un utente esistente Google Cloud o dopo aver abilitato la fatturazione, il livello senza costi di 90 giorni viene rimosso. Passi a un livello a pagamento per accedere a limiti di quota estesi e funzionalità aggiuntive Google Cloud . Man mano che le quote aumentano, paghi solo per ciò che utilizzi. In qualsiasi momento, puoi scegliere di terminare la modalità express e iniziare a utilizzare tutti i Google Cloud servizi e le funzionalità.

La seguente tabella elenca le differenze tra le esperienze in modalità express e l'esperienza completa di Agent Platform:

Elemento Modalità express di Agent Platform nel livello senza costi Agent Platform completa
Limite di tempo 90 giorni Illimitato
Servizi disponibili Servizi di AI generativa di base. Tutti i Google Cloud servizi, inclusa Agent Platform.
Origini dati Google Drive Tutte le origini dati disponibili in Google Cloud.
Quota Limiti del livello senza costi. Consulta Modelli disponibili e limiti di frequenza in modalità express. Limiti standard con pagamento a consumo. Consulta Limiti di frequenza.
Formato standard degli endpoint API Specifica la chiave API anziché l'ID progetto e la località. Ad esempio:
https://aiplatform.googleapis.com/v1/publishers/google/models/{model}:streamGenerateContent?key={API_KEY} 		Specifica l'ID progetto e la località. Ad esempio:
https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:streamGenerateContent

Modelli disponibili e limiti di frequenza in modalità express

Puoi provare diversi modelli in modalità express, inclusi gli ultimi modelli Gemini Flash. La seguente tabella elenca i modelli disponibili in modalità express, insieme ai relativi limiti di frequenza:

Categoria di modelli Modelli disponibili Numero massimo di richieste al minuto
Gemini gemini-3.1-flash-image-preview Dinamico
gemini-3.1-pro-preview Dinamico
gemini-3-flash-preview Dinamico
gemini-3-pro-preview Dinamico
gemini-3-pro-image-preview Dinamico
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

Per i modelli Gemini 2.0, la Live API non è disponibile nella Google Cloud console in modalità express. Per utilizzare l'API Live in modalità express, utilizza l'API Agent Platform o l'SDK Google Gen AI.

Flusso di lavoro di Agent Platform in modalità express

Puoi iniziare a inviare richieste dalle tue applicazioni alle API Agent Platform in tre passaggi:

  1. Dopo aver eseguito la registrazione alla modalità express, utilizza Agent Studio per provare rapidamente le funzionalità di Agent Platform:

    Vai ad Agent Studio

    Ad esempio, seleziona Agent Studio > Crea prompt per creare e ottimizzare i prompt multimodali utilizzando una varietà di modelli Gemini.

  2. Recupera il codice per ciò che hai implementato con l'interfaccia utente.

    Nella pagina del prompt, fai clic su Crea con codice > Recupera codice. Si apre un riquadro che mostra il codice che invia a livello di programmazione le stesse richieste che hai implementato nell'interfaccia utente. Puoi recuperare il codice per un linguaggio di programmazione o curl. Puoi utilizzare Google Colab per provare il codice Python.

  3. Utilizza la chiave API per l'autenticazione con l'API Agent Platform.

    Nella Google Cloud console in modalità express, apri API e servizi > Credenziali:

    Vai a credenziali

    Quindi, copia la chiave API Generative Language nel codice in cui è indicato "YOUR_API_KEY". Ad esempio:

    Python

    L'SDK Google Gen AI per Python è disponibile su PyPI e GitHub:

    Per saperne di più, consulta il riferimento dell'SDK Python (si apre in una nuova scheda). 

    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

Differenze nella modalità express

Agent Platform in modalità express fornisce un sottoinsieme delle funzionalità per l'AI generativa. Pertanto, parte della documentazione di Agent Platform non è pertinente se hai eseguito la registrazione in modalità express. Per informazioni dettagliate sugli endpoint API disponibili in modalità express, consulta il riferimento dell'API REST di Agent Platform in modalità express.

Inoltre, i clienti in Google Cloud in genere utilizzano organizzazioni e progetti per lavorare con le risorse (ad esempio, per chiamare un endpoint API). Quando utilizzi Agent Platform in modalità express, non devi preoccuparti di organizzazioni o progetti. Tuttavia, potresti vederli menzionati in alcuni documenti di riferimento Google Cloud mentre utilizzi Agent Platform in modalità express. Puoi comunque utilizzare la documentazione, ma ignora i concetti e le istruzioni che fanno riferimento a organizzazioni e progetti. Inoltre, la località selezionata durante la registrazione in modalità express viene utilizzata durante l'esperienza.

Quando chiami gli endpoint API REST in modalità express, utilizzerai il formato dell'endpoint per la modalità express e specificherai la chiave API. Ad esempio:

URL dell'endpoint standard https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:streamGenerateContent
URL dell'endpoint in modalità express https://aiplatform.googleapis.com/v1/publishers/google/models/{model}:streamGenerateContent?key={API_KEY}

Visualizzare e gestire le chiavi API

Per eseguire l'autenticazione con gli endpoint API Agent Platform che supportano la modalità express , utilizza la chiave API creata durante la registrazione o qualsiasi chiave creata in modalità express. Una chiave API è una stringa criptata che viene generata automaticamente quando ti registri in modalità express. Queste chiavi API possono essere visualizzate e gestite nella pagina API e servizi.

Per saperne di più sulle best practice per la gestione delle chiavi API, consulta Best practice per la gestione delle chiavi API.

Per visualizzare e gestire le chiavi API:

  1. Nella Google Cloud console, vai alla pagina Chiavi API:

    Vai a Chiavi API

Abilitare e gestire la fatturazione

Puoi aumentare le quote e rimuovere il limite di 90 giorni abilitando la fatturazione.

Dopo aver abilitato la fatturazione, paghi solo per ciò che utilizzi. Puoi anche salvare i prompt e accedere ad altre impostazioni nella Google Cloud console che sono disattivate quando la fatturazione non è abilitata.

Per gestire la fatturazione:

  1. Vai alla pagina Panoramica di Agent Studio in modalità express.

    Vai ad Agent Studio

  2. Nella Google Cloud console in modalità express, apri Fatturazione:

    Vai a Fatturazione

  3. Gestisci gli account di fatturazione.

Inizia a utilizzare tutte le funzionalità e i servizi Google Cloud

La modalità express è progettata per aiutarti a iniziare rapidamente. Quando vuoi utilizzare altri servizi o hai bisogno di un maggiore controllo sul tuo ambiente, puoi eseguire la transizione del tuo account in modalità express a un account standard. Google Cloud Google Cloud Questo processo è talvolta chiamato upgrade.

Puoi iniziare a utilizzare tutte le funzionalità e i servizi disponibili in Google Cloud nel tuo progetto eseguendo l'upgrade del tuo account in modalità express.

Per eseguire l'upgrade dalla modalità express:

  1. Vai alla pagina Panoramica di Agent Studio in modalità express.

    Vai ad Agent Studio

  2. Fai clic su Attiva ora e segui le istruzioni.

Dopo aver eseguito l'upgrade dalla modalità express, specifica l'ID progetto e la località anziché la chiave API quando chiami gli endpoint API REST. Ad esempio:

https://{location}-aiplatform.googleapis.com/v1/projects/{projectid}/locations/{location}/publishers/google/models/{model}:streamGenerateContent