يوضّح لك هذا الدليل كيفية بدء إجراء مكالمات إلى Gemini API in Vertex AI مباشرةً من تطبيقك باستخدام حزمة تطوير البرامج (SDK) Vertex AI in Firebase لنظام التشغيل الذي اخترته.
يُرجى العِلم أنّه يمكنك أيضًا استخدام هذا الدليل للبدء في الوصول إلى نماذج Imagen باستخدام Vertex AI in Firebase حِزم SDK.
المتطلبات الأساسية
Swift
يفترض هذا الدليل أنّك على دراية باستخدام Xcode لتطوير تطبيقات لأنظمة Apple الأساسية (مثل iOS).
تأكَّد من أنّ بيئة التطوير وتطبيق منصات Apple يستوفيان المتطلبات التالية:
- الإصدار 16.2 من Xcode أو إصدار أحدث
- يستهدف تطبيقك الإصدار 15 من نظام التشغيل iOS أو إصدار أحدث، أو الإصدار 12 من نظام التشغيل macOS أو إصدار أحدث
(اختياري) اطّلِع على نموذج التطبيق.
يمكنك تجربة حزمة تطوير البرامج (SDK) بسرعة، أو الاطّلاع على تنفيذ كامل لحالات الاستخدام المختلفة، أو استخدام النموذج التطبيقي إذا لم يكن لديك تطبيق على منصات Apple. لاستخدام النموذج التطبيقي، عليك ربطه بمشروع على Firebase.
Kotlin
يفترض هذا الدليل أنّك على دراية باستخدام "استوديو Android" لتطوير تطبيقات Android.
تأكَّد من أنّ بيئة التطوير وتطبيق Android يستوفيان المتطلّبات التالية:
- "استوديو Android" (أحدث إصدار)
- يستهدف تطبيقك المستوى 21 من واجهة برمجة التطبيقات أو المستويات الأعلى.
(اختياري) اطّلِع على نموذج التطبيق.
يمكنك تجربة حزمة تطوير البرامج (SDK) بسرعة، أو الاطّلاع على تنفيذ كامل لحالات الاستخدام المختلفة، أو استخدام النموذج التطبيقي إذا لم يكن لديك تطبيق Android. ولاستخدام النموذج التطبيقي، عليك ربطه بمشروع على Firebase.
Java
يفترض هذا الدليل أنّك على دراية باستخدام "استوديو Android" لتطوير تطبيقات Android.
تأكَّد من أنّ بيئة التطوير وتطبيق Android يستوفيان المتطلّبات التالية:
- "استوديو Android" (أحدث إصدار)
- يستهدف تطبيقك المستوى 21 من واجهة برمجة التطبيقات أو المستويات الأعلى.
(اختياري) اطّلِع على نموذج التطبيق.
يمكنك تجربة حزمة تطوير البرامج (SDK) بسرعة، أو الاطّلاع على تنفيذ كامل لحالات الاستخدام المختلفة، أو استخدام النموذج التطبيقي إذا لم يكن لديك تطبيق Android. ولاستخدام النموذج التطبيقي، عليك ربطه بمشروع على Firebase.
Web
يفترض هذا الدليل أنّك على دراية باستخدام JavaScript لتطوير تطبيقات الويب. هذا الدليل مستقل عن إطار العمل.
تأكَّد من أنّ بيئة التطوير وتطبيق الويب يستوفيان المتطلبات التالية:
- (اختياري) Node.js
- متصفّح ويب حديث
(اختياري) اطّلِع على نموذج التطبيق.
يمكنك تجربة حزمة تطوير البرامج (SDK) بسرعة، أو الاطّلاع على تنفيذ كامل لحالات الاستخدام المختلفة، أو استخدام النموذج التطبيقي إذا لم يكن لديك تطبيق ويب خاص بك. ولاستخدام النموذج التطبيقي، عليك ربطه بمشروع على Firebase.
Dart
يفترض هذا الدليل أنّك على دراية بتطوير التطبيقات باستخدام Flutter.
تأكَّد من أنّ بيئة التطوير وتطبيق Flutter يستوفيان المتطلبات التالية:
- Dart 3.2.0 والإصدارات الأحدث
(اختياري) اطّلِع على نموذج التطبيق.
يمكنك تجربة حزمة تطوير البرامج (SDK) بسرعة، أو الاطّلاع على تنفيذ كامل لحالات الاستخدام المختلفة، أو استخدام النموذج التطبيقي إذا لم يكن لديك تطبيق Flutter. ولاستخدام النموذج التطبيقي، عليك ربطه بمشروع على Firebase.
الخطوة 1: إعداد مشروع على Firebase وربط تطبيقك بمنصّة Firebase
إذا كان لديك سابقًا مشروع على Firebase وتطبيق مرتبط به
في وحدة تحكّم Firebase، انتقِل إلى صفحة Vertex AI.
انقر على بطاقة Vertex AI in Firebase لبدء سير عمل يساعدك في completing the following tasks:
يمكنك ترقية مشروعك لاستخدام خطة أسعار Blaze المستندة إلى الدفع حسب الاستخدام.
فعِّل واجهات برمجة التطبيقات المطلوبة في مشروعك (Vertex AI API و Vertex AI in Firebase API).
انتقِل إلى الخطوة التالية في هذا الدليل لإضافة حزمة SDK إلى تطبيقك.
إذا لم يكن لديك مشروع على Firebase وتطبيق مرتبط به
الخطوة 2: إضافة حزمة تطوير البرامج (SDK)
بعد إعداد مشروعك على Firebase وربط تطبيقك بمنصّة Firebase (راجِع الخطوة السابقة)، يمكنك الآن إضافة حزمة تطوير البرامج (SDK) لنظام Vertex AI in Firebase إلى تطبيقك.
Swift
استخدِم Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.
توفّر مكتبة Vertex AI in Firebase إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل
مع نماذج Gemini وImagen. يتم تضمين المكتبة
كجزء من حزمة تطوير البرامج (SDK) لمنصّات Apple (firebase-ios-sdk
).
في Xcode، مع فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة حِزم.
أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase عندما يُطلب منك ذلك:
https://github.com/firebase/firebase-ios-sdk
اختَر أحدث إصدار من حزمة SDK.
اختَر مكتبة
FirebaseVertexAI
.
عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ ملفاتك المضمّنة وتنزيلها في الخلفية.
Kotlin
توفّر حزمة Vertex AI in Firebase SDK لنظام التشغيل Android (firebase-vertexai
)
إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع
طُرز Gemini وImagen.
في ملف Gradle للوحدة (على مستوى التطبيق)
(مثل <project>/<app-module>/build.gradle.kts
)،
أضِف الاعتمادية لمكتبة Vertex AI in Firebase لنظام التشغيل Android.
ننصحك باستخدام الرمز
Firebase Android BoM
للتحكّم في إصدارات المكتبة.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.13.0")) // Add the dependency for the Vertex AI in Firebase library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-vertexai") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
Java
توفّر حزمة Vertex AI in Firebase SDK لنظام التشغيل Android (firebase-vertexai
)
إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع
طُرز Gemini وImagen.
في ملف Gradle للوحدة (على مستوى التطبيق)
(مثل <project>/<app-module>/build.gradle.kts
)،
أضِف الاعتمادية لمكتبة Vertex AI in Firebase لنظام التشغيل Android.
ننصحك باستخدام الرمز
Firebase Android BoM
للتحكّم في إصدارات المكتبة.
بالنسبة إلى Java، عليك إضافة مكتبتَين إضافيتَين.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.13.0")) // Add the dependency for the Vertex AI in Firebase library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-vertexai") // Required for one-shot operations (to use `ListenableFuture` from Guava Android) implementation("com.google.guava:guava:31.0.1-android") // Required for streaming operations (to use `Publisher` from Reactive Streams) implementation("org.reactivestreams:reactive-streams:1.0.4") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
Web
توفّر مكتبة Vertex AI in Firebase إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini وImagen. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) لبرنامج Firebase JavaScript على الويب.
ثبِّت حزمة تطوير البرامج (SDK) لبرنامج Firebase باستخدام JavaScript على الويب باستخدام npm:
npm install firebase
إعداد Firebase في تطبيقك:
import { initializeApp } from "firebase/app"; // TODO(developer) Replace the following with your app's Firebase configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize FirebaseApp const firebaseApp = initializeApp(firebaseConfig);
Dart
يقدّم المكوّن الإضافي Vertex AI in Firebase لإطار عمل Flutter (firebase_vertexai
)
إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج
Gemini وImagen.
من دليل مشروع Flutter، نفِّذ الأمر التالي لتثبيت المكوّن الإضافي الأساسي والمكوّن الإضافي Vertex AI in Firebase:
flutter pub add firebase_core && flutter pub add firebase_vertexai
في ملف
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';
في ملف
lib/main.dart
أيضًا، يمكنك إعداد Firebase باستخدام كائنDefaultFirebaseOptions
الذي تم تصديره من ملف الإعدادات:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
إعادة إنشاء تطبيق Flutter:
flutter run
الخطوة 3: بدء خدمة Vertex AI وإنشاء مثيل GenerativeModel
قبل أن تتمكّن من إجراء أي طلبات إلى واجهة برمجة التطبيقات وإرسال طلب إلى نموذج Gemini،
عليك بدء خدمة Vertex AI وإنشاء مثيل GenerativeModel
.
Swift
import FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Create a `GenerativeModel` instance with a model that supports your use case
let model = vertex.generativeModel(modelName: "gemini-2.0-flash")
Kotlin
بالنسبة إلى Kotlin، تكون الطرق في حزمة تطوير البرامج (SDK) هذه دوالّ معلّقة ويجب استدعاؤها من نطاق Coroutine.// Initialize the Vertex AI service and create a `GenerativeModel` instance
// Specify a model that supports your use case
val generativeModel = Firebase.vertexAI.generativeModel("gemini-2.0-flash")
Java
بالنسبة إلى Java، تُعرِض طُرق البث في حزمة SDK هذه نوعًاPublisher
من مكتبة Reactive Streams.
// Initialize the Vertex AI service and create a `GenerativeModel` instance
// Specify a model that supports your use case
GenerativeModel gm = FirebaseVertexAI.getInstance()
.generativeModel("gemini-2.0-flash");
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
Web
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);
// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(vertexAI, { model: "gemini-2.0-flash" });
Dart
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 create a `GenerativeModel` instance
// 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()
لإنشاء نص من طلب نصي فقط:
طلب:
Swift
import FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Create a `GenerativeModel` instance with a model that supports your use case
let model = vertex.generativeModel(modelName: "gemini-2.0-flash")
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")
Kotlin
بالنسبة إلى Kotlin، تكون الطرق في حزمة تطوير البرامج (SDK) هذه دوالّ معلّقة ويجب استدعاؤها من نطاق Coroutine.// Initialize the Vertex AI service and create a `GenerativeModel` instance
// Specify a model that supports your use case
val generativeModel = Firebase.vertexAI.generativeModel("gemini-2.0-flash")
// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
val response = generativeModel.generateContent(prompt)
print(response.text)
Java
بالنسبة إلى Java، تعرض الطرق في حزمة SDK هذه رمز برمجيًا هوListenableFuture
.
// Initialize the Vertex AI service and create a `GenerativeModel` instance
// Specify a model that supports your use case
GenerativeModel gm = FirebaseVertexAI.getInstance()
.generativeModel("gemini-2.0-flash");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
// Provide a prompt that contains text
Content prompt = new Content.Builder()
.addText("Write a story about a magic backpack.")
.build();
// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
@Override
public void onSuccess(GenerateContentResponse result) {
String resultText = result.getText();
System.out.println(resultText);
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
Web
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);
// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(vertexAI, { model: "gemini-2.0-flash" });
// Wrap in an async function so you can use await
async function run() {
// Provide a prompt that contains text
const prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
const result = await model.generateContent(prompt);
const response = result.response;
const text = response.text();
console.log(text);
}
run();
Dart
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 create a `GenerativeModel` instance
// 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);
ما هي الإجراءات الأخرى التي يمكنك اتّخاذها؟
مزيد من المعلومات عن الطُرز المتوافقة
اطّلِع على مزيد من المعلومات عن النماذج المتاحة لحالات الاستخدام المختلفة واطلاعك على الحصص و الأسعار.
تجربة إمكانات أخرى
- اطّلِع على مزيد من المعلومات عن إنشاء نص من الطلبات النصية فقط، بما في ذلك كيفية بثّ الردّ.
- إنشاء نص من طلبات متعددة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديوهات والمحتوى الصوتي)
- إنشاء محادثات متعددة المقاطع (محادثة)
- إنشاء إخراج منظَّم (مثل تنسيق JSON) من كلّ من الطلبات النصية والطلبات المتعدّدة الوسائط
- إنشاء صور من طلبات نصية
- بث الإدخال والإخراج (بما في ذلك الصوت) باستخدام Gemini Live API
- استخدِم استدعاء الدوال لربط النماذج التوليدية بالأنظمة والمعلومات الخارجية.
التعرّف على كيفية التحكّم في إنشاء المحتوى
- التعرّف على تصميم الطلبات، بما في ذلك أفضل الممارسات والاستراتيجيات وأمثلة الطلبات
- ضبط مَعلمات النموذج، مثل درجة الحرارة والحد الأقصى لرموز الإخراج (لميزة Gemini) أو نسبة العرض إلى الارتفاع وإنشاء الأشخاص (لميزة Imagen)
- استخدام إعدادات الأمان لتعديل احتمالية تلقّي ردود قد تُعتبر ضارة
تقديم ملاحظات حول تجربتك مع Vertex AI in Firebase