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


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

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

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

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

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

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

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

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

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

كما هو موضّح سابقًا في هذه الصفحة، يتم توفير نموذج طلب من الخادم تلقائيًا لجميع المناطق المتاحة في 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. في طلب تطبيقك، تأكَّد من أنّ الموقع الجغرافي الذي تصل منه إلى النموذج يتطابق مع الموقع الجغرافي للنموذج (europe-west4).

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

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

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

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

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