تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

خيارات أخرى للعمل مع "Gemini API"

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

بعد أن تعرَّفت على آلية عمل "Gemini API"، نقل البيانات إلى Vertex AI in Firebase حِزم تطوير البرامج (SDK) والتي تحتوي على العديد من الميزات الإضافية المهمة لتطبيقات الأجهزة الجوّالة وتطبيقات الويب، مثل حماية واجهة برمجة التطبيقات من إساءة الاستخدام باستخدام Firebase App Check ودعم لـ ملفات وسائط كبيرة في الطلبات.

يمكنك اختيار الاتصال بخدمة Vertex AI Gemini API من جهة الخادم
يمكنك استخدام حِزم تطوير البرامج (SDK) من جهة الخادم Vertex AI، Firebase Genkit، Firebase Extensions لـ Gemini API.

قبل البدء

أكمل دليل البدء لحِزم تطوير البرامج (SDK) الخاصة بـ "Vertex AI in Firebase" تأكّد من القيام بكل ما يلي:

يمكنك إعداد مشروع جديد أو حالي في Firebase، بما في ذلك استخدام خطة أسعار Blaze وتفعيل واجهات برمجة التطبيقات المطلوبة
يمكنك ربط تطبيقك بمنصة Firebase، بما في ذلك تسجيل تطبيقك وإضافة تهيئة Firebase لتطبيقك.
إضافة حزمة تطوير البرامج (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

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

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

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

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

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

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

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