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

+iOS نظام التشغيل Android الويب Flutter

معاينة: علامة التبويب "Vertex AI in Firebase" متوفّرة في "معاينة"، ما يعني أنّ المنتج لا تخضع لأية سياسة للإيقاف أو اتفاقية مستوى الخدمة ويمكن أن تتغير وغير متوافقة مع الإصدارات القديمة

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

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

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

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

• يمكنك اختيار الاتصال بخدمة Vertex AI Gemini API من جهة الخادم
  يمكنك استخدام حِزم تطوير البرامج (SDK) من جهة الخادم Vertex AI، Firebase Genkit، Firebase Extensions لـ Gemini API.

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

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

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

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة الإنشاء باستخدام Gemini وانقر بعد ذلك على البطاقة الثانية لبدء سير عمل يساعدك المهام التالية. إذا ظهرت لك علامة تبويب في وحدة التحكّم لـ Vertex AI، فحينئذٍ اكتملت هذه المهام.

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

   • فعِّل واجهتَي برمجة التطبيقات التاليتَين لمشروعك:
     aiplatform.googleapis.com أو firebaseml.googleapis.com

2. يمكنك المتابعة إلى الخطوة التالية في هذا الدليل لإضافة حزمة تطوير البرامج (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 وانقر بعد ذلك على البطاقة الثانية لبدء سير عمل يساعدك المهام التالية. إذا ظهرت لك علامة تبويب في وحدة التحكّم لـ Vertex AI، فحينئذٍ اكتملت هذه المهام.

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

   • فعِّل واجهتَي برمجة التطبيقات التاليتَين لمشروعك:
     aiplatform.googleapis.com أو firebaseml.googleapis.com

ربط تطبيقك بمنصّة 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 والفيديو والصوت)
• إنشاء محادثات متعددة الأدوار (محادثة)
• استخدام استدعاء الوظائف للاتصال النماذج التوليدية للأنظمة والمعلومات الخارجية

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

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

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

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