מעבר ל-Firebase AI Logic SDKs מגרסה הבטא של Vertex AI ב-Firebase SDKs

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

Swift

1. ב-Xcode, כשפרויקט האפליקציה פתוח, מעדכנים את חבילת Firebase לגרסה 11.13.0 ואילך באמצעות אחת מהאפשרויות הבאות:

   • אפשרות 1: עדכון כל החבילות: עוברים אל קובץ > חבילות > עדכון לגרסאות החבילות העדכניות ביותר.

   • אפשרות 2: מעדכנים את Firebase בנפרד: עוברים לחבילה של Firebase בקטע Package Dependencies. לוחצים לחיצה ימנית על חבילת Firebase ובוחרים באפשרות עדכון החבילה.

2. מוודאים שחבילת Firebase מופיעה עכשיו בגרסה 11.13.0 ואילך. אם לא, צריך לוודא שדרישות החבילה שציינתם מאפשרות עדכון לגרסה 11.13.0 ואילך.

3. בוחרים את היעד של האפליקציה בכלי לעריכת פרויקטים, ואז עוברים לקטע Frameworks, Libraries, and Embedded Content.

4. מוסיפים את הספרייה החדשה: לוחצים על הלחצן + ואז מוסיפים את FirebaseAI מחבילת Firebase.

5. אחרי שתסיימו להעביר את האפליקציה (ראו את שאר הקטעים במדריך הזה), חשוב להסיר את הספרייה הישנה:
   בוחרים ב-FirebaseVertexAI-Preview, ואז לוחצים על הלחצן —.

Kotlin

1. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מחליפים את יחסי התלות הישנים (לפי הצורך) בקוד הבא.

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:33.14.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. סנכרון הפרויקט ב-Android עם קובצי Gradle.

הערה: אם בוחרים לא להשתמש ב-Firebase Android BoM, פשוט מוסיפים את התלות בספרייה firebase-ai ומאשרים את הגרסה האחרונה שמציע Android Studio.

Java

1. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מחליפים את יחסי התלות הישנים (לפי הצורך) בקוד הבא.

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:33.14.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. סנכרון הפרויקט ב-Android עם קובצי Gradle.

הערה: אם בוחרים לא להשתמש ב-Firebase Android BoM, פשוט מוסיפים את התלות בספרייה firebase-ai ומאשרים את הגרסה האחרונה שמציע Android Studio.

Web

1. מורידים את הגרסה העדכנית ביותר של Firebase JS SDK לאינטרנט באמצעות npm:

   npm i firebase@latest

   או

   yarn add firebase@latest

2. בכל מקום שבו ייבאת את הספרייה, צריך לעדכן את הצהרות הייבוא כך שייעשה שימוש ב-firebase/ai במקום זאת.

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

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. כדי לעדכן את השימוש בחבילה firebase_ai בקובץ pubspec.yaml, מריצים את הפקודה הבאה מתוך ספריית הפרויקט ב-Flutter:

   flutter pub add firebase_ai

2. מריצים מחדש את פרויקט Flutter:

   flutter run

3. אחרי שתסיימו להעביר את האפליקציה (ראו את שאר הקטעים במדריך הזה), חשוב למחוק את החבילה הישנה:

   flutter pub remove firebase_vertexai

Unity

לא הייתה תמיכה ב-Unity מ-"Vertex AI in Firebase".

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity

Swift

import FirebaseAI

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.0-flash")

Kotlin

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-2.0-flash")

Java

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-2.0-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.0-flash" });

Dart

import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-2.0-flash');

Unity

לא הייתה תמיכה ב-Unity מ-'Vertex AI in Firebase'.

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity

Swift

• רשימות ערכים

  • רוב סוגי enum הוחלפו ב-struct עם משתנים סטטיים. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן תואם לאחור. כשמשתמשים בהצהרות switch, מעכשיו צריך לכלול מקרה default: כדי לטפל בערכים לא ידועים או בערכים שלא מטופלים, כולל ערכים חדשים שיתווספו ל-SDK בעתיד.

  • שינית את השם של המניין BlockThreshold ל-HarmBlockThreshold. הסוג הזה הוא עכשיו struct.

  • הוסר המקרה unknown והמקרה unspecified מהרשימות הבאות (עכשיו struct): HarmCategory,‏ HarmBlockThreshold,‏ HarmProbability,‏ BlockReason ו-FinishReason.

  • החלפתם את המניין ModelContent.Part בפרוטוקול בשם Part כדי לאפשר הוספה של סוגים חדשים באופן תואם לאחור. השינוי הזה מוסבר בפירוט בקטע חלקי תוכן.

