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

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

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

• عند استخدام بنية تهيئة "منصة الوكيل" الجديدة: 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 Gemini API (formerly Vertex AI) في الرمز البرمجي.

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

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

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

// ...

يُرجى العِلم أنّه في حال تحديد موقع جغرافي لا يتوفّر فيه النموذج، سيظهر لك الخطأ 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 تلقائيًا على المواقع الجغرافية التالية:

  • عند استخدام بنية تهيئة "منصة الوكيل" الجديدة: global
  • عند استخدام بنية تهيئة "Vertex AI" القديمة: us-central1

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

• 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

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

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

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

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

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

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

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