מכסות ומגבלות מערכת

במאמר הזה מפורטות המכסות והמגבלות של המערכת שחלות על Model Armor.

• המכסות נקבעות כברירת מחדל, אבל בדרך כלל אפשר לבקש לשנות אותן.
• מגבלות המערכת קבועות ואי אפשר לשנות אותן.

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

מערכת המכסות ב-Cloud:

• עוקבת אחרי השימוש במוצרים ובשירותים של Google Cloud
• מגבילה את השימוש במשאבים האלה
• כוללת כלי שבאמצעותו אפשר לשלוח בקשות לשינוי המכסות ולשנות אותן אוטומטית

ברוב המקרים, כשאתם מנסים להשתמש ביותר משאבים מהמכסה, הגישה למשאב נחסמת ומה שאתם מנסים לעשות נכשל.

בדרך כלל, המכסות ב- Google Cloud הן ברמת הפרויקט. כלומר, השימוש במשאב מסוים בפרויקט כלשהו לא משפיע על המכסה שלכם בפרויקטים אחרים. ברמת הפרויקט ב- Google Cloud , המכסות משותפות לכל האפליקציות וכתובות ה-IP.

לסקירה כללית על מכסות ב-Cloud

מכסות ל-API של הגנה מוגברת על המודל

בטבלה הבאה מפורטות המכסות של Model Armor API.

מכסה	ערך
שאילתות API	‫1,200 שאילתות לדקה (QPM) לכל פרויקט
בקשות אל ExternalProcessor	‫600 שאילתות לדקה לכל פרויקט ^1

אפשר להחיל ערך בין 0 ל-1,200 QPM לכל פרויקט. כדי לבקש שינוי, אפשר לעיין במאמר איך שולחים בקשה לשינוי המכסות. אם אתם צריכים מכסה גדולה יותר מהמכסה שמוגדרת כברירת מחדל, אתם יכולים לפנות אל Cloud Customer Care.

מידע על מכסות שקשורות לשילובים של Model Armor עם שירותים אחרים זמין במאמר ניהול מכסות.

‫¹ רלוונטי אם משלבים את הגנה מוגברת על המודל עם שירותים אחרים של Google Cloud .

מגבלת גודל הקובץ במערכת

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

מגבלת המערכת	ערך
כל הקבצים הנתמכים והתמונות	4 MB

הערה: טקסט שחולץ מקבצים נתמכים כפוף למגבלות של מערכת הטוקנים. ‫הגנה מוגברת על המודל דוחה בקשות לסריקת קבצים שגודלם קטן מ-69 בייט ומחזירה שגיאה InvalidDocumentInputException כי סביר מאוד שהקבצים האלה לא תקינים.

מגבלות מערכת של טוקנים

ל-Model Armor יש מגבלות מערכת שונות על טוקנים בהתאם למסנן הספציפי. המגבלות האלה חלות על טקסט ישיר בהנחיות ובתשובות, וגם על טקסט שחולץ מקבצים נתמכים. ‫Model Armor סורק טקסט של עד 65,536 טוקנים (כ-262,144 תווים) כדי לזהות הזרקת הנחיות ופריצה, כדי לוודא שה-AI אחראי וכדי לסנן תוכן שמתאר התעללות מינית בילדים (CSAM). אסימון שווה בערך ל-4 תווים. מידע נוסף על ספירת האסימונים זמין במדריך לאסימונים של Gemini API.

המגבלות של מערכת הטוקנים לא חלות על זיהוי של כתובות URL זדוניות. במקום זאת, Model Armor אוכף מגבלה על מספר כתובות ה-URL שנסרקות. התכונה הגנה מוגברת על המודל מחלצת כתובות URL עד שהיא מגיעה ל-256 כתובות URL או לסוף המטען הייעודי (payload), וסורקת רק את 256 כתובות ה-URL הראשונות שנמצאו בהנחיות ובתשובות.

הערה: לזיהוי של החדרה פרומפטים ופריצת Jailbreak, אם מספר המילים קטן משלוש, הגנה מוגברת על המודל מחזיר NO_MATCH_FOUND כי אין מספיק מידע בקלט כדי להגדיר אותו כמתקפה.

הערה: מגבלות האסימונים האלה לא חלות על השילוב של Model Armor עם Gemini Enterprise.

מסנן	מגבלת המערכת
זיהוי של החדרת פרומפטים ופריצה	65,536
אתיקה של בינה מלאכותית	65,536
תוכן ויזואלי של התעללות מינית בילדים (CSAM)	65,536
Sensitive Data Protection	‫130,000

