إنشاء محادثات متعددة المقاطع (الدردشة) باستخدام Gemini API

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

• يمكنك اختياريًا استدعاء Gemini API in Vertex AI من جهة الخادم (مثل استخدام Python أو Node.js أو Go)
  استخدِم حِزم تطوير البرامج (SDK) من جهة الخادم لVertex AI أو Genkit أو Firebase Extensions لGemini API.

قبل البدء

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

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

لإنشاء محادثة متعددة المقاطع (مثل المحادثة)، ابدأ بإعداد المحادثة من خلال استدعاء startChat(). بعد ذلك، استخدِم رمز sendMessage() لإرسال رسالة مستخدم جديدة، ما يؤدي بدوره إلى إرفاق الرسالة والردّ بسجلّ المحادثات.

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

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

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

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

عرض الردّ تدريجيًا

يُرجى التأكد من إكمال قسم قبل البدء في هذا الدليل قبل تجربة هذا العيّنة.

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

عرض مثال: بث الردود في المحادثة

---

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

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

تجربة إمكانات أخرى

• إنشاء نص من الطلبات النصية فقط
• إنشاء نص من طلبات متعددة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديوهات والمحتوى الصوتي)
• إنشاء إخراج منظَّم (مثل تنسيق JSON) من كلّ من الطلبات النصية والطلبات باستخدام وسائط متعدّدة
• إنشاء صور من طلبات نصية
• استخدِم استدعاء الدوال لربط النماذج التوليدية بالأنظمة والمعلومات الخارجية.

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

• التعرّف على تصميم الطلبات، بما في ذلك أفضل الممارسات والاستراتيجيات والأمثلة على الطلبات
• ضبط مَعلمات النموذج، مثل درجة الحرارة والحد الأقصى لرموز الإخراج (لميزة Gemini) أو نسبة العرض إلى الارتفاع وإنشاء الأشخاص (لميزة Imagen)
• استخدام إعدادات الأمان لضبط احتمالية تلقّي ردود قد تُعتبر ضارة

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

مزيد من المعلومات عن الطُرز المتوافقة

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

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