במדריך הזה מוסבר איך להתחיל לבצע קריאות ל-Vertex AI Gemini API ישירות מהאפליקציה באמצעות ה-SDK של Vertex AI in Firebase לפלטפורמה שבחרתם.
דרישות מוקדמות
המדריך הזה מניח שאתם מכירים את פיתוח האפליקציות באמצעות Flutter.
אתם צריכים לוודא שסביבת הפיתוח ואפליקציית Flutter עומדות בדרישות הבאות:
- Dat 3.2.0 ואילך
(אופציונלי) כדאי לבדוק את האפליקציה לדוגמה.
תוכלו לנסות את ה-SDK במהירות, לראות הטמעה מלאה של תרחישי שימוש שונים או להשתמש באפליקציה לדוגמה אם אין לכם אפליקציית Flutter משלכם. כדי להשתמש באפליקציה לדוגמה, צריך לחבר אותה לפרויקט Firebase.
שלב 1: מגדירים פרויקט Firebase ומקשרים את האפליקציה ל-Firebase
אם כבר יש לכם פרויקט Firebase ואפליקציה שמחוברת ל-Firebase
במסוף Firebase, נכנסים לדף Build with Gemini.
לוחצים על הכרטיס Vertex AI in Firebase כדי להפעיל תהליך עבודה שיעזור לבצע את המשימות הבאות:
משדרגים את הפרויקט לתוכנית התמחור Blaze בתשלום לפי שימוש.
מפעילים את ממשקי ה-API הנדרשים בפרויקט (API Vertex AI ו-Vertex AI in Firebase API).
עוברים לשלב הבא במדריך כדי להוסיף את ה-SDK לאפליקציה.
אם עדיין אין לכם פרויקט Firebase ואפליקציה שמקושרת ל-Firebase
שלב 2: מוסיפים את ה-SDK
אחרי שמגדירים את פרויקט Firebase ומחברים את האפליקציה ל-Firebase (ראו שלב קודם), אפשר להוסיף את ה-SDK של Vertex AI in Firebase לאפליקציה.
הפלאגין Vertex AI in Firebase של Flutter (firebase_vertexai
) מספק גישה ל-Vertex AI Gemini API.
מספריית הפרויקט של Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין המרכזי:
flutter pub add firebase_core
בקובץ
lib/main.dart
, מייבאים את פלאגין הליבה של Firebase ואת קובץ התצורה שיצרתם קודם:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
בקובץ
lib/main.dart
, מאתחלים את Firebase באמצעות אובייקטDefaultFirebaseOptions
שיוצאו מקובץ התצורה:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
בונים מחדש את אפליקציית Flutter:
flutter run
בתיקיית הפרויקט ב-Flutter, מריצים את הפקודה הבאה:
flutter pub add firebase_vertexai
בסיום, יוצרים מחדש את פרויקט 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
- מידע נוסף על יצירת טקסט מהנחיות טקסט בלבד, כולל איך לשדר את התשובה באופן שוטף.
- יצירת טקסט באמצעות הנחיות מרובות מצבים (כולל טקסט, תמונות, קובצי PDF, וידאו ואודיו).
- ליצור שיחות עם זיכרון (צ'אט).
- יצירת פלט מובנה (כמו JSON) גם מהנחיות טקסט וגם מהנחיות מולטימודליות.
- אפשר להשתמש בשליחת פונקציות כדי לחבר מודלים גנרטיביים עם מידע ומערכות חיצוניות.
איך שולטים ביצירת תוכן
- הסבר על תכנון הנחיות, כולל שיטות מומלצות, אסטרטגיות והנחיות לדוגמה.
- להגדיר את הפרמטרים של המודל, כמו הטמפרטורה ואת מספר האסימונים המקסימלי של הפלט.
- שימוש בהגדרות הבטיחות כדי לשנות את הסבירות לקבלת תשובות שעשויות להיחשב כמזיקות.
שליחת משוב על חוויית השימוש ב-Vertex AI in Firebase