يمكنك إنشاء تطبيقات وميزات Apple مستندة إلى الذكاء الاصطناعي باستخدام الاستدلال المختلط من خلال Firebase AI Logic. يتيح الاستنتاج المختلط تشغيل الاستنتاج باستخدام النماذج على الجهاز فقط (على وجه التحديد إطار عمل النماذج الأساسية من Apple) عندما تكون متاحة، والعودة بسلاسة إلى نماذج Google المستضافة على السحابة الإلكترونية في الحالات الأخرى (والعكس صحيح).
توضّح هذه الصفحة كيفية بدء استخدام حزمة تطوير البرامج (SDK) للعميل. بعد إكمال عملية الإعداد العادية هذه، يمكنك الاطّلاع على خيارات وإمكانات الضبط الإضافية.
يُرجى العِلم أنّ الاستدلال على الجهاز فقط من خلال "Firebase AI Logic" متاح لتطبيقات Apple التي تستخدم الإصدار 12.13.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لـ "Firebase AI Logic" وتعمل على أجهزة تم تفعيل Apple Intelligence عليها. وتخضع هذه الميزة لمتطلبات الاستخدام المقبول لإطار عمل Foundation Models من Apple.
حالات الاستخدام والإمكانات المتوافقة
بناءً على حالات استخدام تطبيقك، يمكنك الاستفادة من عدة مزايا للتجارب على الجهاز فقط أو التجارب المختلطة:
مزايا استخدام نموذج على الجهاز فقط للاستدلال:
- خصوصية محسّنة
- السياق المحلي
- الاستدلال بدون تكلفة
- وظائف بلا إنترنت
مزايا استخدام النهج المختلط:
- تقديم تجربة تطبيق مماثلة، بغض النظر عن جهاز المستخدم النهائي
- تحسين مدى توفّر الميزات المستندة إلى الذكاء الاصطناعي التوليدي، بغض النظر عن الاتصال بالإنترنت أو حدود الحصة أو إمكانات الجهاز
إمكانات الاستدلال المتوافقة على الجهاز فقط
لا يتيح الاستنتاج على الجهاز سوى إنشاء النص، وتحديدًا الإمكانات التالية:
إنشاء مخرجات منظَّمة، بما في ذلك JSON والتعدادات (ستتوفّر المستندات قريبًا)
يُرجى مراجعة قائمة الميزات غير المتاحة بعد للاستنتاج المختلط أو على الجهاز فقط في أسفل هذه الصفحة.
واجهات برمجة التطبيقات والأجهزة المتوافقة
توضّح الأقسام التالية واجهات برمجة التطبيقات المتوافقة، بالإضافة إلى الأجهزة المتوافقة (ونماذجها على الجهاز فقط).
واجهات برمجة التطبيقات المتوافقة للاستنتاج في السحابة الإلكترونية مقابل الاستنتاج على الجهاز فقط
يستخدم الاستنتاج في السحابة الإلكترونية مقدّم خدمة Gemini API الذي اخترته (إما Gemini Developer API أو Agent Platform Gemini API (formerly Vertex AI)).
تستخدم ميزة الاستدلال على الجهاز إطار عمل Foundation Models من Apple، والذي يتوفّر فقط على الأجهزة التي تم تفعيل Apple Intelligence عليها. يتم تنزيل النموذج على الجهاز فقط تلقائيًا عند تفعيل Apple Intelligence.
أجهزة Apple المتوافقة ونماذجها على الجهاز فقط
بالنسبة إلى الاستدلال على الجهاز فقط (الذي يستخدم إطار عمل Foundation Models من Apple)، يمكنك العثور على قائمة بالأجهزة التي تم تفعيل Apple Intelligence عليها في مستندات Apple.
البدء
توضّح خطوات البدء هذه الإعدادات العامة المطلوبة لأي طلب موجَّه تريد إرساله.
الخطوة 1: إعداد مشروع Firebase وربط تطبيقك بـ Firebase
سجِّل الدخول إلى وحدة تحكّم Firebase، ثم اختَر مشروعك على Firebase.
في وحدة تحكّم Firebase، انتقِل إلى خدمات الذكاء الاصطناعي > AI Logic.
انقر على البدء لإطلاق سير عمل موجَّه يساعدك في إعداد واجهات برمجة التطبيقات المطلوبة والموارد لمشروعك.
اتّبِع التعليمات الظاهرة على الشاشة لتسجيل تطبيقك وإضافة إعدادات Firebase إليه، إذا طُلب منك ذلك.
عندما يُطلب منك اختيار "مقدّم خدمة Gemini API"، ننصحك باختيار Gemini Developer API، الذي يتيح لك البدء بسرعة بدون أي تكلفة.
يمكنك في أي وقت لاحق إعداد Agent Platform Gemini API (formerly Vertex AI) (ومتطلباته للفوترة).
يُرجى المتابعة في سير العمل لإعداد واجهات برمجة التطبيقات المطلوبة والخدمات المرتبطة بها لـ "Firebase AI Logic".
تفرض هذه المرحلة من سير العمل تلقائيًا استخدام Firebase App Check في AI Logic، وهي خدمة مهمة للمساعدة في حماية Gemini API عند الوصول إليها مباشرةً من تطبيقك. كجزء من عملية البدء (راجِع الخطوات الواردة لاحقًا في هذا الدليل)، ستحتاج إلى ضبط App Check مقدّم خدمة تصحيح الأخطاء للتطوير المحلي عند فرض استخدام App Check.
انتقِل إلى الخطوة التالية في هذا الدليل لإضافة حزم تطوير البرامج (SDK) المطلوبة إلى تطبيقك.
الخطوة 2: إضافة حزم تطوير البرامج (SDK) المطلوبة
استخدِم أداة Swift Package Manager (SPM) لتثبيت تبعيات Xcode وإدارتها. لا يتوفّر الدعم المختلط إلا عند استخدام SPM.
تتيح مكتبة Firebase AI Logic الوصول إلى واجهات برمجة التطبيقات للتفاعل مع النماذج التوليدية. يتم تضمين المكتبة كجزء من حزمة Firebase SDK
لمنصات Apple (firebase-ios-sdk).
إذا كنت تستخدم Firebase حاليًا، تأكَّد من أنّ حزمة Firebase هي الإصدار 12.13.0 أو إصدار أحدث.
في Xcode، افتح مشروع تطبيقك، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).
عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple في Firebase:
https://github.com/firebase/firebase-ios-sdkاختَر أحدث إصدار من حزمة تطوير البرامج (SDK).
اختَر مكتبتَي
FirebaseAILogicوFirebaseAppCheck.
بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.
الخطوة 3: ضبط مقدّم خدمة تصحيح الأخطاء في App Check للتطوير المحلي
في إطار سير عمل الإعداد الموجَّه لـ "AI Logic" في وحدة التحكّم، يتم فرض "Firebase App Check" تلقائيًا لحماية Gemini API. للتطوير على الجهاز، عليك ضبط App Check مقدّم خدمة تصحيح الأخطاء لتجاوز عملية التحقّق مع مواصلة فرض App Check.
في ما يلي كيفية استخدام مقدّم خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير على الجهاز):
في مشروع Xcode، استورِد
FirebaseAppCheckوابدأ App Check باستخدام مصنع مقدِّم خدمة تصحيح الأخطاء قبل ضبطFirebase.import SwiftUI import FirebaseCore import FirebaseAppCheck @main struct YourApp: App { init() { let providerFactory = AppCheckDebugProviderFactory() AppCheck.setAppCheckProviderFactory(providerFactory) FirebaseApp.configure() } var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }احصل على الرمز المميّز لتصحيح الأخطاء:
افتح تطبيقك في المحاكي أو على جهاز الاختبار.
افتح وحدة تحكّم Xcode وابحث عن رمز تصحيح الأخطاء App Check. على سبيل المثال:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.انسخ الرمز المميّز (على سبيل المثال،
123a4567-b89c-12d3-e456-789012345678).
سجِّل رمز تصحيح الأخطاء باستخدام App Check:
في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.
ابحث عن تطبيقك، وانقر على القائمة الكاملة ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.
اتّبِع التعليمات الظاهرة على الشاشة لتسجيل الرمز المميّز لتصحيح الأخطاء.
لمعرفة تفاصيل حول مقدّم خدمة تصحيح الأخطاء (بما في ذلك كيفية الحصول على رمز مميّز جديد لتصحيح الأخطاء)، يُرجى الاطّلاع على مستندات App Check الرسمية.
الخطوة 4: إعداد الخدمة وإنشاء مثيل لجلسة النموذج
|
انقر على مزوّد خدمة Gemini API للاطّلاع على المحتوى والرمز البرمجي الخاصَّين بمزوّد الخدمة على هذه الصفحة. |
يجب إعداد ما يلي قبل إرسال طلب إلى النموذج.
ابدأ الخدمة لمقدّم Gemini API الذي اخترته.
أنشئ مثيل
GenerativeModelSessionباستخدامHybridModel.اضبط نموذجَي
primaryوsecondaryاستنادًا إلى إعداداتك المفضّلة. يمكنك ضبط ترتيب الاستنتاج الذي تتم محاولته:محاولة الاستدلال على الجهاز أولاً، مع السماح بالرجوع إلى السحابة الإلكترونية: اضبط
primaryعلى نموذج "النظام" وsecondaryعلى نموذج السحابة الإلكترونية.محاولة الاستدلال في السحابة الإلكترونية أولاً، مع السماح بالرجوع إلى الاستدلال على الجهاز فقط: اضبط
primaryعلى نموذج سحابي وsecondaryعلى نموذج "نظام".
يُرجى العِلم أنّ حزمة SDK تتيح ضبط
modelواحد فقط، ما يعني أنّ حزمة SDK ستحاول فقط إجراء الاستدلال على الجهاز أو في السحابة الإلكترونية. ومع ذلك، للحصول على تجربة مختلطة، عليك إنشاءHybridModelوضبط كل من نموذجَيprimaryوsecondary.يمكنك الاطّلاع على مزيد من المعلومات حول سلوك "أوضاع الاستنتاج" (ترتيب محاولات الاستنتاج) في خيارات الضبط.
يوضّح المثال التالي كيفية محاولة الاستدلال على الجهاز أولاً، ولكن مع السماح بالرجوع إلى النموذج المستضاف على السحابة الإلكترونية:
// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a cloud model that supports your use case.
let cloudModel = ai.geminiModel(name: "GEMINI_MODEL_NAME")
// Initialize an on-device model that supports your use case.
let systemModel = FirebaseAI.SystemLanguageModel.default
// Create a Hybrid Model.
// Provide your preferred model as `primary` and your fallback model as `secondary`.
// In this example, attempt to use on-device model; otherwise, fall back to cloud.
let hybridModel = HybridModel(
primary: systemModel,
secondary: cloudModel
)
// Create a GenerativeModelSession with the HybridModel created earlier.
let session = firebaseAI.generativeModelSession(
model: hybridModel,
)
الخطوة 5: إرسال طلب إلى نموذج
يوضّح لك هذا القسم كيفية إجراء ما يلي:
- إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
- بثّ نص من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
| قبل تجربة هذا النموذج، تأكَّد من إكمال قسم البدء في هذا الدليل. |
لإنشاء نصّ من إنشاء الذكاء الاصطناعي من طلب يحتوي على نص، استخدِم respond(to:) على النحو التالي:
// Imports + initialization of Gemini API backend service + creation of model session
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call `respond(to:)` with the text input
let response = try await session.respond(to: prompt)
print(response.content)
بث نص من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
| قبل تجربة هذا النموذج، تأكَّد من إكمال قسم البدء في هذا الدليل. |
يمكنك تحقيق تفاعلات أسرع من خلال عدم انتظار النتيجة الكاملة من
إنشاء النموذج، واستخدام البث بدلاً من ذلك للتعامل مع النتائج الجزئية. لبث نص من إنشاء الذكاء الاصطناعي من طلب يحتوي على نص، استخدِم
streamResponse(to:) على النحو التالي:
// Imports + initialization of Gemini API backend service + creation of model session
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To stream generated text output, call `streamResponse(to:)` with the text input
let stream = session.streamResponse(to: prompt)
for try await snapshot in stream {
print(snapshot.content)
}
ما هي المهام الأخرى التي يمكنني تنفيذها؟
يمكنك استخدام خيارات وإمكانات ضبط إضافية مختلفة لتجاربك المختلطة:
الميزات غير المتاحة بعد
بما أنّ هذا الإصدار تجريبي، لا تتوفّر بعض إمكانات النماذج المستضافة على السحابة الإلكترونية أو حزمة تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic للاستنتاج المختلط أو على الجهاز فقط.
الميزات غير المتاحة بعد لعمليات التنفيذ المختلطة
لا يمكن استخدام الميزات التالية مع عمليات التنفيذ المختلطة (سواء على الجهاز أو من خلال الاحتياطي السحابي):
Gemini Live API: لا يتوفّر البث المباشر الثنائي الاتجاه في الوقت الفعلي.
نماذج الطلبات على الخادم: لا تتوفّر نماذج الطلبات على الخادم المُدار.
احتساب الرموز المميّزة: يجب عدم الاعتماد على احتساب الرموز المميّزة لأنّ العدد سيختلف بين النماذج المستضافة على السحابة الإلكترونية والنماذج على الجهاز، لذا لا يتوفّر خيار احتياطي بديهي.
الميزات غير المتاحة بعد للاستنتاج على الجهاز فقط
الميزات التالية غير متاحة بعد للاستنتاج على الجهاز فقط، ولكنّها متاحة للنماذج المستضافة على السحابة الإلكترونية.
إنشاء وسائط، مثل الصور أو الملفات الصوتية أو الفيديوهات
إنشاء نصّ من إنشاء الذكاء الاصطناعي من معلومات متعددة الوسائط، مثل الصور والصوت والفيديو والمستندات (ملفات PDF)
إرسال طلبات تتجاوز 4096 رمزًا مميزًا (أو ما يقرب من 3000 كلمة باللغة الإنجليزية)
تزويد النموذج على الجهاز فقط بأدوات مدمجة لمساعدته في إنشاء ردوده (مثل تطبيق الرموز البرمجية، وسياق عناوين URL، وتحديد المصدر باستخدام "
Google Search "، وتحديد المصدر باستخدام "Google Maps "). ومع ذلك، يمكنك توفير أدواتك الخاصة باستخدام ميزة استدعاء الدالة.لا تعرض ميزة تتبّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase أي بيانات للاستنتاج على الجهاز فقط (بما في ذلك سجلّات الجهاز). ومع ذلك، يمكن مراقبة أي استنتاج يستخدم نموذجًا مستضافًا على السحابة الإلكترونية تمامًا مثل الاستنتاجات الأخرى من خلال Firebase AI Logic.
قيود إضافية
بالإضافة إلى ما سبق، يفرض الاستنتاج على الجهاز فقط القيود التالية:
يجب أن يستخدم المستخدم النهائي لتطبيقك جهازًا تم تفعيل Apple Intelligence عليه.
يمكن لتطبيقك تشغيل الاستدلال على الجهاز فقط عندما يكون التطبيق في المقدمة.
تقديم ملاحظات حول تجربتك مع "Firebase AI Logic"