مهام سير العمل المتقدّمة للنماذج


بالنسبة إلى Firebase AI Logic، توفّر لك Firebase console واجهة مستخدم إرشادية لتحديد محتويات النموذج. ومع ذلك، هناك العديد من حالات الاستخدام التي قد تحتاج فيها إلى طرق أكثر تقدّمًا لإعداد نموذج، بما في ذلك:

تستخدم مسارات العمل المتقدّمة الموضّحة في هذه الصفحة Firebase AI Logic REST API.

معلومات مهمة حول استخدام REST API

  • إذا كان النموذج غير مقفول، يمكنك استبداله باستخدام رقم تعريف النموذج نفسه في طلب REST API. لا يمكن استبدال نموذج مقفول.

  • عند إنشاء نموذج طلب خادم من خلال REST API وضبط موقعه الجغرافي على global، يتم تلقائيًا توفير نموذج طلب الخادم في جميع المواقع الجغرافية (بما في ذلك global)، ويمكن استخدامه مع كلٍّ من موفّرَي Gemini API. ومع ذلك، إذا ضبطت أي موقع جغرافي آخر عند إنشاء النموذج من خلال REST API، لن يكون النموذج متاحًا إلا لـ لـ Vertex AI Gemini API. يمكنك الاطّلاع على مزيد من المعلومات حول ضبط موقع جغرافي معيّن لنموذج لاحقًا في هذه الصفحة.

    يُرجى العِلم أنّه عند استخدام واجهة المستخدم الإرشادية في Firebase console، يتم أيضًا توفير النموذج تلقائيًا في جميع المواقع الجغرافية (بما في ذلك global)، ويمكن استخدامه مع كلٍّ من Gemini API providers.

  • للوصول إلى نموذج طلب خادم في طلب templateGenerateContent أو templateStreamGenerateContent من خلال REST API، عليك استخدام نقطة النهاية الخاصة بموفّر Gemini API (Gemini Developer API | Vertex AI Gemini API).

(Vertex AI Gemini API فقط) ضبط موقع جغرافي معيّن لنموذج

ينطبق هذا القسم على الحالات التالية:

كما هو موضّح سابقًا في هذه الصفحة، يتم تلقائيًا توفير نموذج طلب خادم في جميع المناطق المتاحة لـ Firebase AI Logic (بما في ذلك global) إذا نفّذت أيًا مما يلي:

  • إنشاء النموذج باستخدام واجهة المستخدم الإرشادية في Firebase console.
  • إنشاء النموذج من خلال REST API وضبط موقعه الجغرافي على global

هذا يعني أنّه يمكنك ضبط الموقع الجغرافي في طلب تطبيقك على أي من الـ مناطق المتاحة لـ Firebase AI Logic، وسيكون النموذج متاحًا. ولست بحاجة إلى ضبط الموقع الجغرافي في طلب تطبيقك على global.

ومع ذلك، إذا أردت أن يكون نموذجك متاحًا في موقع جغرافي معيّن فقط، عليك إنشاء الـ نموذج من خلال REST API وضبط هذا الموقع الجغرافي تحديدًا بشكلٍ صريح. لا تضبط الموقع الجغرافي على global

  1. أنشئ النموذج من خلال استدعاء نقطة النهاية projects.locations.templates.create. حدِّد location النموذج (على سبيل المثال، europe-west4) كجزء من إنشاء PromptTemplate.

  2. في طلب تطبيقك، تأكَّد من أنّ الـ موقع الجغرافي الذي تصل فيه إلى النموذج يطابق الموقع الجغرافي للنموذج (europe-west4).

يُرجى العِلم بما يلي:

  • لا تعرض قائمة النماذج في Firebase console سوى النماذج التي تم توفيرها (كحد أدنى) في الموقع الجغرافي global

  • إذا كنت تستخدم REST API لتوفير نموذج في موقع جغرافي معيّن (ليس global)، يجب أن يطابق الموقع الجغرافي الذي تصل فيه إلى النموذج في طلب تطبيقك الموقع الجغرافي الذي تم ضبطه للنموذج. إذا لم تتطابق المواقع الجغرافية، سيفشل الطلب (بسبب سياسات العزل الإقليمي).

توفير النموذج كملف

يمكنك توفير محتويات ملف نموذج طلب خادم من خلال استدعاء نقطة النهاية projects.locations.templates.create.