تحديد الموقع الجغرافي للوصول إلى النموذج

تتوفّر نماذج الذكاء الاصطناعي التوليدي من Google في مناطق معيّنة. يمكنك اختيار المكان الذي تريد الوصول منه إلى النموذج لتلبية متطلبات الامتثال والمدة الزمنية للاستجابة والتوفّر والمتانة.

عند استخدام Firebase AI Logic، يمكن أن يتضمّن كل طلب من طلباتك التي تستخدم Agent Platform Gemini API (formerly Vertex AI) اختياريًا الموقع الجغرافي للوصول إلى النموذج. Firebase AI Logic تتضمّن إعدادات الموقع الجغرافي التلقائية.

• عند استخدام بنية الإعداد الجديدة "Agent Platform": global
• عند استخدام بنية الإعداد القديمة "Vertex AI": us-central1

لمحة عن الموقع الجغرافي global

بالنسبة إلى جميع نماذج Gemini تقريبًا، يقدّم Agent Platform Gemini API (formerly Vertex AI) موقعًا جغرافيًا global، ما يعني أنّ نموذجًا متاحًا في أي مكان في المجمّع العالمي سيتولّى معالجة طلبك.

يمكن أن يساعدك استخدام الموقع الجغرافي global لطلباتك في تجنُّب بلوغ حدود سعة النموذج وتقليل أخطاء "الخدمة مثقلة" (503). أيضًا، استنادًا إلى النموذج، قد يكون استخدام الموقع الجغرافي global مطلوبًا لأنّه الموقع الجغرافي الوحيد المتاح للنموذج (على سبيل المثال، نموذج معاينة Gemini).

متى يكون من الضروري ضبط الموقع الجغرافي بشكل صريح؟

Firebase AI Logic تتضمّن إعدادات تلقائية للموقع الجغرافي (على سبيل المثال، global عند استخدام بنية الإعداد "Agent Platform"). ومع ذلك، إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك، عليك تحديد الموقع الجغرافي بشكل صريح أثناء إعداد خدمة Agent Platform Gemini API (formerly Vertex AI)الخلفية في الرمز البرمجي.

استنادًا إلى النموذج، قد يكون ضبط الموقع الجغرافي بشكل صريح مطلوبًا. إذا كان طلبك يحاول الوصول إلى نموذج في موقع جغرافي غير متاح فيه، سيظهر لك خطأ 404 يشير إلى أنّه was not found or your project does not have access to it.

• Gemini نماذج المعاينة و التجريبية: لا تتوفّر إلا في الموقع الجغرافي global.

• نماذج Gemini 4.x وGemini 3.x الثابتة: تتوفّر في الموقع الجغرافي global وغالبًا في الموقعَين الجغرافيَين us وeu.

• Gemini 2.5 نماذج: تتوفّر في العديد من المواقع الجغرافية. يُرجى العِلم أنّ نماذج Gemini Live API 2.5 غير متاحة في global.

يمكنك الاطّلاع على قائمة بجميع المواقع الجغرافية المتاحة لاحقًا في هذه الصفحة.

حقائق عامة وأفضل الممارسات

في ما يلي بعض الحقائق الرئيسية وأفضل الممارسات حول المواقع الجغرافية:

• تكون حدود السعة لكل نموذج ولكل منطقة ولكل دقيقة.

• لتجنُّب بلوغ حدود السعة بشكل غير متوقّع، ننصحك باستخدام الموقع الجغرافي global (إذا كان النموذج متاحًا في الموقع الجغرافي global).

• ننصحك باستخدام Firebase Remote Config للتحكّم في الموقع الجغرافي الذي تصل منه إلى النموذج. بهذه الطريقة، يمكنك تغيير الموقع الجغرافي بدون إصدار إصدار جديد من تطبيقك.

• إذا لم يكن استخدام الموقع الجغرافي global مناسبًا لحالة الاستخدام، ننصحك بتوزيع المواقع الجغرافية التي تصل منها إلى النموذج بشكل صريح (إذا كان النموذج متاحًا في مواقع جغرافية أخرى غير global). على سبيل المثال، يمكنك ضبط الموقع الجغرافي استنادًا إلى موقع المستخدِم النهائي باستخدام Firebase Remote Config.

عيّنات تعليمات برمجية

Firebase AI Logic تتضمّن إعدادات تلقائية للموقع الجغرافي (على سبيل المثال، global عند استخدام بنية الإعداد "Agent Platform"). ومع ذلك، إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك، عليك تحديد الموقع الجغرافي بشكل صريح أثناء إعداد خدمة Agent Platform Gemini API (formerly Vertex AI)الخلفية في الرمز البرمجي.

استبدِل LOCATION برمز الموقع الجغرافي (على سبيل المثال، global أو us-central1) من قائمة المواقع الجغرافية المتاحة لاحقًا في هذه الصفحة.

// ...

// 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"));

// ...

يُرجى العِلم أنّه إذا حدّدت موقعًا جغرافيًا لا يتوفّر فيه النموذج، سيظهر لك خطأ 404 يشير إلى أنّه was not found or your project does not have access to it.

المواقع الجغرافية المتاحة

Google Cloud تستخدم المناطق. لا تخزّن Google Cloud بيانات العملاء إلا في المنطقة التي تحدّدها لجميع الميزات المتاحة للجميع في الذكاء الاصطناعي التوليدي على Agent Platform.

يتوفّر الذكاء الاصطناعي التوليدي على Agent Platform في المناطق التالية. قد لا تتوفّر بعض النماذج و/أو الإصدارات المحدّدة في جميع المواقع الجغرافية (للاطّلاع على مدى توفّر الموقع الجغرافي بالتفصيل، يُرجى الرجوع إلى Google Cloud المستندات).

لاحظ ما يلي:

• Firebase AI Logic المواقع الجغرافية التالية تلقائيًا:

  • عند استخدام بنية الإعداد الجديدة "Agent Platform": global
  • عند استخدام بنية الإعداد القديمة "Vertex AI": us-central1

• Gemini نماذج المعاينة و التجريبية: لا تتوفّر إلا في الموقع الجغرافي global.

• نماذج Gemini 4.x وGemini 3.x الثابتة: تتوفّر في الموقع الجغرافي global وغالبًا في الموقعَين الجغرافيَين us وeu.

• Gemini 2.5 نماذج: تتوفّر في العديد من المواقع الجغرافية. يُرجى العِلم أنّ نماذج Gemini Live API 2.5 غير متاحة في global.

Gemini 3.x والإصدارات الأحدث

عند استخدام نماذج Gemini 3.x والإصدارات الأحدث، يتيح Firebase AI Logic المواقع الجغرافية التالية:

• global
• us
• eu
• europe-west2 (لندن، المملكة المتحدة)
• asia-southeast1 (سنغافورة)

للاطّلاع على تفاصيل المواقع الجغرافية المتاحة لـ كل نموذج، يُرجى الرجوع إلى Google Cloud مستندات.

نماذج الجيل الأقدم

عند استخدام النماذج الأقدم Gemini (مثل نماذج 2.5)، Firebase AI Logic يتيح المواقع الجغرافية التالية:

يُرجى العِلم أنّ نماذج Gemini Live API 2.5 غير متاحة في global.

للاطّلاع على تفاصيل المواقع الجغرافية المتاحة لـ كل نموذج، يُرجى الرجوع إلى Google Cloud مستندات.

قائمة بالمواقع الجغرافية التي كانت متاحة سابقًا ولكن تم إيقافها الآن:

• لم يتم إيقاف أي مواقع جغرافية بعد