שליטה בגישה למודלים ב-Model Garden

מדיניות הארגון של Model Garden מאפשרת לכם לשלוט באופן מרוכז במודלים שהמשתמשים יכולים לגשת אליהם ובפעולות שהם יכולים לבצע. כברירת מחדל, כל מי שיש לו הרשאות להשתמש ב-Gemini Enterprise Agent Platform יכול להשתמש ב-Model Garden כדי למצוא, להתאים אישית ולפרוס מגוון רחב של מודלים של Google ושל צד שלישי.

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

הערכות מדיניות

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

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

מידע נוסף זמין במאמר הסבר על הערכת היררכיה במסמכי התיעוד של מנהל המשאבים.

לתשומת ליבכם

• מדיניות הארגון של Model Garden חלה רק על מודלים ב-Model Garden. לדוגמה, המדיניות הזו לא חלה על מודלים שרשומים במרשם המודלים של Gemini Enterprise Agent Platform.
• במדיניות הארגון יכולים להיות עד 500 ערכים מותרים ודחויים.
• במדיניות בהתאמה אישית, צריך לציין כל מודל בנפרד. אי אפשר לאשר או לדחות קבוצה של מודלים. לדוגמה, אי אפשר לדחות את כל המודלים של צד שלישי או לאשר את פעולת החיזוי רק למודלים של Google.

פרטי המדיניות

כשאתם מגדירים מדיניות, אתם מגדירים אחת מהפעולות הבאות:

• לאפשר את כל המודלים.
• דחיית כל המודלים.
• להגדיר כלל מדיניות מותאם אישית כדי לאשר או לדחות רשימה ספציפית של מודלים.

כברירת מחדל, אם לא הוגדרה או הועברה מדיניות, כל המודלים והפעולות מותרים.

במדיניות דחייה בהתאמה אישית, אתם דוחים באופן מפורש רשימה של מודלים, ומאשרים באופן משתמע את כל שאר המודלים. באופן דומה, במדיניות הרשאה בהתאמה אישית, אתם מאשרים באופן מפורש רשימה של מודלים ודוחים באופן משתמע את כל המודלים האחרים.

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

publishers/PUBLISHER/models/MODEL_NAME:ACTION

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

• ‫PUBLISHER: שם בעל המודל שהמדיניות חלה עליו.
• ‫MODEL_NAME: שם המודל שרוצים לאשר או לדחות.
• ‫ACTION: פעולת מודל שצריך לכלול במדיניות.

לדוגמה, כדי להגדיר כלל מדיניות לחיזויים במודל Gemini 3.5 Flash, מציינים את publishers/google/models/gemini-3.5-flash:predict.

המזהה המלא (publishers/PUBLISHER/models/MODEL_NAME) נקרא גם מזהה המודל. כדי למצוא את מזהה המודל, עוברים לכרטיס המודל ב-Model Garden. קישורים לכרטיסי מודלים מופיעים ברשימת המודלים במאמר סקירת מודלים של AI ב-Model Garden.

הערה: חלק מנקודות הקצה משתמשות במזהה מודל ייעודי של בעל תוכן דיגיטלי, שאין לו כרטיס מודל גלוי ב-Model Garden. לדוגמה, כדי לספור טוקנים במודלים של Anthropic Claude, צריך להשתמש במזהה ייעודי של מודל המפיץ. אם אתם מגדירים רשימת היתרים באמצעות האילוץ vertexai.allowedModels, הוסיפו את publishers/anthropic/models/count-tokens:predict לערכים המותרים בנוסף למודל Claude המטורגט. מידע נוסף זמין במאמר ספירת טוקנים במודלים של Claude.

פעולות במודל

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

• ‫predict: קובע אם המשתמשים יכולים ליצור חיזויים אונליין ובאצווה במודל עם API מנוהל (מודל כשירות).
• ‫deploy: במודלים בלי API מנוהל, ההגדרה הזו קובעת אם המשתמשים יכולים לפרוס מודלים ב- Google Cloud. לדוגמה, הפעולה הזו חלה על פריסות בלחיצה אחת במסוף Google Cloud .
• ‫tune: מציין אם המשתמשים יכולים לכוונן מודלים.

הגדרת מדיניות לפעולות של המודל

אפשר להגדיר מדיניות ל-Model Garden באמצעות מסוף Google Cloud או Google Cloud CLI. שם האילוץ הוא vertexai.allowedModels. למידע נוסף על הגדרת כללי מדיניות, קראו את הנושאים הבאים במאמרי העזרה של מנהל המשאבים:

