איך מתחילים להשתמש ב-Gemini {7/}API באמצעות Vertex AI בערכות SDK של Firebase


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

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

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

  • אתם צריכים לוודא שסביבת הפיתוח ואפליקציית Flutter עומדות בדרישות הבאות:

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

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

    תוכלו לנסות את ה-SDK במהירות, לראות הטמעה מלאה של תרחישי שימוש שונים או להשתמש באפליקציה לדוגמה אם אין לכם אפליקציית Flutter משלכם. כדי להשתמש באפליקציה לדוגמה, צריך לחבר אותה לפרויקט Firebase.

שלב 1: מגדירים פרויקט Firebase ומקשרים את האפליקציה ל-Firebase

אם כבר יש לכם פרויקט Firebase ואפליקציה שמחוברת ל-Firebase

  1. במסוף Firebase, נכנסים לדף Build with Gemini.

  2. לוחצים על הכרטיס Vertex AI in Firebase כדי להפעיל תהליך עבודה שיעזור לבצע את המשימות הבאות:

  3. עוברים לשלב הבא במדריך כדי להוסיף את ה-SDK לאפליקציה.

אם עדיין אין לכם פרויקט Firebase ואפליקציה שמקושרת ל-Firebase


שלב 2: מוסיפים את ה-SDK

אחרי שמגדירים את פרויקט Firebase ומחברים את האפליקציה ל-Firebase (ראו שלב קודם), אפשר להוסיף את ה-SDK של Vertex AI in Firebase לאפליקציה.

הפלאגין Vertex AI in Firebase של Flutter (firebase_vertexai) מספק גישה ל-Vertex AI Gemini API.

  1. מספריית הפרויקט של Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין המרכזי:

    flutter pub add firebase_core
    
  2. בקובץ lib/main.dart, מייבאים את פלאגין הליבה של Firebase ואת קובץ התצורה שיצרתם קודם:

    import 'package:firebase_core/firebase_core.dart';
    import 'firebase_options.dart';
    
  3. בקובץ lib/main.dart, מאתחלים את Firebase באמצעות אובייקט DefaultFirebaseOptions שיוצאו מקובץ התצורה:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. בונים מחדש את אפליקציית Flutter:

    flutter run
    
  5. בתיקיית הפרויקט ב-Flutter, מריצים את הפקודה הבאה:

    flutter pub add firebase_vertexai
  6. בסיום, יוצרים מחדש את פרויקט Flutter:

    flutter run
    

שלב 3: הפעלה של השירות Vertex AI והמודל הגנרטיבי

לפני שתוכלו לבצע קריאות ל-API, צריך לאתחל את השירות Vertex AI ואת המודל הגנרטיבי.

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';

// Initialize FirebaseApp
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');

כשתסיימו לקרוא את המדריך לתחילת העבודה, נסביר איך לבחור מודל Gemini (ואופציונלי) גם מיקום שמתאים לתרחיש לדוגמה ולאפליקציה שלכם.

שלב 4: קוראים לפונקציה Vertex AI Gemini API

אחרי שחברתם את האפליקציה ל-Firebase, הוספתם את ה-SDK ואתחלתם את השירות Vertex AI ואת המודל הגנרטיבי, אתם מוכנים לבצע קריאה ל-Vertex AI Gemini API.

אפשר להשתמש ב-generateContent() כדי ליצור טקסט מבקשה של הנחיה בטקסט בלבד:

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';

await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

מה עוד אפשר לעשות?

מידע נוסף על המודלים של Gemini

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

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

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

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


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