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

تتوفّر نماذج الذكاء الاصطناعي التوليدي من 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.

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

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