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


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

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

يفترض هذا الدليل أنّك على دراية باستخدام Xcode لتطوير تطبيقات لأنظمة Apple الأساسية (مثل iOS).

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

    • الإصدار 15.0 من Xcode أو إصدار أحدث
    • يجب أن يستهدف تطبيقك الإصدار 15 من نظام التشغيل iOS أو إصدارًا أحدث، أو الإصدار 12 من نظام التشغيل macOS أو إصدارًا أحدث.
  • (اختياري) اطّلِع على نموذج التطبيق.

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

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

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

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

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

  2. انقر على بطاقة Vertex AI in Firebase لبدء سير عمل يساعدك في completing the following tasks:

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

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


الخطوة 2: إضافة حزمة SDK

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

استخدِم أداة Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.

توفّر مكتبة Vertex AI in Firebase إمكانية الوصول إلى Vertex AI Gemini API، ويتم تضمينها كجزء من حزمة تطوير البرامج (SDK) لمنصّة Firebase على أنظمة Apple الأساسية (firebase-ios-sdk).

  1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى File > Add Packages (ملف > إضافة حِزم).

  2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase عندما يُطلب منك ذلك:

      https://github.com/firebase/firebase-ios-sdk
    
  3. اختَر أحدث إصدار من حزمة SDK.

  4. اختَر مكتبة FirebaseVertexAI.

    عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ ملفاتك المضمّنة وتنزيلها في الخلفية.

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

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

  1. استورِد وحدة FirebaseVertexAI:

    import FirebaseVertexAI
    
  2. يمكنك إعداد خدمة 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 API

بعد ربط تطبيقك بمنصّة 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")

// 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.")

ما هي الإجراءات الأخرى التي يمكنك اتّخاذها؟

مزيد من المعلومات حول نماذج Gemini

اطّلِع على مزيد من المعلومات عن النماذج المتاحة لحالات الاستخدام المختلفة واطلاعك على الحصص والأسعار.

تجربة إمكانات أخرى في Gemini API

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

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


تقديم ملاحظات حول تجربتك في استخدام "Vertex AI in Firebase"