Specifica la posizione per accedere al modello

I modelli di AI generativa di Google sono disponibili in regioni specifiche. Puoi scegliere dove accedere al modello per soddisfare i requisiti di conformità, latenza, disponibilità e durabilità.

Quando utilizzi Firebase AI Logic, ogni richiesta che utilizza Agent Platform Gemini API (formerly Vertex AI) può includere facoltativamente la posizione per accedere al modello. Firebase AI Logic ha impostazioni di localizzazione predefinite.

• Quando utilizzi la nuova sintassi di inizializzazione "Agent Platform": global
• Quando utilizzi la sintassi di inizializzazione precedente "Vertex AI": us-central1

Informazioni sulla posizione global

Per quasi tutti i modelli Gemini, Agent Platform Gemini API (formerly Vertex AI) offre una posizione global, il che significa che la tua richiesta verrà gestita da un modello disponibile in qualsiasi punto del pool globale.

L'utilizzo della località global per le richieste può aiutarti a evitare di raggiungere i limiti di capacità del modello e ridurre gli errori "Servizio sovraccarico" (503). Inoltre, a seconda del modello, l'utilizzo della posizione global potrebbe essere obbligatorio perché è l'unica posizione disponibile per il modello (ad esempio, un modello di anteprima Gemini).

Quando è necessario impostare esplicitamente una posizione?

Firebase AI Logic ha valori predefiniti automatici per la posizione (ad esempio, global quando si utilizza la sintassi di inizializzazione "Agent Platform"). Tuttavia, se hai bisogno o vuoi utilizzare una posizione diversa, devi specificarla esplicitamente durante l'inizializzazione del servizio di backend Agent Platform Gemini API (formerly Vertex AI) nel codice.

A seconda del modello, l'impostazione esplicita di una posizione potrebbe essere obbligatoria. Se la tua richiesta tenta di accedere a un modello in una località in cui non è disponibile, riceverai un errore 404 che indica che il modello was not found or your project does not have access to it.

• Modelli anteprima e sperimentali Gemini: disponibili solo nella posizione global.

• Modelli stabiliGemini 3.x: disponibili nella località global e spesso nelle località us e eu.

• Modelli Gemini 2.5: Disponibili in molte località. Tieni presente che i modelli Gemini Live API 2.5 non sono disponibili in global.

Consulta l'elenco di tutte le località disponibili più avanti in questa pagina.

Fatti generali e best practice

Ecco alcuni fatti chiave e best practice sulle località:

• I limiti di capacità sono per modello, per regione e per minuto.

• Per evitare di raggiungere inaspettatamente i limiti di capacità, valuta la possibilità di utilizzare la posizione global (se il modello è disponibile nella posizione global).

• Valuta la possibilità di utilizzare Firebase Remote Config per controllare la posizione da cui accedi al modello. In questo modo, puoi modificare la posizione senza rilasciare una nuova versione dell'app.

• Se l'utilizzo della località global non è applicabile al tuo caso d'uso, valuta la possibilità di distribuire esplicitamente la posizione da cui accedi a un modello (se il modello è disponibile in località diverse da global). Ad esempio, puoi impostare la posizione in base a quella dell'utente finale utilizzando Firebase Remote Config.

Esempi di codice

Firebase AI Logic ha valori predefiniti automatici per la posizione (ad esempio, global quando si utilizza la sintassi di inizializzazione "Agent Platform"). Tuttavia, se hai bisogno o vuoi utilizzare una posizione diversa, devi specificarla esplicitamente durante l'inizializzazione del servizio di backend Agent Platform Gemini API (formerly Vertex AI) nel codice.

Sostituisci LOCATION con il codice della località (ad esempio global o us-central1) dall'elenco delle località disponibili più avanti in questa pagina.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

Tieni presente che se specifichi una località in cui il modello non è disponibile, riceverai un errore 404 che indica che il modello was not found or your project does not have access to it.

Località disponibili

Google Cloud utilizza regioni. Google Cloud memorizza i dati dei clienti solo nella regione specificata per tutte le funzionalità disponibili a livello generale di AI generativa su Agent Platform.

L'AI generativa su Agent Platform è disponibile nelle seguenti regioni. Alcuni modelli e/o versioni specifiche potrebbero non essere disponibili in tutte le località (per informazioni dettagliate sulla disponibilità delle località, consulta la documentazione Google Cloud).

Tieni presente quanto segue:

• Firebase AI Logic è impostato per impostazione predefinita sulle seguenti posizioni:

  • Quando utilizzi la nuova sintassi di inizializzazione "Agent Platform": global
  • Quando utilizzi la sintassi di inizializzazione precedente "Vertex AI": us-central1

• Modelli anteprima e sperimentali Gemini: disponibili solo nella posizione global.

• Modelli stabiliGemini 3.x: disponibili nella località global e spesso nelle località us e eu.

• Modelli Gemini 2.5: Disponibili in molte località. Tieni presente che i modelli Gemini Live API 2.5 non sono disponibili in global.

Gemini 3.x e modelli successivi

Quando utilizzi Gemini 3.x e modelli successivi, Firebase AI Logic supporta le seguenti località:

• global
• us
• eu

Per informazioni dettagliate sulle località disponibili per ciascun modello, consulta la documentazione di Google Cloud.

Modelli di generazioni precedenti

Quando utilizzi modelli Gemini meno recenti (come i modelli 2.5), Firebase AI Logic supporta le seguenti località:

Tieni presente che i modelli Gemini Live API 2.5 non sono disponibili in global.

Per informazioni dettagliate sulle località disponibili per ciascun modello, consulta la documentazione di Google Cloud.

Elenco delle località precedentemente disponibili, ma ora non più:

• Nessuna località è stata ancora rifiutata