כדי לשמור על הקצאת משאבים הוגנת, למנוע עומס יתר על השירות ולעזור לכם לנהל את השימוש במשאבים, ב-Model Armor יש מכסות ומגבלות מערכת.
מכסות ומגבלות מערכת דומות, אבל יש ביניהן כמה הבדלים:
- המכסות נקבעות כברירת מחדל, אבל בדרך כלל אפשר לבקש לשנות אותן.
- מגבלות המערכת קבועות ואי אפשר לשנות אותן.
המכסות שלGoogle Cloud עוזרות לשמור על הוגנות ולצמצם עליות חדות בשימוש במשאבים ובזמינות שלהם. הן מגבילות את כמות המשאבים שלGoogle Cloud שאפשר להשתמש בהם בפרויקט ב- Google Cloud . המכסות רלוונטיות למגוון רחב של סוגי משאבים, כולל רכיבי חומרה, תוכנה ורשתות. לדוגמה, המכסות יכולות להגביל את מספר הקריאות ל-API בשירות מסוים, את מספר מאזני העומסים שאפשר להשתמש בהם בו-זמנית בפרויקט או את מספר הפרויקטים שאפשר ליצור. בשורה התחתונה, המכסות מגינות על משתמשיGoogle Cloud בכך שהן מונעות עומס יתר על השירותים, אבל גם עוזרות לשלוט על השימוש במשאבי Google Cloud .
מערכת המכסות ב-Cloud:
- עוקבת אחרי השימוש במוצרים ובשירותים של Google Cloud
- מגבילה את השימוש במשאבים האלה
- כוללת כלי שבאמצעותו אפשר לשלוח בקשות לשינוי המכסות ולשנות אותן אוטומטית
ברוב המקרים, כשאתם מנסים להשתמש ביותר משאבים מהמכסה, הגישה למשאב נחסמת ומה שאתם מנסים לעשות נכשל.
בדרך כלל, המכסות ב- Google Cloud הן ברמת הפרויקט. כלומר, השימוש במשאב מסוים בפרויקט כלשהו לא משפיע על המכסה שלכם בפרויקטים אחרים. ברמת הפרויקט ב- Google Cloud , המכסות משותפות לכל האפליקציות וכתובות ה-IP.
מכסות ל-Model Armor API
בטבלה הבאה מפורטות המכסות של Model Armor API.
| מכסה | ערך |
|---|---|
| שאילתות API | 1,200 שאילתות לדקה (QPM) לכל פרויקט |
| בקשות ל-ExternalProcessor | 600 שאילתות לדקה (QPM) לכל פרויקט 1 |
אפשר להגדיר ערך בין 0 ל-1,200 שאילתות לדקה לכל פרויקט. כדי לבקש שינוי, קראו את המאמר איך שולחים בקשה לשינוי המכסות. אם אתם צריכים מכסה גדולה יותר ממכסת ברירת המחדל, פנו אל Cloud Customer Care.
מידע על מכסות שקשורות לשילובים של Model Armor עם שירותים אחרים זמין במאמר ניהול מכסות.
1 רלוונטי אם משלבים את Model Armor עם שירותי Google Cloud אחרים.
מגבלת המערכת על גודל הקובץ
בטבלה הבאה מפורטות מגבלות המערכת על קובצי קלט ותמונות.
| מגבלת המערכת | ערך |
|---|---|
| כל הקבצים הנתמכים | 4 MB |
| תמונות נפרדות | 4 MB |
| תמונות מוטמעות במסמכי טקסט עשיר | עד 5 תמונות לכל מסמך |
אם קובץ קלט או תמונה עצמאית חורגים ממגבלת הגודל, המערכת מדלגת על הסריקה של כל הקובץ או התמונה ומחזירה executionState של EXECUTION_SKIPPED לכל המסננים שהוגדרו.
באופן דומה, כשהמודל לזיהוי תמונות (MODALITY_IMAGE) מופעל, אם מסמך טקסט עשיר חורג ממגבלת הגודל של 4MB או מכיל יותר מ-5 תמונות מוטמעות, Model Armor מדלג על הסריקה של כל המסמך, כולל הטקסט והתמונות המוטמעות, בלי סריקה חלקית, ומחזיר executionState של EXECUTION_SKIPPED לכל המסננים שהוגדרו.
מגבלות המערכת על טוקנים
ל-Model Armor יש מגבלות מערכת שונות על אסימונים, בהתאם למסנן הספציפי. המגבלות האלה חלות על טקסט ישיר בהנחיות ובתשובות, וגם על טקסט שחולץ מקבצים נתמכים. הגנה מוגברת על המודל סורקת טקסט של עד 65,536 אסימונים (בערך 262,144 תווים) כדי לזהות החדרת פרומפטים ופריצה, AI אחראי ומסננים של תוכן ויזואלי של התעללות מינית בילדים (CSAM). טוקן של טקסט שווה ערך לכ-4 תווים. במאמרים הבאים מוסבר איך Model Armor מחשב טוקנים של טקסט, תמונות ומסמכי טקסט עשיר: טוקנים, חישוב טוקנים ותמחור של תמונות והמדריך לטוקנים של Gemini API.
מגבלות המערכת על טוקנים לא חלות על זיהוי של כתובות URL זדוניות. במקום זאת, Model Armor אוכף מגבלה על מספר כתובות ה-URL שנסרקות. הכלי "הגנה מוגברת על המודל" מחלץ כתובות URL עד שהוא מגיע ל-256 כתובות URL או לסוף המטען הייעודי (payload), וסורק רק את 256 כתובות ה-URL הראשונות שנמצאו בהנחיות ובתשובות.
| מסנן | מגבלת המערכת |
|---|---|
| זיהוי של החדרת פרומפטים ופריצת מגבלות (jailbreak) | 65,536 |
| AI אחראי | 65,536 |
| תוכן ויזואלי של התעללות מינית בילדים (CSAM) | 65,536 |
| Sensitive Data Protection | 130,000 (0.5MB) |
ב-Sensitive Data Protection, "הגנה מוגברת על המודל" אוכפת מגבלת מטען ייעודי (payload) של 0.5MB. מטען ייעודי (payload) של 0.5MB תומך בכ-130,000 אסימונים לטקסט באנגלית (כ-4 תווים לכל אסימון). בטקסטים בשפות אחרות, מספר האסימונים הנתמכים יכול להשתנות בהתאם לשפה, כי תווים בשפות אחרות דורשים יותר בייטים לכל תו.
אם מסנן מזהה התאמה, הוא מחזיר את הערך MATCH_FOUND. אם המסנן לא מזהה התאמה, הערך שהוא מחזיר תלוי בשאלה אם ההנחיה או התשובה חורגות ממגבלת האסימונים של המסנן:
- אם ההנחיה או התשובה נמצאות בטווח מגבלת הטוקנים של המסנן, המסנן מחזיר את הערך
NO_MATCH_FOUND. - אם ההנחיה או התשובה חורגות ממגבלת האסימונים של המסנן, המסנן מחזיר את הערך
EXECUTION_SKIPPEDוכולל את הערךDetection skipped as token limit exceeded.בשדהmessageItemsשל תוצאת המסנן.
טוקנים ללא הגבלה למצב סטרימינג בזמן אמת
כשמסירים תוכן זדוני או רגיש מטקסט בסטרימינג במצב זמן אמת, Model Armor תומך במספר בלתי מוגבל של טוקנים. לעומת זאת, מצב סטרימינג במאגר נתונים זמני כפוף למגבלות האסימונים שמפורטות בטבלה שלמעלה.
מגבלות המערכת על כללי החרגה
בטבלה הבאה מפורטות מגבלות המערכת של כללי החרגה ספציפיים לתבנית.
| הגבלה | ערך |
|---|---|
| מספר מקסימלי של קבוצות כללים לכל הגדרת מסנן | 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. העמודה מדד מופיעה בטבלה.
בעמודה Metric (מדד) מוצגים שמות המדדים. כדי לסנן את התוצאות, מזינים שם או ערך של מאפיין בשדה שליד 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של שם השירות.