Gemini API باستخدام Firebase AI Logic

يمكنك إنشاء تطبيقات وميزات للويب والأجهزة الجوّالة تستند إلى الذكاء الاصطناعي باستخدام نماذج Gemini من خلال Firebase AI Logic.

تتيح لك خدمة Firebase AI Logic الوصول إلى أحدث نماذج الذكاء الاصطناعي التوليدي من Google، وهي نماذج Gemini

إذا كنت بحاجة إلى استدعاء Gemini API مباشرةً من تطبيقك على الويب أو الأجهزة الجوّالة، بدلاً من استدعائها من جهة الخادم، يمكنك استخدام Firebase AI Logic للعميل. تم تصميم حِزم SDK للعميل هذه خصيصًا للاستخدام مع تطبيقات الويب والأجهزة الجوّالة، وهي توفّر خيارات أمان لحماية التطبيقات من العملاء غير المصرّح لهم، بالإضافة إلى عمليات التكامل مع خدمات Firebase الأخرى.

تتوفّر حِزم SDK للعميل هذه بلغة Swift لمنصات Apple، وKotlin وJava لنظام Android، وJavaScript للويب، وDart لـ Flutter، وUnity.

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

البدء

الإمكانات الرئيسية

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

يمكن توجيه نماذج Gemini باستخدام إدخال اللغة الطبيعية.

مجموعة متزايدة من الإمكانات باستخدام حِزم SDK، يمكنك استدعاء Gemini API مباشرةً من تطبيق الويب أو الأجهزة الجوّالة لـ إنشاء تجارب محادثة مستندة إلى الذكاء الاصطناعي، وإنشاء صور، واستخدام أدوات (مثل استدعاء الدوال وGrounding باستخدام Google Search أو Google Maps)، وبث الإدخال والإخراج المتعدّد الوسائط (بما في ذلك المحتوى الصوتي)، وغير ذلك.
الأمان ومنع إساءة الاستخدام لتطبيقات الإصدار العلني استخدِم Firebase App Check للمساعدة في حماية واجهات برمجة التطبيقات التي تصل إلى نماذج Gemini من إساءة الاستخدام من قِبل العملاء غير المصرّح لهم.

تفرض خدمة Firebase AI Logic أيضًا حدودًا على عدد الطلبات لكل مستخدم تلقائيًا، ويمكنك ضبط هذه الحدود بالكامل.

بنية تحتية قوية استفِد من البنية التحتية القابلة للتوسّع والمصمّمة للاستخدام مع تطبيقات الويب والأجهزة الجوّالة، مثل إدارة الملفات باستخدام Cloud Storage for Firebase، وإدارة البيانات المنظَّمة باستخدام عروض قاعدة بيانات Firebase (مثل Cloud Firestore)، وضبط إعدادات وقت التشغيل ديناميكيًا باستخدام Firebase Remote Config.

كيف تعمل هذه الميزة؟

Firebase AI Logic توفّر حِزم SDK للعميل وخدمة وكيل وميزات أخرى تتيح لك الوصول إلى نماذج الذكاء الاصطناعي التوليدي من Google لإنشاء ميزات الذكاء الاصطناعي في تطبيقاتك على الويب والأجهزة الجوّالة.

دعم نماذج Google وموفّري "Gemini API"

نحن ندعم جميع أحدث نماذج Gemini، ويمكنك اختيار موفّر "Gemini API" المفضّل للوصول إلى هذه النماذج. نحن ندعم كلاً من Gemini Developer API و Vertex AI Gemini API. تعرَّف على الـ اختلافات بين استخدام موفّري واجهة برمجة التطبيقات.

إذا اخترت استخدام Gemini Developer API، يمكنك الاستفادة من "المستوى المجاني" لبدء الاستخدام بسرعة.

حِزم SDK للعميل على الويب والأجهزة الجوّالة

يمكنك إرسال الطلبات إلى النماذج مباشرةً من تطبيقك على الويب أو الأجهزة الجوّالة باستخدام حِزم SDK للعميل Firebase AI Logic، المتوفّرة بلغة Swift لمنصات Apple، وKotlin وJava لنظام Android، وJavaScript للويب، و Dart لـ Flutter، وUnity.

إذا تم إعداد كلا موفّري Gemini API في مشروعك على Firebase ، يمكنك التبديل بين موفّري واجهة برمجة التطبيقات من خلال تفعيل واجهة برمجة التطبيقات الأخرى وتغيير بضعة أسطر من رمز الإعداد.

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

خدمة الوكيل

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

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

مسار التنفيذ

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

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

الاستعداد للإصدار العلني نفِّذ عمليات التكامل المهمة لتطبيقات الويب والأجهزة الجوّالة، مثل حماية واجهة برمجة التطبيقات من إساءة الاستخدام باستخدام Firebase App Check واستخدام Firebase Remote Config لتعديل المَعلمات في الرمز عن بُعد (الأهم من ذلك اسم النموذج).

الخطوات التالية

بدء الوصول إلى نموذج من تطبيقك على الويب أو الأجهزة الجوّالة

الانتقال إلى دليل البدء

مزيد من المعلومات عن النماذج المتوافقة

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