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

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

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

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

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

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

قبل البدء

أكمِل دليل البدء لحِزم تطوير البرامج (SDK) "Vertex AI in Firebase"، إذا لم يسبق لك إجراء ذلك. تأكَّد من تنفيذ كلّ ما يلي:

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

2. ربط تطبيقك بمنصّة Firebase، بما في ذلك تسجيل تطبيقك وإضافة إعدادات Firebase إلى تطبيقك

3. أضِف حزمة تطوير البرامج (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) من الطلبات النصية والمتعدّدة الوسائط.
• استخدِم استدعاء الدوال لربط النماذج التوليدية بالأنظمة والمعلومات الخارجية.

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

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

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

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

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

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