אם מסנן מזהה התאמה, הוא מחזיר את הערך MATCH_FOUND. אם המסנן לא מזהה התאמה, הערך שהוא מחזיר תלוי בשאלה אם ההנחיה או התשובה חורגות ממגבלת הטוקנים של המסנן:

• אם ההנחיה או התשובה נמצאות בטווח מגבלת הטוקנים של המסנן, המסנן מחזיר NO_MATCH_FOUND.
• אם ההנחיה או התשובה חורגות ממגבלת האסימונים של המסנן, המסנן מחזיר EXECUTION_SKIPPED וכולל Detection skipped as token limit exceeded. בשדה messageItems של תוצאת המסנן.

מספר בלתי מוגבל של טוקנים במצב סטרימינג בזמן אמת

כשמבצעים סניטציה של טקסט בסטרימינג במצב בזמן אמת, Model Armor תומך בטוקנים ללא הגבלה. לעומת זאת, מצב סטרימינג עם מאגר נתונים זמני כפוף למגבלות האסימונים שמפורטות בטבלה שלמעלה.

מגבלות מערכת של כללי החרגה

תצוגה מקדימה

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

בטבלה הבאה מפורטות מגבלות המערכת לגבי כללי החרגה שספציפיים לתבנית.

הגבלה	ערך
מספר מקסימלי של קבוצות כללים לכל הגדרת מסנן	10
מספר הכללים המקסימלי לכל קבוצת כללים	10
מספר המילונים המקסימלי לבקשת תבנית	10
הגודל המקסימלי של רשימת מילים לכל מילון	‫128KB
אורך מקסימלי של תבנית ביטוי רגולרי	‫1,000 תווים
הטקסט המקסימלי של הקלט שנסרק לכללי החרגה	‫0.5MB

כללי החרגה בודקים רק את 0.5MB הראשונים של טקסט הקלט. אם קלט גדול מ-0.5MB ומסנן מזהה התאמה שלא מכוסה על ידי כלל החרגה בחלק הסרוק הראשוני, המסנן מחזיר EXECUTION_SKIPPED. כדי לדעת אם דילגנו על מטען ייעודי (payload) בגלל מגבלת מטען ייעודי להחרגה או מגבלת טוקנים, צריך לבדוק את השדה messageItems ב-piAndJailbreakFilterResult או ב-raiFilterResult:

• חריגה ממגבלת המטען הייעודי (payload) של החרגות: Detection skipped as exclusion rules evaluation failed with reason: Input size exceeded max supported size of 0.5 MB. Exclusion rules execution could not be confirmed on full text.
• חריגה ממגבלת הטוקנים: Detection skipped as token limit exceeded.

החזרת EXECUTION_SKIPPED עוזרת לשמור על הבטיחות כש-Model Armor לא יכול להעריך את התוכן המלא בהשוואה לכללי ההחרגה.

קבלת שמות של מדדים שקשורים למכסת השימוש ולמגבלות המערכת

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

בהוראות הבאות מוסבר איך מקבלים שמות של מדדים למכסות ולמגבלות מערכת באמצעות Google Cloud המסוף או ה-CLI של gcloud.

המסוף

1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

   כניסה לדף Quotas & System Limits

   בטבלה שבדף הזה מוצגות מכסות ומגבלות מערכת שיש להן שימוש או ערכים מותאמים, ורשומת הפניה למכסות אחרות. הערך של ההפניה הוא המילה default (ברירת מחדל) בסוגריים בסוף הרישום בעמודה Name (שם). לדוגמה, SetIAMPolicy requests per minute per region (default) היא רשומת ההפניה למכסת SetIamPolicyRequestsPerMinutePerProject.

2. אם העמודה מדד לא מופיעה, פועלים לפי השלבים הבאים.

   1. לוחצים על Column display options.
   2. בוחרים באפשרות שיטה מטרית.
   3. לוחצים על OK. העמודה מדד מופיעה בטבלה.

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

gcloud

כדי לקבל את שמות המדדים של שירות Google Cloud מסוים באמצעות ה-CLI של gcloud, מריצים את הפקודה quotas info list. כדי לדלג על שורות שלא מופיעים בהן שמות של מדדים, מעבירים את הפלט לפקודה כמו grep עם metric: בתור מונח החיפוש, או משתמשים בדגל --format של ה-CLI של gcloud:

gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
    --service=SERVICE_NAME --format="value(metric)"

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID_OR_NUMBER: מזהה הפרויקט או מספר הפרויקט.
• ‫SERVICE_NAME: השם של השירות שרוצים לראות את מדדי המכסה שלו. לדוגמה, שם השירות של Compute Engine הוא compute.googleapis.com. צריך לכלול את החלק googleapis.com בשם השירות.