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

iOS+ Android الويب Flutter

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

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

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

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

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

  • عدم استخدام "استوديو Google AI" وحِزم تطوير البرامج (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 API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مزيد من المعلومات حول طُرز Gemini

تعرَّف على النماذج المتاحة لحالات الاستخدام المختلفة والحصص وأسعارها.

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