با استفاده از Vertex AI در Firebase SDK با Gemini API شروع کنید


این راهنما به شما نشان می‌دهد که چگونه می‌توانید با استفاده از Vertex AI in Firebase SDK برای پلتفرم انتخابی خود، مستقیماً از برنامه خود با Vertex AI Gemini API تماس بگیرید.

پیش نیازها

این راهنما فرض می‌کند که شما با استفاده از Xcode برای توسعه برنامه‌ها برای پلتفرم‌های اپل (مانند iOS) آشنا هستید.

  • اطمینان حاصل کنید که محیط توسعه و برنامه پلتفرم های اپل شرایط زیر را برآورده می کند:

    • Xcode 15.0 یا بالاتر
    • برنامه شما باید iOS 15 یا بالاتر یا macOS 12 یا بالاتر را هدف قرار دهد.
  • (اختیاری) برنامه نمونه را بررسی کنید.

    نمونه برنامه را دانلود کنید

    می‌توانید SDK را به سرعت امتحان کنید، اجرای کامل موارد استفاده مختلف را مشاهده کنید، یا اگر برنامه پلتفرم‌های اپل خود را ندارید از برنامه نمونه استفاده کنید. برای استفاده از برنامه نمونه، باید آن را به پروژه Firebase متصل کنید .

مرحله 1 : یک پروژه Firebase راه اندازی کنید و برنامه خود را به Firebase متصل کنید

اگر قبلاً یک پروژه Firebase و یک برنامه متصل به Firebase دارید

  1. در کنسول Firebase ، به صفحه Build with Gemini بروید.

  2. روی Vertex AI in Firebase کلیک کنید تا یک گردش کاری راه اندازی شود که به شما کمک می کند کارهای زیر را انجام دهید. (توجه داشته باشید که اگر تب Vertex AI را در کنسول مشاهده کردید، این کارها کامل شده اند.)

  3. برای افزودن SDK به برنامه خود، مرحله بعدی این راهنما را ادامه دهید.

اگر قبلاً یک پروژه Firebase و یک برنامه متصل به Firebase ندارید


مرحله 2 : SDK را اضافه کنید

با راه اندازی پروژه Firebase و اتصال برنامه به Firebase (مرحله قبل را ببینید)، اکنون می توانید Vertex AI in Firebase SDK را به برنامه خود اضافه کنید.

Vertex AI in Firebase دسترسی به Vertex AI Gemini API را فراهم می کند و به عنوان بخشی از Firebase SDK برای پلتفرم های اپل ( firebase-ios-sdk ) گنجانده شده است. برای Vertex AI in Firebase ، باید از Swift Package Manager برای نصب و مدیریت وابستگی های Firebase استفاده کنید. سایر مدیران بسته، مانند CocoaPods، در حال حاضر پشتیبانی نمی شوند.

  1. در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.

  2. هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید:

      https://github.com/firebase/firebase-ios-sdk
    
  3. آخرین نسخه SDK را انتخاب کنید.

  4. کتابخانه FirebaseVertexAI-Preview را انتخاب کنید.

    پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.

مرحله 3 : سرویس Vertex AI و مدل مولد را راه اندازی کنید

قبل از اینکه بتوانید تماس API برقرار کنید، باید سرویس 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)
if let text = response.text {
  print(text)
}

چه کار دیگری می توانید انجام دهید؟

در مورد مدل های جمینی بیشتر بدانید

در مورد مدل های موجود برای موارد استفاده مختلف و سهمیه ها و قیمت آنها اطلاعات کسب کنید.

سایر قابلیت های Gemini API را امتحان کنید

یاد بگیرید چگونه تولید محتوا را کنترل کنید

همچنین می‌توانید با استفاده از Vertex AI Studio دستورات و پیکربندی‌های مدل را آزمایش کنید.


درباره تجربه خود با Vertex AI in Firebase بازخورد بدهید