Modele erişilecek konumu belirtin

Google'ın üretken yapay zeka modelleri belirli bölgelerde kullanılabilir. Uygunluk, gecikme, kullanılabilirlik ve dayanıklılık gereksinimlerinizi karşılamak için modele nereden erişeceğinizi seçebilirsiniz.

Firebase AI Logic kullanırken Agent Platform Gemini API (formerly Vertex AI) kullanan her isteğiniz, modele erişmek için isteğe bağlı olarak konumu içerebilir. Firebase AI Logic, varsayılan konum ayarlarına sahip.

• Yeni "Agent Platform" başlatma söz dizimini kullanırken: global
• Eski "Vertex AI" başlatma söz dizimini kullanırken: us-central1

global konumu hakkında

Neredeyse tüm Gemini modelleri için Agent Platform Gemini API (formerly Vertex AI), global konumu sunar. Bu, isteğinizin global havuzdaki herhangi bir model tarafından işleneceği anlamına gelir.

İstekleriniz için global konumunu kullanmak, modelin kapasite sınırlarına ulaşmanızı önlemeye ve "hizmet aşırı yüklendi" (503) hatalarını azaltmaya yardımcı olabilir. Ayrıca modele bağlı olarak global konumunu kullanmak gerekli olabilir. Çünkü bu konum, model için kullanılabilen tek konumdur (ör. önizleme Gemini modeli).

Konumun açıkça ayarlanması ne zaman gerekir?

Firebase AI Logic, konum için otomatik varsayılanlara sahiptir (örneğin, "Agent Platform" başlatma söz dizimi kullanılırken global). Ancak farklı bir konum kullanmanız gerekiyorsa veya kullanmak istiyorsanız kodunuzda Agent Platform Gemini API (formerly Vertex AI) arka uç hizmetini başlatırken konumu açıkça belirtmeniz gerekir.

Modele bağlı olarak, açıkça bir konum ayarlamak gerekebilir. İsteğiniz, bir modele kullanılamadığı bir konumda erişmeye çalışırsa modelin was not found or your project does not have access to it olduğunu belirten bir 404 hatası alırsınız.

• Gemini önizleme ve deneysel modeller: Yalnızca global konumunda kullanılabilir.

• Gemini kararlı modeller: global konumunda, genellikle us ve eu çoklu bölgelerinde ve birçok belirli bölgede kullanılabilir.

  Gemini Live API 2.5 modellerinin global'da kullanılamadığını unutmayın.

Kullanılabilir tüm konumların listesini bu sayfanın ilerleyen bölümlerinde bulabilirsiniz.

Genel bilgiler ve en iyi uygulamalar

Konumlarla ilgili bazı önemli bilgiler ve en iyi uygulamalar aşağıda verilmiştir:

• Kapasite sınırları modele, bölgeye ve dakikaya göre belirlenir.

• Kapasite sınırlarına beklenmedik bir şekilde ulaşmamak için global konumunu kullanabilirsiniz (model global konumunda kullanılabiliyorsa).

• Modele eriştiğiniz konumu kontrol etmek için Firebase Remote Config kullanabilirsiniz. Bu sayede, uygulamanızın yeni bir sürümünü yayınlamadan konumu değiştirebilirsiniz.

• global konumunu kullanmak kullanım alanınız için uygun değilse modele eriştiğiniz yeri açıkça dağıtmayı düşünün (model, global dışındaki konumlarda kullanılabiliyorsa). Örneğin, Firebase Remote Config kullanarak konumu son kullanıcının konumuna göre ayarlayabilirsiniz.

Kod örnekleri

Firebase AI Logic, konum için otomatik varsayılanlara sahiptir (örneğin, "Agent Platform" başlatma söz dizimi kullanılırken global). Ancak farklı bir konum kullanmanız gerekiyorsa veya kullanmak istiyorsanız kodunuzda Agent Platform Gemini API (formerly Vertex AI) arka uç hizmetini başlatırken konumu açıkça belirtmeniz gerekir.

LOCATION ifadesini, bu sayfanın ilerleyen kısımlarında yer alan kullanılabilir konumlar listesindeki konum koduyla (ör. global veya us-central1) değiştirin.

// ...

// 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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

Modelin kullanılamadığı bir konum belirtirseniz modelin bulunamadığını belirten bir 404 hatası alırsınız. was not found or your project does not have access to it.

Kullanılabildiği yerler

Google Cloud, bölgeleri kullanır. Google Cloud, müşteri verilerini yalnızca Agent Platform'te genel kullanıma sunulan tüm üretken yapay zeka özellikleri için belirttiğiniz bölgede depolar.

Agent Platform platformundaki üretken yapay zeka aşağıdaki bölgelerde kullanılabilir. Bazı modeller ve/veya belirli sürümler her konumda kullanılamayabilir (Konuma göre kullanılabilirlik hakkında ayrıntılı bilgi için Google Cloud belgelerine bakın).

Aşağıdakileri göz önünde bulundurun:

• Firebase AI Logic varsayılan olarak aşağıdaki konumlara ayarlanır:

  • Yeni "Agent Platform" başlatma söz dizimini kullanırken: global
  • Eski "Vertex AI" başlatma söz dizimini kullanırken: us-central1

• Gemini önizleme ve deneysel modeller: Yalnızca global konumunda kullanılabilir.

• Gemini kararlı modeller: global konumunda, genellikle us ve eu çoklu bölgelerinde ve birçok belirli bölgede kullanılabilir.

  Gemini Live API 2.5 modellerinin global'da kullanılamadığını unutmayın.

Her model için kullanılabilir konumlar hakkında ayrıntılı bilgi edinmek istiyorsanız Google Cloud belgelerini inceleyin.