• להוראות לשימוש במסוף Google Cloud , קראו את המאמר יצירה וניהול של מדיניות הארגון.
• להוראות ל-CLI של gcloud, ראו שימוש באילוצים.

תכונות של מודלים של שותפים

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

• ‫web_search: קובעת אם המשתמשים יכולים להשתמש בחיפוש באינטרנט במודלים של שותפים. בפרויקטים ששייכים לארגון, התכונה הזו מושבתת כברירת מחדל וצריך להפעיל אותה באופן מפורש.
• ‫structured_outputs: קובעת אם המשתמשים יכולים להשתמש בפלט מובנה במודלים של שותפים. בפרויקטים ששייכים לארגון, התכונה הזו מושבתת כברירת מחדל וצריך להפעיל אותה באופן מפורש.

הגדרת מדיניות לתכונות של מודלים של שותפים

אתם יכולים לאשר או לדחות את web_search ו-structured_outputs למודלים של שותפים באמצעות האילוץ vertexai.allowedPartnerModelFeatures.

כללי מדיניות לדוגמה

כללי המדיניות שבדוגמאות הבאות הם בפורמט YAML, שבו משתמשים כשמגדירים מדיניות באמצעות ה-CLI של gcloud.

דחייה של קבוצת דגמים ואישור של כל שאר הדגמים

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

name: organizations/ORGANIZATION_ID/policies/vertexai.allowedModels
spec:
  rules:
    values:
      deniedValues:
      - publishers/meta/models/llama3:deploy
      - publishers/google/models/gemini-3.5-flash:tune
      - publishers/hf-google/models/gemma-2b:deploy

מחליפים את ORGANIZATION_ID במזהה של הארגון ב- Google Cloud. מידע נוסף זמין במאמר קבלת משאב ארגון.

אישור קבוצה של מודלים ודחיית כל המודלים האחרים

בדוגמה הבאה אפשר לבצע פעולות בקבוצה ספציפית של מודלים.

name: organizations/ORGANIZATION_ID/policies/vertexai.allowedModels
spec:
  rules:
    values:
      allowedValues:
      - publishers/meta/models/llama3:deploy
      - publishers/google/models/gemini-3.5-flash:tune
      - publishers/hf-google/models/gemma-2b:deploy

הפעלת web_search למודלים של שותפים

כדי להפעיל את התכונה web_search במודלים של שותפים, אפשר לציין את הפרטים הבאים:

• כל התכונות בכל המודלים של ספק ספציפי, לדוגמה: publishers/anthropic
• כל התכונות של מודל ספציפי, לדוגמה: publishers/anthropic/models/MODEL_NAME
• התכונה web_search של מודל ספציפי, לדוגמה: publishers/anthropic/models/MODEL_NAME:web_search

בדוגמה הבאה מפעילים את web_search לכל המודלים של Anthropic:

name: organizations/ORGANIZATION_ID/policies/vertexai.allowedPartnerModelFeatures
spec:
  rules:
    values:
      allowedValues:
      # Allow all features of this publisher
      - publishers/anthropic
      # Allow all features of this model
      - publishers/anthropic/models/MODEL_NAME
      # Allow this feature
      - publishers/anthropic/models/MODEL_NAME:web_search

הפעלת structured_outputs למודלים של שותפים

כדי להפעיל את התכונה structured_outputs במודלים של שותפים, אפשר לציין את הפרטים הבאים:

• כל התכונות בכל המודלים של ספק ספציפי, לדוגמה: publishers/anthropic
• כל התכונות של מודל ספציפי, לדוגמה: publishers/anthropic/models/MODEL_NAME
• התכונה structured_outputs של מודל ספציפי, לדוגמה: publishers/anthropic/models/MODEL_NAME:structured_outputs

בדוגמה הבאה מפעילים את structured_outputs לכל המודלים של Anthropic:

name: organizations/ORGANIZATION_ID/policies/vertexai.allowedPartnerModelFeatures
spec:
  rules:
    values:
      allowedValues:
      # Allow all features of this publisher
      - publishers/anthropic
      # Allow all features of this model
      - publishers/anthropic/models/MODEL_NAME
      # Allow this feature
      - publishers/anthropic/models/MODEL_NAME:structured_outputs

המאמרים הבאים

מדריך

שימוש במודלים ב-Model Garden

שימוש במודלים גנרטיביים מ-Model Garden ב- .

מדריך

בדיקת היכולות של המודל ב-Model Garden

אתם יכולים להשתמש בהדגמות ב-Model Garden כדי לראות ולבדוק במהירות מה מודלים שונים יכולים לעשות.