يوضِّح لك هذا الدليل كيفية البدء في إجراء مكالمات على 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 (اطّلِع على الخطوة السابقة)، يمكنك الآن إضافة حزمة تطوير البرامج (SDK) الخاصة بـ 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 (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
أضِف مستودع حزمة تطوير البرامج (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")
عند الانتهاء من دليل البدء، تعرف على كيفية اختيار نموذج Gemini و (اختياريًا) الموقع الجغرافي المناسب لحالة الاستخدام والتطبيق.
الخطوة 4: طلب واجهة برمجة تطبيقات Vertex AI Gemini
بعد أن ربطت تطبيقك بمنصّة Firebase، وأضفت حزمة تطوير البرامج (SDK)، ثم بدأت عملية الإعداد. خدمة Vertex AI والنموذج التوليدي، يمكنك طلب واجهة برمجة تطبيقات Vertex AI Gemini
يمكنك استخدام 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")
// 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