Panoramica della modalità express di Gemini Enterprise Agent Platform

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

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

Registrarsi alla modalità express

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

• Nuovi utenti: i nuovi utenti di Google Cloud possono registrarsi per un account in modalità express in un livello senza costi per provare Agent Platform senza costi per un massimo di 90 giorni, entro le quote specificate. Non è necessario fornire i dati di fatturazione per registrarsi al livello senza costi. Puoi eseguire l'upgrade a un livello a pagamento aggiungendo un account di fatturazione.

  Agent Platform in modalità express è separata dal Google Cloud programma senza costi e non è disponibile tramite questo programma. Se partecipi al Google Cloud programma senza costi, consulta le altre guide rapide nella sezione Inizia.

Per registrarti alla piattaforma dell'agente in modalità express, apri Modalità express dalla console Google Cloud :

Passare alla modalità express

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

• Tutorial: Agent Studio in modalità express
• Tutorial: API Agent Platform in modalità express

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 quanto segue:

• Funzionalità principali di Agent Studio. Testa e personalizza i prompt per diversi modelli di AI generativa e ottieni il codice corrispondente da utilizzare nella tua applicazione.
• Una chiave API. Autentica le richieste dalla tua applicazione.
• Livello senza costi per i nuovi utenti di Google Cloud per 90 giorni. Durante il limite di 90 giorni del livello senza costi per i nuovi utenti di Google Cloud , puoi utilizzare le API Agent Platform che supportano la modalità express senza costi, fino al raggiungimento delle quote. Non è necessario fornire i dati di fatturazione. Puoi aumentare i limiti di quota in qualsiasi momento abilitando la fatturazione.

Se sei un utente Google Cloud esistente o dopo aver attivato 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à Google Cloud aggiuntive. 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 della piattaforma per agenti:

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 servizi Google Cloud , 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 limitazione di frequenza in modalità express.	Limiti standard per il pagamento a consumo. Consulta la sezione Limiti di frequenza.
Formato standard degli endpoint API	Utilizza l'endpoint globale senza un ID progetto o una località e passa la chiave API nell'intestazione HTTP x-goog-api-key (o nel parametro di query key). Ad esempio: https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent	Specifica un ID progetto e una località. Ad esempio: https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

Modelli disponibili e limiti di frequenza in modalità express

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

Categoria del modello	Modelli disponibili	Numero massimo di richieste al minuto
Gemini	gemini-3-pro-image	Dinamico
	gemini-3.1-flash-image	Dinamico
	gemini-3.1-pro-preview	Dinamico
	gemini-3-flash-preview	Dinamico
	gemini-2.5-pro	10
	gemini-2.5-flash-image	10
	gemini-2.5-flash	10
	gemini-2.5-flash-lite	10

Solo i modelli elencati nella tabella precedente sono supportati in modalità express. I modelli API Gemini Live dedicati, come Gemini 3.8 Live (gemini-3.8-live) e API Gemini 2.5 Flash Live Native Audio (gemini-live-2.5-flash-native-audio), non sono supportati in modalità express e l'API Gemini Live non è disponibile nella Google Cloud console in modalità express. Per utilizzare i modelli dell'API Gemini Live supportati, esegui l'upgrade dalla modalità Express a un account Google Cloud standard.

Flusso di lavoro di Agent Platform in modalità express

Puoi iniziare a inviare richieste dalla tua applicazione alle API di Agent Platform in tre passaggi:

1. Dopo aver eseguito la registrazione alla modalità Express, utilizza Agent Studio per provare 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. Ottieni il codice per ciò che hai implementato con la UI.

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

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

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

   Vai a credenziali

   Poi, copia la chiave API Generative Language nel codice dove è indicato "YOUR_API_KEY". Ad esempio:

   Python

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

   • google-genai su PyPI
   • python-genai su GitHub

   Per saperne di più, consulta il riferimento all'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 API REST di Agent Platform in modalità express.

Inoltre, i clienti in Google Cloud utilizzano in genere 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 dei Google Cloud documenti a cui fai riferimento 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 posizione che hai selezionato durante la registrazione in modalità express viene utilizzata durante tutta l'esperienza.

Quando chiami gli endpoint API REST in modalità express, utilizza il formato dell'endpoint globale per la modalità express ed esegui l'autenticazione con la chiave API:

URL dell'endpoint standard	https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
URL dell'endpoint in modalità express	https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

Quando invii richieste REST in modalità express, tieni presente i seguenti dettagli di autenticazione e endpoint:

• Percorso del modello del publisher ({model}): nel riferimento all'API REST di Agent Platform in modalità express, i modelli di endpoint come https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent e https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent utilizzano {model} per rappresentare il percorso completo della risorsa del modello del publisher (publishers/google/models/MODEL_ID). Entrambi si risolvono nello stesso URL endpoint.
• Intestazione di autenticazione con chiave API: non è necessario passare la chiave API come parametro di query. Passa la chiave API nell'intestazione HTTP x-goog-api-key (ad esempio, -H "x-goog-api-key: API_KEY"). Se l'ambiente client non ti consente di impostare le intestazioni HTTP, puoi passare il parametro di query di sistema key (?key=API_KEY). Per saperne di più, consulta Utilizzare le chiavi API.

Visualizzare e gestire le chiavi API

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

Per scoprire 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 tue chiavi API:

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

   Vai a Chiavi API

Attivare 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 ciò che utilizzi. Puoi anche salvare i prompt e utilizzare impostazioni aggiuntive nella console Google Cloud , 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 console Google Cloud in modalità express, apri Fatturazione:

   Vai a Fatturazione

3. Gestisci i tuoi account di fatturazione.

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

La modalità Express è progettata per aiutarti a iniziare. Quando sei pronto per utilizzare altri serviziGoogle Cloud o hai bisogno di un maggiore controllo sul tuo ambiente, puoi eseguire la transizione del tuo account in modalità Express a un account Google Cloud standard. Questo processo è a volte 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 l'upgrade dalla modalità express, specifica l'ID progetto e la posizione anziché la chiave API quando chiami gli endpoint API REST. Ad esempio:

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