Panoramica della modalità express di Gemini Enterprise Agent Platform

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 dell'organizzazione, della fatturazione e dei progetti.

Per scoprire di più su Agent Platform in modalità Express, consulta le domande frequenti sulla modalità Express diGoogle Cloud.

Registrati 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 nel Livello senza costi per provare Agent Platform senza costi per un massimo di 90 giorni, entro le quote specificate. Non è necessario fornire dati di fatturazione per registrarti 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 programma senza costiGoogle Cloud e non è disponibile tramite questo programma. Se partecipi al Google Cloud programma senza costi, consulta le altre guide rapide nella sezione Inizia.

Per registrarti ad Agent Platform in modalità express, apri la modalità express dalla console Google Cloud :

Passa alla modalità Express

Dopo la configurazione, 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, ottieni l'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. Autenticare 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 alle relative 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 servizi e le funzionalità di Google Cloud .

La tabella seguente elenca le differenze tra le esperienze in modalità Express e l'esperienza completa della piattaforma Agent:

Modelli e limitazioni di frequenza disponibili 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:

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

Flusso di lavoro di Agent Platform in modalità Express

Puoi iniziare a inviare richieste dalla tua applicazione alle API 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 > Genera codice. Si apre un riquadro che mostra il codice che invia in modo programmatico le stesse richieste che hai implementato nella UI. Puoi ottenere il codice per un linguaggio di programmazione o curl. Puoi utilizzare Google Colab per provare il codice Python.

3. Utilizza la tua chiave API per autenticarti 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 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 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 parte della documentazione di Google Cloud 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 località selezionata al momento della registrazione in modalità Express viene utilizzata durante l'intera 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 tua chiave API:

Tieni presente i seguenti dettagli relativi all'endpoint e all'autenticazione quando invii richieste REST in modalità Express:

• Percorso del modello del publisher ({model}): nel Riferimento 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 vengono risolti nello stesso URL dell'endpoint.
• Intestazione di autenticazione della 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 Utilizza le chiavi API.

Visualizza e gestisci le chiavi API

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

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

   Vai a Chiavi API

Attiva e gestisci la fatturazione

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

Dopo aver abilitato la fatturazione, paghi solo per quello che utilizzi. Puoi anche salvare i prompt e utilizzare le impostazioni aggiuntive nella console Google Cloud che non sono selezionabili 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 vuoi 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 viene talvolta chiamato upgrade.

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

Per eseguire l'upgrade dalla modalità Express, segui questi passaggi:

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 località 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