يشرح لك هذا الدليل كيفية بدء إجراء مكالمات على Vertex AI Gemini API مباشرةً من تطبيقك باستخدام حِزم تطوير البرامج (SDK) الخاصة بالذكاء الاصطناعي من Vertex AI for Firebase.
المتطلّبات الأساسية
يفترض هذا الدليل أنك على دراية باستخدام Xcode لتطوير التطبيقات لأنظمة أساسية من Apple (مثل iOS).
تأكد من أن بيئة التطوير وتطبيق أنظمة Apple الأساسية تستوفي المتطلبات التالية:
- Xcode 15.0 أو إصدار أحدث
- يجب أن يستهدف تطبيقك نظام التشغيل iOS 15 أو الإصدارات الأحدث، أو نظام التشغيل macOS 12 أو الإصدارات الأحدث.
(اختياري) يمكنك الاطّلاع على نموذج التطبيق.
يمكنك تجربة حزمة تطوير البرامج (SDK) بسرعة، أو الاطّلاع على التنفيذ الكامل لحالات استخدام مختلفة، أو استخدام نموذج التطبيق إذا لم يكن لديك تطبيق خاص على نظام Apple الأساسي. لاستخدام نموذج التطبيق، عليك ربطه بمشروع على Firebase.
الخطوة 1: إعداد مشروع على Firebase وربط تطبيقك بمنصّة Firebase
إذا كان لديك مشروع على Firebase وتطبيق مرتبط بمنصّة Firebase
ضمن "وحدة تحكُّم Firebase"، انتقِل إلى صفحة الإنشاء باستخدام Gemini، ثم انقر على البطاقة الثانية لبدء عملية سير عمل تساعدك في إنجاز المهام التالية. إذا رأيت علامة تبويب في وحدة التحكم الخاصة بـ Vertex AI، يعني ذلك أن هذه المهام قد اكتملت.
عليك ترقية مشروعك لاستخدام خطة أسعار Blaze الدفع حسب الاستخدام.
فعِّل واجهتَي برمجة التطبيقات التاليتَين لمشروعك:
aiplatform.googleapis.comوfirebaseml.googleapis.com.
يمكنك المتابعة إلى الخطوة التالية في هذا الدليل لإضافة حزمة تطوير البرامج (SDK) إلى تطبيقك.
إذا لم يكن لديك مشروع على Firebase وتطبيق مرتبط بمنصّة Firebase
الخطوة 2: إضافة حزمة SDK
بعد إعداد مشروعك على Firebase وربط تطبيقك بمنصّة Firebase (راجِع الخطوة السابقة)، يمكنك الآن إضافة حزمة تطوير البرامج Vertex AI for Firebase إلى تطبيقك.
تتيح مكتبة Vertex AI for Firebase الوصول إلى واجهة
Vertex AI Gemini API، وهي مضمّنة كجزء من حزمة تطوير البرامج (SDK) لمنصّة Firebase
على منصات Apple (firebase-ios-sdk). أما بالنسبة إلى مكتبة Vertex AI for Firebase،
فيجب استخدام Swift Package Manager لتثبيت الموارد التابعة لـ Firebase وإدارتها. في الوقت الحالي، لا يمكن استخدام مدراء الحزم الآخرين، مثل CocoaPods.
في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى File > Add Packages (ملف > إضافة حِزم).
أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:
https://github.com/firebase/firebase-ios-sdkاختَر أحدث إصدار من حزمة SDK.
اختَر مكتبة "
FirebaseVertexAI-Preview".عند الانتهاء، سيبدأ Xcode تلقائيًا في تحديد العناصر التابعة لك وتنزيلها في الخلفية.
الخطوة 3: إعداد خدمة Vertex AI والنموذج التوليدي
قبل إجراء أي طلبات بيانات من واجهة برمجة التطبيقات، يجب إعداد خدمة Vertex AI والنموذج التوليدي.
استيراد الوحدة النمطية
FirebaseVertexAI:import FirebaseVertexAIإعداد خدمة Vertex AI والنموذج التوليدي:
import FirebaseVertexAI // Initialize the Vertex AI service let vertex = VertexAI.vertexAI() // Initialize the generative model with a model that supports your use case // Gemini 1.5 models are versatile and can be used with all API capabilities let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")
عند إكمال دليل البدء، تعرَّف على كيفية اختيار نموذج Gemini وموقع جغرافي مناسب لحالة الاستخدام والتطبيق (اختياري).
الخطوة 4: طلب واجهة برمجة تطبيقات Vertex AI Gemini
بعد أن ربطت تطبيقك بمنصة Firebase وإضافة حزمة تطوير البرامج (SDK) وإعداد خدمة Vertex AI والنموذج التوليدي، أصبحت جاهزًا لطلب البيانات من Vertex AI Gemini API.
يمكنك استخدام generateContent() لإنشاء نص من طلب نصي فقط:
import FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")
// 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)
if let text = response.text {
print(text)
}
ما هي الإجراءات الإضافية التي يمكنك تنفيذها؟
مزيد من المعلومات حول نماذج Gemini
تعرَّف على مزيد من المعلومات حول النماذج المتاحة لحالات الاستخدام المختلفة وأسعارها وأسعارها.
تجربة إمكانات أخرى لواجهة Gemini API
- تعرّف على مزيد من المعلومات حول إنشاء نص من الطلبات النصية فقط، بما في ذلك طريقة عرض الردّ.
- يمكنك إنشاء نص باستخدام الطلبات المتعدّدة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديوهات والصوت).
- إنشاء محادثات متعددة الأدوار (محادثة)
- يمكنك استخدام استدعاء الدوال لربط النماذج التوليدية بالأنظمة والمعلومات الخارجية.
التعرّف على طريقة التحكّم في إنشاء المحتوى
- فهم تصميم الطلب، بما في ذلك أفضل الممارسات والاستراتيجيات وأمثلة الطلبات.
- ضبط معلَمات النموذج، مثل درجة الحرارة والرموز المميّزة للمخرجات القصوى
- استخدِم إعدادات الأمان لضبط احتمالية تلقّي ردود يمكن اعتبارها ضارة.
تقديم ملاحظات حول تجربتك مع Vertex AI for Firebase