بدء استخدام Gemini API باستخدام Vertex AI في حِزم تطوير البرامج (SDK) لمنصة Firebase

+iOS Android الويب Flutter

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

خيارات أخرى للعمل مع 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.

المتطلبات الأساسية

الخطوة 1: إعداد مشروع على Firebase وربط تطبيقك بـ Firebase

إذا كان لديك سابقًا مشروع على Firebase وتطبيق مرتبط به

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة الإنشاء باستخدام Gemini.

2. انقر على بطاقة Vertex AI in Firebase لبدء سير عمل يساعدك في completing the following tasks:

   • يمكنك ترقية مشروعك لاستخدام خطة أسعار Blaze المستندة إلى الدفع حسب الاستخدام.

   • فعِّل واجهات برمجة التطبيقات المطلوبة في مشروعك (واجهة برمجة التطبيقات Vertex AI وواجهة برمجة تطبيقات Vertex AI in Firebase).

3. يمكنك المتابعة إلى الخطوة التالية في هذا الدليل لإضافة حزمة تطوير البرامج (SDK) إلى تطبيقك.

إذا لم يكن لديك مشروع على Firebase وتطبيق مرتبط بمنصّة Firebase

إعداد مشروع Firebase

1. سجِّل الدخول إلى وحدة تحكّم Firebase.

2. انقر على إنشاء مشروع، ثم استخدِم أيًا من الخيارَين التاليَين:

   • الخيار 1: يمكنك إنشاء مشروع جديد بالكامل في Firebase (ومشروع Google Cloud الأساسي تلقائيًا) من خلال إدخال اسم مشروع جديد في الخطوة الأولى من سير عمل "إنشاء مشروع".

   • الخيار 2: "إضافة Firebase" إلى مشروع حالي على Google Cloud من خلال اختيار اسم مشروعك على Google Cloud من القائمة المنسدلة في الخطوة الأولى من سير عمل "إنشاء مشروع"

   يُرجى العلم أنّه لا عليك إعداد Google Analytics لاستخدام حِزم تطوير البرامج (SDK) Vertex AI in Firebase عند طلب ذلك.

3. في وحدة تحكّم Firebase، انتقِل إلى صفحة الإنشاء باستخدام Gemini.

4. انقر على البطاقة Vertex AI in Firebase لبدء سير عمل يساعدك في إكمال المهام التالية:

   • يمكنك ترقية مشروعك لاستخدام خطة أسعار Blaze المستندة إلى الدفع حسب الاستخدام.

   • فعِّل واجهات برمجة التطبيقات المطلوبة في مشروعك (Vertex AI API و Vertex AI in Firebase API).

ربط تطبيقك بمنصّة Firebase

ملاحظة: في وحدة تحكّم Firebase، ننصحك بشدة بإعداد Firebase App Check. إذا كنت لا تزال في مرحلة اختبار Gemini API، لست بحاجة إلى إعداد App Check على الفور، ولكننا ننصحك بإعداده فور بدء تطوير تطبيقك بشكل جدي.

الخطوة 2: إضافة حزمة SDK

بعد إعداد مشروعك على Firebase وربط تطبيقك بمنصّة Firebase (راجِع الخطوة السابقة)، يمكنك الآن إضافة حزمة تطوير البرامج (SDK) لنظام Vertex AI in Firebase إلى تطبيقك.

iOS والإصدارات الأحدث Android الويب Flutter

الخطوة 3: إعداد خدمة Vertex AI والنموذج التوليدي

قبل أن تتمكّن من إجراء أي طلبات إلى واجهة برمجة التطبيقات، عليك إعداد Vertex AI الخدمة والنموذج التوليدي.

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

الخطوة 4: الاتصال بـ Vertex AI Gemini API

بعد ربط تطبيقك بمنصّة Firebase وإضافة حزمة تطوير البرامج (SDK) وبدء استخدام خدمة Vertex AI والنموذج التوليدي، يمكنك الآن استدعاء Vertex AI Gemini API.

يمكنك استخدام generateContent() لإنشاء نص من طلب برمجي نصي فقط:

يمكن أن يعرض Gemini API الإجابات بشكل مباشر لزيادة سرعة التفاعلات، كما يمكنه التعامل مع الطلبات المتعدّدة الوسائط التي تشمل محتوًى مثل الصور والفيديوهات والصوت. يمكنك الاطّلاع على جميع إمكانات Gemini API لاحقًا في هذه الصفحة.

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

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

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

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

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

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

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

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

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