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


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

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

يفترض هذا الدليل أنّك على دراية بتطوير التطبيقات باستخدام Flutter.

  • عليك التأكّد من أنّ بيئة التطوير وتطبيق Flutter متوافقان مع ما يلي: المتطلبات:

    • Dart 3.2.0 أو أحدث
  • (اختياري) يمكنك الاطّلاع على نموذج التطبيق.

    تنزيل نموذج التطبيق

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

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

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

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

  2. انقر على البطاقة Vertex AI in Firebase لبدء سير عمل يساعدك لإكمال المهام التالية. (لاحظ أنه إذا رأيت علامة تبويب في وحدة التحكم Vertex AI، وتكون هذه المهام مكتملة.)

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

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


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

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

يوفّر المكوّن الإضافي Vertex AI in Firebase في Flutter (firebase_vertexai) الوصول إلى Vertex AI Gemini API.

  1. من دليل مشروع Flutter، شغِّل الأمر التالي تثبيت المكون الإضافي الأساسي:

    flutter pub add firebase_core
    
  2. في ملف lib/main.dart، استورد المكوّن الإضافي الأساسي لمنصة Firebase ملف الإعداد الذي أنشأته سابقًا:

    import 'package:firebase_core/firebase_core.dart';
    import 'firebase_options.dart';
    
  3. في ملف lib/main.dart أيضًا، يمكنك إعداد Firebase باستخدام تم تصدير كائن DefaultFirebaseOptions من خلال ملف الإعداد:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. إعادة إنشاء تطبيق Flutter:

    flutter run
    
  5. من دليل مشروع Flutter، شغِّل الأمر التالي:

    flutter pub add firebase_vertexai
  6. بعد اكتمال عملية الإنشاء، أعِد إنشاء مشروع Flutter:

    flutter run
    

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

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

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';

// Initialize FirebaseApp
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');

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

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

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

يمكنك استخدام generateContent() لإنشاء نص بناءً على طلب نصي فقط. الطلب:

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';

await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

ما هي الإجراءات الإضافية التي يمكنك تنفيذها؟

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

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

تجربة الإمكانات الأخرى لـ Gemini API

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

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


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