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


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

يُرجى العِلم أنّه يمكنك أيضًا استخدام هذا الدليل للبدء في الوصول إلى نماذج Imagen باستخدام Vertex AI in Firebase حِزم SDK.

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

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

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

    • ‫Dart 3.2.0 والإصدارات الأحدث

  • (اختياري) اطّلِع على نموذج التطبيق.

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

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

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

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

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

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

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

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


الخطوة 2: إضافة حزمة تطوير البرامج (SDK)

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

يقدّم المكوّن الإضافي Vertex AI in Firebase لتطبيق Flutter (firebase_vertexai) إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini وImagen.

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

    flutter pub add firebase_core && flutter pub add firebase_vertexai

  2. في ملف lib/main.dart، استورِد المكوّن الإضافي الأساسي لـ Firebase ومكوّن Vertex AI in Firebase الإضافي وملف الإعداد الذي أنشأته في وقت سابق:

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

  3. في ملف lib/main.dart أيضًا، يمكنك إعداد Firebase باستخدام كائن DefaultFirebaseOptions الذي تم تصديره من ملف الإعدادات:

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  4. إعادة إنشاء تطبيق Flutter:

    flutter run

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

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

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

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');

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

الخطوة 4: إرسال طلب طلب إلى نموذج

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

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

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

await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-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 API

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

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


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