• חלקי תוכן

  • הסרנו את הפרוטוקול ThrowingPartsRepresentable ופשטנו את המאפיינים המפעילים של ModelContent כדי למנוע שגיאות של המהדר. תמונות שלא מקודדות כראוי עדיין יגרמו לשגיאות כשמשתמשים בהן ב-generateContent.

  • החלפתם את המקרים של ModelContent.Part בסוגי struct הבאים שתואמים לפרוטוקול Part:

    • .text עד TextPart
    • .data עד InlineDataPart
    • .fileData עד FileDataPart
    • .functionCall עד FunctionCallPart
    • .functionResponse עד FunctionResponsePart

• קטגוריית הנזק

  • שינינו את HarmCategory כך שלא יהיה יותר בתצוגת עץ בסוג SafetySetting. אם אתם מתייחסים אליו בתור SafetySetting.HarmCategory, תוכלו להחליף אותו ב-HarmCategory.

• משוב בנושא בטיחות

  • הסרתם את הסוג SafetyFeedback כי הוא לא שימש באף אחת מהתשובות.

• מטא-נתונים של הפניות

  • שינית את השם של נכס citationSources ל-citations ב-CitationMetadata.

• סה"כ תווים לחיוב

  • שינינו את המאפיין totalBillableCharacters ב-CountTokensResponse לאפשרות, כדי לשקף מצבים שבהם לא נשלחים תווים.

• תגובה של המועמד/ת

  • השם של CandidateResponse שונה ל-Candidate כדי להתאים לפלטפורמות אחרות.

• הגדרת הדור

  • השינויים שבוצעו בנכסים הציבוריים של GenerationConfig הם internal. אפשר להגדיר אותם ב-initializer.

Kotlin

• רשימות ערכים

  • כיתות enum וכיתות sealed הוחלפו בכיתות רגילות. השינוי הזה מאפשר גמישות רבה יותר בהתפתחות ה-API באופן תואם לאחור.

  • שינית את השם של המנייה BlockThreshold ל-HarmBlockThreshold.

  • הוסרו ערכים מהרשימות הבאות: HarmBlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• שיטות Blob

  • שינינו את השם של כל השיטות שכללו את Blob כחלק מהשם שלהן, והחלפנו אותן ב-InlineData.

• הגדרות בטיחות

  • השדה method השתנה לאפשרות nullable.

• סיווג משך הזמן

  • הוסרו כל השימושים בכיתה Duration של Kotlin והיא הוחלפה ב-long. השינוי הזה מאפשר יכולת פעולה הדדית טובה יותר עם Java.

• מטא-נתונים של הפניות

  • ארזנו את כל השדות שהוצהרו בעבר ב-CitationMetadata לכיתה חדשה בשם Citation. אפשר למצוא את ההפניות ברשימת citations ב-CitationMetadata. השינוי הזה מאפשר התאמה טובה יותר של הסוגים בפלטפורמות השונות.

• ספירת אסימונים

  • השדה totalBillableCharacters השתנה לאפשרות nullable.

• סה"כ תווים לחיוב

  • שינינו את המאפיין totalBillableCharacters ב-CountTokensResponse לאפשרות, כדי לשקף מצבים שבהם לא נשלחים תווים.

• יצירת מודל

  • ה��ר��ט�� requestOptions הועבר לסוף רשימת הפרמטרים כדי להתאים לפלטפורמות אחרות.

• Live API

  • הערך UNSPECIFIED הוסר עבור סוג ה-enum ResponseModality. במקום זאת, צריך להשתמש ב-null.

  • השם של LiveGenerationConfig.setResponseModalities השתנה ל-LiveGenerationConfig.setResponseModality.

  • הסרנו את הכיתה LiveContentResponse.Status, ובמקום זאת הטמענו את שדות הסטטוס כמאפיינים של LiveContentResponse.

  • הסרתם את הכיתה LiveContentResponse ובמקום זאת סיפקתם תת-כיתות של LiveServerMessage שתואמות לתשובות מהמודל.

  • שיניתם את LiveModelFutures.connect כך שתחזיר את הערך ListenableFuture<LiveSessionFutures> במקום ListenableFuture<LiveSession>.

Java

• רשימות ערכים

  • כיתות enum וכיתות sealed הוחלפו בכיתות רגילות. השינוי הזה מאפשר גמישות רבה יותר בהתפתחות ה-API באופן תואם לאחור.

  • שינית את השם של המנייה BlockThreshold ל-HarmBlockThreshold.

  • הוסרו ערכים מהרשימות הבאות: HarmBlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• שיטות Blob

  • שינינו את השם של כל השיטות שכללו את Blob כחלק מהשם שלהן, והחלפנו אותן ב-InlineData.

• הגדרות בטיחות

  • השדה method השתנה לאפשרות nullable.

