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

+iOS نظام التشغيل Android الويب Flutter

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

خيارات أخرى للعمل باستخدام Gemini API

• يمكنك اختياريًا طلب البيانات من جهة الخادم Vertex AI Gemini API. باستخدام حِزم تطوير برامج Vertex AI من جهة الخادم أو إضافات Firebase لواجهة Gemini API:

• يمكنك اختياريًا تجربة بديل "تكنولوجيات الذكاء الاصطناعي من Google" من Gemini API التي تتيح الوصول بدون أي تكلفة (ضمن الحدود وحيثما كان ذلك متاحًا) باستخدام Google AI Studio أو حِزم تطوير البرامج (SDK) الخاصة بتكنولوجيات الذكاء الاصطناعي من Google

  إذا اخترت استخدام أدوات وخدمات الذكاء الاصطناعي (AI) من Google بالإضافة إلى Firebase، ننصحك بما يلي:

  • يجب عدم استخدام Google AI Studio وحِزم تطوير البرامج (SDK) الخاصة بتكنولوجيات الذكاء الاصطناعي من Google مع مشروع Firebase الذي تستخدمه تطبيق الإنتاج
  • بعد أن تطّلع على طريقة عمل Gemini API نقل البيانات إلى حِزم تطوير البرامج (SDK) الخاصة بالذكاء الاصطناعي من Vertex AI for Firebase والتي تحتوي على العديد من الميزات الإضافية المهمة لتطبيقات الأجهزة الجوّالة وتطبيقات الويب، مثل حماية واجهة برمجة التطبيقات من إساءة الاستخدام باستخدام فحص التطبيقات من Firebase

قبل البدء

إذا لم تكن قد قمت بذلك بالفعل، فاعمل على دليل البدء لحِزم تطوير البرامج (SDK) الخاصة بحزمة Vertex AI for Firebase تأكّد من القيام بكل ما يلي:

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

• يمكنك ربط تطبيقك بمنصة Firebase، بما في ذلك تسجيل تطبيقك وإضافة تهيئة Firebase لتطبيقك.

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

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

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

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

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

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

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

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

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

ما هي الإجراءات الإضافية التي يمكنك تنفيذها؟

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

تجربة إمكانات أخرى لواجهة Gemini API

• إنشاء نص من الطلبات النصية فقط:
• إنشاء نص من الطلبات المتعدّدة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديو والصوت)
• استخدام استدعاء الوظائف للاتصال النماذج التوليدية للأنظمة والمعلومات الخارجية

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

• فهم تصميم الطلب، بما في ذلك وأفضل الممارسات والاستراتيجيات وأمثلة الطلبات.
• ضبط مَعلمات النموذج مثل رموز درجة الحرارة والحد الأقصى للمخرجات.
• استخدِم إعدادات الأمان لضبط احتمالية الحصول على استجابات قد تُعتبر ضارة.

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

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

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

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