תחילת העבודה עם Gemini API באמצעות Vertex AI ב-Firebase SDKs


במדריך הזה מוסבר איך להתחיל לבצע קריאות ל-Vertex AI Gemini API ישירות מהאפליקציה באמצעות ה-SDK של Vertex AI in Firebase לפלטפורמה שבחרתם.

דרישות מוקדמות

המדריך הזה מניח שאתם מכירים את השימוש ב-Xcode לפיתוח אפליקציות עבור פלטפורמות של Apple (כמו iOS).

  • עליך לוודא שסביבת הפיתוח ואפליקציית פלטפורמות Apple עומדות בדרישות של הדרישות הבאות:

    • Xcode מגרסה 15.0 ואילך
    • האפליקציה צריכה לטרגט ל-iOS מגרסה 15 ואילך או macOS מגרסה 12 ואילך.

  • (אופציונלי) כדאי לבדוק את האפליקציה לדוגמה.

    הורדת האפליקציה לדוגמה

    אתם יכולים לנסות את ה-SDK במהירות, לראות הטמעה מלאה של תרחישים שונים לדוגמה או להשתמש באפליקציית הדוגמה אם אין לכם אפליקציה משלכם לפלטפורמות של Apple. כדי להשתמש באפליקציית הדוגמה, תצטרכו לקשר אותה לפרויקט 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 (ראו שלב קודם), עכשיו אפשר להוסיף לאפליקציה את ה-SDK Vertex AI in Firebase.

ספריית Vertex AI in Firebase מספקת גישה ל-Vertex AI Gemini API והיא כלולה ב-Firebase SDK לפלטפורמות של Apple‏ (firebase-ios-sdk). כדי להשתמש בספריית Vertex AI in Firebase, צריך להשתמש ב-Swift Package Manager כדי להתקין ולנהל את יחסי התלות של Firebase. כרגע אין תמיכה במנהלי חבילות אחרים, כמו CocoaPods.

  1. ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל File > (קובץ >) הוספת חבילות.

  2. כשמופיעה בקשה, מוסיפים את מאגר ה-SDK של מוצרי הפלטפורמה של Firebase של Apple:

      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

מידע על מודלים שזמינים למגוון תרחישים לדוגמה וגם מכסות ותמחור.

כדאי לנסות יכולות אחרות של Gemini API

איך שולטים ביצירת תוכן

אפשר גם לנסות הנחיות וליצור מודלים באמצעות Vertex AI Studio.


שליחת משוב על החוויה שלך עם Vertex AI in Firebase