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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يُرجى الانتباه إلى ما يلي:

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

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

تقديم النموذج كملف

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