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


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

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

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

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

  • عندما تنشئ نموذج طلب من الخادم عبر REST API وتضبط موقعه الجغرافي على 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.