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 مباشرةً من تطبيقك على الويب أو الأجهزة الجوّالة لإنشاء تجارب محادثة بالذكاء الاصطناعي، وإنشاء صور، وإنشاء كلام من نص (TTS)، واستخدام الأدوات (مثل استدعاء الدوال وGrounding باستخدام Google Search أو Google Maps)، وبث الإدخال والإخراج المتعدّد الوسائط (بما في ذلك المحتوى الصوتي)، وغير ذلك.
الأمان ومنع إساءة الاستخدام للتطبيقات العلنية استخدِم Firebase App Check للمساعدة في حماية واجهات برمجة التطبيقات التي تصل إلى نماذج Gemini من إساءة الاستخدام من قِبل العملاء غير المصرّح لهم.

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

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

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

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

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

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

إذا اخترت استخدام 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 على الخادم و _عدم_ تضمينه في قاعدة الرموز البرمجية لتطبيقاتك.

مسار التنفيذ

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

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

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

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

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

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

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

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