باستخدام Gemini API، يمكنك إجراء محادثات حرة بين اتجاهات متعددة. تُبسّط حزمة تطوير البرامج (SDK) "Vertex AI in Firebase" العملية من خلال إدارة
حالة المحادثة، بحيث لا تحتاج إلى تخزين سجلّ المحادثات بنفسك على عكس generateContentStream()
أو generateContent()
.
قبل البدء
أكمِل دليل البدء لحِزم تطوير البرامج (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 لتتمكّن من تضمين الملفات الكبيرة في الطلبات المتعدّدة الوسائط باستخدام عناوين URL للسمة Cloud Storage. ويمكن أن تتضمّن الملفات صورًا وملفات PDF وفيديو وملفات صوتية.
- ننصحك بالتفكير في الاستعداد لمرحلة الإنتاج، بما في ذلك إعداد Firebase App Check لحماية Gemini API من إساءة استخدام الخدمات التي يجريها العملاء غير المصرّح لهم.
تجربة إمكانات أخرى في Gemini API
- إنشاء نص من الطلبات النصية فقط
- يمكنك إنشاء نص باستخدام الطلبات المتعدّدة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديوهات والصوت).
- أنشِئ مخرجات منظَّمة (مثل JSON) من الطلبات النصية والمتعدّدة الوسائط.
- يمكنك استخدام استدعاء الدوال لربط النماذج التوليدية بالأنظمة والمعلومات الخارجية.
التعرّف على كيفية التحكّم في إنشاء المحتوى
- فهم تصميم الطلب، بما في ذلك أفضل الممارسات والاستراتيجيات وأمثلة الطلبات.
- ضبط مَعلمات النموذج، مثل مستوى الإبداع والحد الأقصى لوحدات ترميز الإخراج
- استخدِم إعدادات الأمان لضبط احتمالية تلقّي ردود يمكن اعتبارها ضارة.
مزيد من المعلومات حول طُرز Gemini
اطّلِع على مزيد من المعلومات عن النماذج المتاحة لحالات الاستخدام المختلفة واطلاعك على الحصص والأسعار.تقديم ملاحظات حول تجربتك في استخدام "Vertex AI in Firebase"