مکان دسترسی به مدل را مشخص کنید

مدل‌های هوش مصنوعی زایای 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 برای درخواست‌هایتان می‌تواند به شما کمک کند به محدودیت‌های ظرفیت مدل نرسید و خطاهای «سرویس بیش‌ازحد بارگذاری شده است» (۵۰۳) را کاهش دهید. همچنین، بسته به مدل، استفاده از مکان global ممکن است الزامی باشد زیرا این مکان تنها مکان دردسترس برای مدل است (برای مثال، مدل Gemini پیش‌نمایش).

چه زمانی باید مکان را به‌طور صریح تنظیم کرد؟

‫Firebase AI Logic برای مکان پیش‌فرض‌های خودکار دارد (برای نمونه، global هنگام استفاده از دستورگان اولیه «پلاتفرم نماینده»). بااین‌حال، اگر نیاز دارید یا می‌خواهید از مکان دیگری استفاده کنید، باید مکان را به‌طور صریح درطول مقداردهی اولیه سرویس پشتیبان Agent Platform Gemini API (formerly Vertex AI) در کدتان مشخص کنید.

بسته به مدل، ممکن است تنظیم صریح مکان الزامی باشد. اگر درخواستتان سعی کند به مدلی در مکانی که دردسترس نیست دسترسی پیدا کند، خطای ۴۰۴ دریافت خواهید کرد که می‌گوید مدل 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"));

// ...

توجه داشته باشید که اگر مکانی را مشخص کنید که مدل در آن دردسترس نیست، خطای ۴۰۴ دریافت خواهید کرد که می‌گوید مدل 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 (مثل مدل‌های ۲.۵)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

توجه داشته باشید که مدل‌های Gemini Live API 2.5 در global دردسترس نیستند.

برای جزئیات مربوط به مکان‌های دردسترس برای هر مدل، به مستندات Google Cloud مراجعه کنید.

فهرست مکان‌هایی که قبلاً دردسترس بودند اما اکنون رد شده‌اند:

• هنوز هیچ مکانی رد نشده است