إجراء محادثات (محادثة) متعدّدة الأدوار باستخدام Gemini API


باستخدام Gemini API، يمكنك إنشاء محادثات حرة في منعطفات متعددة. تعمل حزمة SDK لتطبيق Vertex AI in Firebase على تبسيط العملية من خلال إدارة حالة المحادثة، لذا لا تحتاج إلى تخزين سجلّ المحادثات بنفسك، على عكس حزمة SDK لتطبيق generateContentStream() أو generateContent().

قبل البدء

يُرجى إكمال دليل بدء استخدام حِزم تطوير البرامج (SDK) لنظام التشغيل Vertex AI in Firebase إذا لم يسبق لك ذلك. تأكَّد من تنفيذ كلّ ما يلي:

  1. إعداد مشروع جديد أو حالي على Firebase، بما في ذلك استخدام خطط أسعار Blaze وتفعيل واجهات برمجة التطبيقات المطلوبة

  2. ربط تطبيقك بمنصّة Firebase، بما في ذلك تسجيل تطبيقك وإضافة إعدادات Firebase إلى تطبيقك

  3. إضافة حزمة تطوير البرامج (SDK) وإعداد خدمة Vertex AI والنموذج التوليدي في تطبيقك.

بعد ربط تطبيقك بمنصّة Firebase وإضافة حزمة تطوير البرامج (SDK) وإعداد Vertex AI الخدمة والنموذج التوليدي، أصبحت جاهزًا للاتصال بـ Gemini API.

إرسال طلب لإرسال إشعارات عبر المحادثة

لإنشاء محادثة متعددة المقاطع (مثل المحادثة)، ابدأ بإعداد المحادثة من خلال استدعاء startChat(). ثم استخدم sendMessageStream() (أو sendMessage()) لإرسال رسالة مستخدم جديدة، سيؤدي أيضًا إلى إلحاق الرسالة والرد بسجلّ المحادثات.

هناك خياران محتملان لـ role المرتبط بالمحتوى في محادثة:

  • user: الدور الذي يقدّم الطلبات هذه القيمة هي القيمة التلقائية لطلبات الوصول إلى sendMessageStream() (أو sendMessage())، وتُلقي الدالة استثناءً في حال تم تمرير دور مختلف.

  • model: الدور الذي يقدّم الردود يمكن استخدام هذا الدور عند الاتصال بـ startChat() باستخدام history الحالي.

اختَر ما إذا كنت تريد بث الردّ (sendMessageStream) أو الانتظار لتلقّي الردّ إلى أن يتم إنشاء النتيجة بالكامل (sendMessage).

البثّ

يمكنك تحقيق تفاعلات أسرع من خلال عدم انتظار النتيجة الكاملة من إنشاء النموذج، واستخدام البث بدلاً من ذلك للتعامل مع النتائج الجزئية.

بدون بث

بدلاً من ذلك، يمكنك الانتظار إلى أن تظهر النتيجة بالكامل بدلاً من بثها، ولا يتم عرض النتيجة إلا بعد أن يُكمل النموذج عملية الإنشاء بالكامل.

التعرّف على كيفية اختيار نموذج Gemini ويمكنك اختياريًا تحديد موقع جغرافي المناسبة لحالة الاستخدام والتطبيق

ما هي الإجراءات الأخرى التي يمكنك اتّخاذها؟

  • تعرَّف على كيفية احتساب الرموز المميّزة. قبل إرسال مطالبات طويلة إلى النموذج.
  • إعداد "Cloud Storage for Firebase" بحيث يمكنك تضمين الملفات الكبيرة في الطلبات المتعددة الوسائط باستخدام Cloud Storage عنوان URL. يمكن أن تتضمن الملفات صورًا وملفات PDF وفيديو وصوتًا.
  • ابدأ التفكير في التحضير للإصدار العلني، بما في ذلك إعداد Firebase App Check لحماية Gemini API من إساءة استخدام العملاء غير المصرّح لهم.

تجربة إمكانات أخرى في Gemini API

التعرّف على طريقة التحكّم في إنشاء المحتوى

يمكنك أيضًا تجربة الطلبات وعمليات ضبط النماذج باستخدام Vertex AI Studio

مزيد من المعلومات حول نماذج Gemini

اطّلِع على مزيد من المعلومات عن النماذج المتاحة لحالات الاستخدام المختلفة واطلاعك على الحصص والأسعار.


تقديم ملاحظات حول تجربتك مع "Vertex AI in Firebase"