במאמר הזה מפורטות המכסות והמגבלות של המערכת שחלות על Model Armor.
- המכסות נקבעות כברירת מחדל, אבל בדרך כלל אפשר לבקש לשנות אותן.
- מגבלות המערכת קבועות ואי אפשר לשנות אותן.
המכסות שלGoogle Cloud עוזרות לשמור על הוגנות ולצמצם עליות חדות בשימוש במשאבים ובזמינות שלהם. הן מגבילות את כמות המשאבים שלGoogle Cloud שאפשר להשתמש בהם בפרויקט ב- Google Cloud . המכסות רלוונטיות למגוון רחב של סוגי משאבים, כולל רכיבי חומרה, תוכנה ורשתות. לדוגמה, המכסות יכולות להגביל את מספר הקריאות ל-API בשירות מסוים, את מספר מאזני העומסים שאפשר להשתמש בהם בו-זמנית בפרויקט או את מספר הפרויקטים שאפשר ליצור. בשורה התחתונה, המכסות מגינות על משתמשיGoogle Cloud בכך שהן מונעות עומס יתר על השירותים, אבל גם עוזרות לשלוט על השימוש במשאבי Google Cloud .
מערכת המכסות ב-Cloud:
- עוקבת אחרי השימוש במוצרים ובשירותים של Google Cloud
- מגבילה את השימוש במשאבים האלה
- כוללת כלי שבאמצעותו אפשר לשלוח בקשות לשינוי המכסות ולשנות אותן אוטומטית
ברוב המקרים, כשאתם מנסים להשתמש ביותר משאבים מהמכסה, הגישה למשאב נחסמת ומה שאתם מנסים לעשות נכשל.
בדרך כלל, המכסות ב- Google Cloud הן ברמת הפרויקט. כלומר, השימוש במשאב מסוים בפרויקט כלשהו לא משפיע על המכסה שלכם בפרויקטים אחרים. ברמת הפרויקט ב- Google Cloud , המכסות משותפות לכל האפליקציות וכתובות ה-IP.
מכסות ל-API של Model Armor
בטבלה הבאה מפורטות המכסות של Model Armor API.
| מכסה | ערך |
|---|---|
| שאילתות API | 1,200 שאילתות לדקה (QPM) לכל פרויקט |
| בקשות אל ExternalProcessor | 600 שאילתות לדקה (QPM) לכל פרויקט 1 |
אפשר להגדיר ערך בין 0 ל-1,200 שאילתות לדקה לכל פרויקט. כדי לבקש שינוי, אפשר לעיין במאמר איך שולחים בקשה לשינוי המכסות. אם אתם צריכים מכסה גדולה יותר ממכסת ברירת המחדל, פנו אל Cloud Customer Care.
1 רלוונטי אם משלבים את Model Armor עם שירותי Google Cloud אחרים.
מגבלת המערכת על גודל הקובץ
בטבלה הבאה מפורטת מגבלת המערכת על הגודל של קובצי הקלט והתמונות. אם קובץ או תמונה חורגים מהמגבלה הזו, Model Armor מדלג על הסריקה שלהם.
| מגבלת המערכת | ערך |
|---|---|
| כל הקבצים הנתמכים והתמונות | 4 MB |
מגבלות מערכת על טוקנים
ל-Model Armor יש מגבלות מערכת שונות על טוקנים בהתאם למסנן הספציפי. המגבלות האלה חלות על טקסט ישיר בהנחיות ובתשובות, וגם על טקסט שחולץ מקבצים נתמכים. הגנה מוגברת על המודל סורקת טקסט של עד 65,536 אסימונים (בערך 262,144 תווים) כדי לזהות החדרת פרומפטים ופריצה, אתיקה של AI ומסננים של תוכן ויזואלי של התעללות מינית בילדים (CSAM). טוקן אחד שווה ערך לכ-4 תווים. מידע נוסף על ספירת האסימונים זמין במדריך לאסימונים ב-Gemini API.
מגבלות מערכת הטוקנים לא חלות על זיהוי כתובות URL זדוניות. במקום זאת, Model Armor אוכף מגבלה על מספר כתובות ה-URL שנסרקות. התכונה הגנה מוגברת על המודל מחלצת כתובות URL עד שהיא מגיעה ל-256 כתובות URL או לסוף המטען הייעודי (payload), והיא סורקת רק את 256 כתובות ה-URL הראשונות שנמצאות בפרומפטים ובתשובות.
| מסנן | מגבלת המערכת |
|---|---|
| זיהוי של החדרת פרומפטים ופריצה | 65,536 |
| שימוש אחראי ב-AI | 65,536 |
| תוכן ויזואלי של התעללות מינית בילדים (CSAM) | 65,536 |
| Sensitive Data Protection | 130,000 (0.5MB) |
ב-Sensitive Data Protection, Model Armor אוכף מגבלת מטען ייעודי של 0.5MB. מטען ייעודי (payload) בגודל 0.5MB תומך בכ-130,000 טוקנים של טקסט באנגלית (בסביבות 4 תווים לטוקן). במקרה של טקסט בשפה שאינה אנגלית, מספר הטוקנים הנתמכים עשוי להשתנות בהתאם לשפה, כי תווים בשפות שאינן אנגלית דורשים יותר בייטים לכל תו.
אם מסנן מזהה התאמה, הוא מחזיר את הערך MATCH_FOUND. אם המסנן לא מזהה התאמה, הערך שהוא מחזיר תלוי בשאלה אם ההנחיה או התשובה חורגות ממגבלת הטוקנים של המסנן:
- אם ההנחיה או התשובה נמצאות בטווח מגבלת האסימונים של המסנן, המסנן מחזיר את הערך
NO_MATCH_FOUND. - אם הפרומפט או התשובה חורגים ממגבלת האסימונים של המסנן, המסנן מחזיר
EXECUTION_SKIPPEDוכוללDetection skipped as token limit exceeded.בשדהmessageItemsשל תוצאת המסנן.
מספר בלתי מוגבל של טוקנים במצב סטרימינג בזמן אמת
כשמסירים תוכן זדוני או רגיש מטקסט בסטרימינג במצב בזמן אמת, הגנה מוגברת על המודל תומך בטוקנים ללא הגבלה. לעומת זאת, מצב סטרימינג במאגר נתונים זמני כפוף למגבלות האסימונים שמפורטות בטבלה שלמעלה.
מגבלות מערכת של כללי החרגה
בטבלה הבאה מפורטות מגבלות המערכת לגבי כללי החרגה שספציפיים לתבנית.
| הגבלה | ערך |
|---|---|
| מספר מקסימלי של קבוצות כללים לכל הגדרת מסנן | 10 |
| מספר הכללים המקסימלי בכל קבוצת כללים | 10 |
| מספר המילונים המקסימלי לבקשת תבנית | 10 |
| הגודל המקסימלי של רשימת מילים לכל מילון | 128KB |
| אורך מקסימלי של תבנית ביטוי רגולרי | 1,000 תווים |
| האורך המקסימלי של טקסט הקלט שנסרק כדי להחיל כללי החרגה | 130,000 טוקנים (0.5MB) |
כללי ההחרגה בודקים רק את 130,000 הטוקנים הראשונים (0.5MB) של טקסט הקלט. מטען ייעודי (payload) של 0.5MB תומך בכ-130,000 אסימונים לטקסט באנגלית (כ-4 תווים לכל אסימון). במקרה של טקסט בשפה שאינה אנגלית, מספר הטוקנים הנתמכים עשוי להשתנות בהתאם לשפה, כי תווים בשפות שאינן אנגלית דורשים יותר בייטים לכל תו. אם הקלט חורג מ-130,000 אסימונים (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.
המסוף
במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:
כניסה לדף Quotas & System Limits
בטבלה שבדף הזה מוצגות מכסות ומגבלות מערכת שיש להן שימוש או ערכים מותאמים, ורשומת עזר למכסות אחרות. ברשומה של ברירת המחדל מופיעה המילה default בסוגריים בסוף השורה בעמודה Name. לדוגמה,
SetIAMPolicy requests per minute per region (default)היא רשומת ההפניה למכסתSetIamPolicyRequestsPerMinutePerProject.אם העמודה מדד לא מופיעה, פועלים לפי השלבים הבאים.
- לוחצים על Column display options.
- בוחרים באפשרות מדד.
- לוחצים על 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של שם השירות.