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

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

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

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

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

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

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

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

• لم يتم رفض أي مواقع جغرافية حتى الآن