• סיווג משך הזמן

  • הוסרו כל השימושים בכיתה Duration של Kotlin והיא הוחלפה ב-long. השינוי הזה מאפשר יכולת פעולה הדדית טובה יותר עם Java.

• מטא-נתונים של הפניות

  • ארזנו את כל השדות שהוצהרו בעבר ב-CitationMetadata לכיתה חדשה בשם Citation. אפשר למצוא את ההפניות ברשימת citations ב-CitationMetadata. השינוי הזה מאפשר התאמה טובה יותר של הסוגים בפלטפורמות השונות.

• ספירת אסימונים

  • השדה totalBillableCharacters השתנה לאפשרות nullable.

• סה"כ תווים לחיוב

  • שינינו את המאפיין totalBillableCharacters ב-CountTokensResponse לאפשרות, כדי לשקף מצבים שבהם לא נשלחים תווים.

• יצירת מודל

  • הפרמטר requestOptions הועבר לסוף רשימת הפרמטרים כדי להתאים לפלטפורמות אחרות.

• Live API

  • הערך UNSPECIFIED הוסר עבור סוג ה-enum ResponseModality. במקום זאת, צריך להשתמש ב-null.

  • השם של LiveGenerationConfig.setResponseModalities השתנה ל-LiveGenerationConfig.setResponseModality.

  • הסרנו את הכיתה LiveContentResponse.Status, ובמקום זאת הטמענו את שדות הסטטוס כמאפיינים של LiveContentResponse.

  • הסרתם את הכיתה LiveContentResponse ובמקום זאת סיפקתם תת-כיתות של LiveServerMessage שתואמות לתשובות מהמודל.

  • שיניתם את LiveModelFutures.connect כך שתחזיר את הערך ListenableFuture<LiveSessionFutures> במקום ListenableFuture<LiveSession>.

• שינינו שיטות רבות של בוני Java כך שהן יחזירו עכשיו את המופע של הכיתה שלהן, במקום void.

Web

• רשימות ערכים

  • הוסרו ערכים מהרשימות הבאות: HarmCategory,‏ BlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• הסיבה לחסימה

  • השדה blockReason ב-PromptFeedback השתנה לאפשרות אופציונלית.

שינויים נדרשים רק אם מתחילים להשתמש ב-Gemini Developer API (במקום ב-Vertex AI Gemini API):

• הגדרות בטיחות

  • הוסרו שימושים של SafetySetting.method שלא נתמכים.

• נתונים בתוך שורה

  • הוסרו שימושים של InlineDataPart.videoMetadata שלא נתמכים.

Dart

• רשימות ערכים

  • הוסרו ערכים מהרשימות הבאות: HarmCategory,‏ HarmProbability,‏ BlockReason ו-FinishReason.

• חלק נתונים

  • השם של DataPart השתנה ל-InlineDataPart, והשם של הפונקציה data ב-static השתנה ל-inlineData כדי להתאים לפלטפורמות אחרות.

• אפשרויות בקשה

  • הוסר RequestOptions כי timeout לא היה פונקציונלי. הוא יתווסף מחדש בעתיד הקרוב, אבל הוא יועבר לסוג GenerativeModel כדי להתאים לפלטפורמות אחרות.

• עצירת רצפים

  • הפרמטר stopSequences ב-GenerationConfig השתנה לאפשרי, וברירת המחדל שלו היא null במקום מערך ריק.

• ציטוטים

  • שינית את השם של נכס citationSources ל-citations ב-CitationMetadata. השם של הסוג CitationSource השתנה ל-Citation כדי להתאים לפלטפורמות אחרות.

• סוגי שיטות ומאפיינים ציבוריים מיותרים

  • הסרתם את הסוגים, השיטות והמאפיינים הבאים, שנחשפו ��ט��ו��: defaultTimeout,‏ CountTokensResponseFields,‏ parseCountTokensResponse,‏ parseEmbedContentResponse,‏ parseGenerateContentResponse,‏ parseContent,‏ BatchEmbedContentsResponse,‏ ContentEmbedding,‏ EmbedContentRequest ו-EmbedContentResponse.

• ספירת אסימונים

  • הוסרו שדות מיותרים מהפונקציה countTokens שכבר לא נחוצים. צריך רק את contents.

• יצירת מודל

  • הפרמטר systemInstruction הועבר לסוף רשימת הפרמטרים כדי להתאים לפלטפורמות אחרות.

• הטמעת פונקציונליות

  • הוסרו מהמודל פונקציות הטמעה שלא נתמכות (embedContent ו-batchEmbedContents).

Unity

לא הייתה תמיכה ב-Unity מ-"Vertex AI in Firebase".

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity