שאלות נפוצות ופתרון בעיות

אילו ממשקי API צריך להפעיל כדי להשתמש ב-SDKs של Vertex AI in Firebase? ואיך מפעילים אותם?

כדי להשתמש ב-SDKs של Vertex AI in Firebase, צריך להפעיל בפרויקט את שני ממשקי ה-API הבאים:

Vertex AI API (aiplatform.googleapis.com)
Vertex AI in Firebase API (firebasevertexai.googleapis.com)

אפשר להפעיל את ממשקי ה-API האלה בכמה קליקים במסוף Firebase:

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

לחלופין, אפשר להשתמש במסוף Google Cloud (אפשרות ידנית יותר):

לוחצים על כל קישור ל-API בחלק העליון של הרשומה הזו בשאלות הנפוצות, ואז לוחצים על Enable בדף של כל API.
מוסיפים את ה-API של Vertex AI in Firebase לרשימת ההיתרים של מפתח ה-API של Firebase לפי ההוראות בקטע הוספת הגבלות על ממשקי API במסמכי התיעוד של Google Cloud.

אילו הרשאות נדרשות כדי להשתמש ב-SDKs של Vertex AI in Firebase?

פעולה	הרשאות IAM נדרשות	תפקידי IAM שכוללים את ההרשאות הנדרשות כברירת מחדל
שדרוג החיוב לתוכנית תמחור של תשלום לפי שימוש (Blaze)	`firebase.billingPlans.update` `resourcemanager.projects.createBillingAssignment` `resourcemanager.projects.deleteBillingAssignment`	בעלים
הפעלת ממשקי API בפרויקט	`serviceusage.services.enable`	עריכה בעלים
יצירת אפליקציה ב-Firebase	`firebase.clients.create`	אדמין ב-Firebase עריכה בעלים

באילו מודלים אפשר להשתמש עם ערכות ה-SDK של Vertex AI in Firebase?

אפשר להשתמש בכל אחד מהמודלים הבסיסיים של Gemini עם ערכות ה-SDK של Vertex AI in Firebase. רשימה של המודלים האלה מופיעה במאמר מידע על המודלים של Gemini.

אתם יכולים להתחיל לבצע ניסויים עם המודל Gemini 2.0 (gemini-2.0-flash-exp) באמצעות ערכות ה-SDK של Vertex AI in Firebase.
נכון לעכשיו, ערכות ה-SDK שלנו תומכות בפלט טקסט ממקורות טקסט, קוד, תמונה, קובץ PDF, אודיו, וידאו ווידאו עם קלט אודיו. תמיכה ב-Multimodal Live API ובפלט אודיו ותמונה מקומיים תהיה זמינה בשנת 2025.
אי אפשר להשתמש במודלים של Gemini שאינם מודלים בסיסיים (כמו מודלים של PaLM, מודלים מותאמים או מודלים שמבוססים על Gemma) עם ערכות ה-SDK של Vertex AI in Firebase.

אנחנו מוסיפים יכולות חדשות ל-SDKs לעיתים קרובות, לכן מומלץ לחזור ולבדוק את השאלות הנפוצות האלה כדי לקבל עדכונים (וגם בפתקים לגבי גרסאות, בבלוגים ובפוסטים ברשתות החברתיות).

איך פותרים את השגיאה 400? `Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.`

אם מנסים לשלוח בקשה רב-מודאלית עם כתובת URL מסוג Cloud Storage for Firebase, יכול להיות שתופיע שגיאת 400:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

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

הנה הפתרון הזמין לבעיה כדי לתקן את הפרויקט ולהקצות כראוי את סוכני השירות האלה, כדי שתוכלו להתחיל לכלול כתובות URL מסוג Cloud Storage for Firebase בבקשות שלכם עם מספר מודלים. צריכה להיות לכם הרשאת בעלים בפרויקט, ותוכלו להשלים את קבוצת המשימות הזו רק פעם אחת בפרויקט.

גישה ואימות באמצעות gcloud CLI.
הדרך הקלה ביותר לעשות זאת היא דרך Cloud Shell. מידע נוסף זמין במסמכי העזרה בנושא Google Cloud.
אם תופיע בקשה, פועלים לפי ההוראות שמופיעות במסוף כדי להריץ את gcloud CLI בפרויקט Firebase.

תצטרכו את מזהה הפרויקט ב-Firebase. המזהה מופיע בחלק העליון של הקטע Project settings במסוף Firebase.

כדי להקצות את סוכני השירות הנדרשים בפרויקט, מריצים את הפקודה הבאה:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''

המתינו כמה דקות כדי לוודא שסוכנויות השירות הוקצו, ואז נסו שוב לשלוח את הבקשה עם התכונות הרב-מודליות שכוללת את כתובת ה-URL Cloud Storage for Firebase.

אם השגיאה הזו ממשיכה להופיע גם אחרי כמה דקות, פנו אל תמיכת Firebase.

איך פותרים את השגיאה 400? `API key not valid. Please pass a valid API key.`

אם מופיעה הודעת השגיאה 400 עם הטקסט API key not valid. Please pass a valid API key., בדרך כלל המשמעות היא שמפתח ה-API בקובץ או באובייקט התצורה של Firebase לא קיים או לא מוגדר לשימוש עם האפליקציה ו/או הפרויקט ב-Firebase.

בודקים שמפתח ה-API שמופיע בקובץ התצורה או באובייקט התצורה של Firebase תואם למפתח ה-API של האפליקציה. אפשר לראות את כל מפתחות ה-API בחלונית APIs & Services‏ > Credentials במסוף Google Cloud.

אם הם לא זהים, צריך לקבל קובץ/אובייקט תצורה חדש של Firebase ולהחליף את הקובץ/האובייקט שבאפליקציה. קובץ התצורה/האובייקט החדשים צריכים להכיל מפתח API תקף לאפליקציה ולפרויקט ב-Firebase.

איך פותרים את השגיאה 403? `Requests to this API firebasevertexai.googleapis.com ... are blocked.`

אם מופיעה שגיאת 403 עם הטקסט Requests to this API firebasevertexai.googleapis.com ... are blocked., בדרך כלל המשמעות היא שמפתח ה-API בקובץ או באובייקט התצורה של Firebase לא מכיל ממשק API נדרש ברשימת ההיתרים של המוצר שבו אתם מנסים להשתמש.

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

אפשר לראות את כל מפתחות ה-API בחלונית APIs & Services > Credentials במסוף Google Cloud.

איך פותרים את השגיאה 403? `PERMISSION_DENIED: The caller does not have permission.`

אם מופיעה הודעת השגיאה 403 עם הטקסט PERMISSION_DENIED: The caller does not have permission., בדרך כלל המשמעות היא שמפתח ה-API בקובץ התצורה או באובייקט התצורה של Firebase שייך לפרויקט אחר ב-Firebase.