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

אילו ממשקי 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?

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

אי אפשר להשתמש במודלים של 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.