La policy dell'organizzazione di Model Garden ti consente di controllare centralmente i modelli a cui i tuoi utenti possono accedere e le azioni che possono intraprendere. Per impostazione predefinita, chiunque disponga delle autorizzazioni per utilizzare Gemini Enterprise Agent Platform può utilizzare Model Garden per scoprire, personalizzare ed eseguire il deployment di un'ampia gamma di modelli Google e di terze parti.
L'impostazione di una policy di Model Garden potrebbe essere utile, ad esempio, se hai un insieme di modelli Google e di terze parti approvati che possono essere utilizzati negli ambienti di produzione. Puoi definire una policy a livello di organizzazione, cartella o progetto in modo che gli utenti possano accedere solo ai modelli approvati. Una policy si applica a tutte le entità. Una policy dell'organizzazione non è una policy per utente. Per saperne di più, consulta Introduzione al servizio Policy dell'organizzazione.
Valutazioni delle policy
Al momento della valutazione, vengono esaminate tutte le policy che contribuiscono a una determinata risorsa e solo le policy applicabili vengono unite e poi valutate. Qualsiasi valore di negazione esplicita ha la precedenza su qualsiasi valore di autorizzazione esplicita.
Ad esempio, immagina di avere una policy delle cartelle che nega un modello specifico e una policy dei progetti che consente lo stesso modello. Supponendo che le policy vengano unite, l'accesso al modello viene negato a livello di progetto perché la policy di rifiuto esplicito a livello di cartella ha la precedenza. Tuttavia, se imposti la policy del progetto in modo che esegua l'override di tutte le policy principali, l'accesso al modello è consentito a livello di progetto.
Per saperne di più, consulta Informazioni sulla valutazione della gerarchia nella documentazione di Resource Manager.
Considerazioni
- La policy dell'organizzazione di Model Garden si applica solo ai modelli in Model Garden. Ad esempio, questa policy non si applica ai modelli registrati in Model Registry di Gemini Enterprise Agent Platform.
- Una policy dell'organizzazione non può superare i 500 valori consentiti e negati.
- Per una policy personalizzata, devi specificare ogni modello singolarmente. Non puoi consentire o negare un gruppo di modelli. Ad esempio, non puoi negare tutti i modelli di terze parti o consentire l'azione di previsione solo per i modelli Google.
Dettagli norme
Quando imposti una policy, definisci una delle seguenti azioni:
- Consenti tutti i modelli.
- Nega tutti i modelli.
- Imposta una regola della policy personalizzata per consentire o negare un elenco specifico di modelli.
Per impostazione predefinita, se non viene impostata o ereditata alcuna policy, sono consentiti tutti i modelli e tutte le azioni.
Per una policy di negazione personalizzata, neghi esplicitamente un elenco di modelli e consenti implicitamente tutti gli altri modelli. Analogamente, per una policy di autorizzazione personalizzata, consenti esplicitamente un elenco di modelli e neghi implicitamente tutti gli altri.
Per specificare i modelli in una policy personalizzata e un'azione del modello, utilizza il seguente formato:
publishers/PUBLISHER/models/MODEL_NAME:ACTION
Sostituisci quanto segue:
PUBLISHER: il nome del publisher proprietario del modello a cui si applica la policy.MODEL_NAME: il nome del modello da consentire o negare.ACTION: un'azione del modello da includere nella policy.
Ad esempio, per definire una regola della policy sulle previsioni rispetto al modello Gemini 3.5 Flash, specifica publishers/google/models/gemini-3.5-flash:predict.
L'ID completo (publishers/PUBLISHER/models/MODEL_NAME) è noto anche come ID modello. Per trovare l'ID di un modello, vai alla relativa scheda
in Model Garden. Per i link alle schede dei modelli, consulta l'elenco dei modelli in Esplora i modelli di AI in Model Garden.
Azioni per il modello
Per ogni modello, puoi consentire o negare le seguenti azioni:
predict: specifica se gli utenti possono effettuare previsioni online e in batch su un modello con un'API gestita (modello as a service).deploy: per i modelli senza un'API gestita, specifica se gli utenti possono eseguire il deployment dei modelli su Google Cloud. Ad esempio, questa azione si applica ai deployment con un solo clic nella console Google Cloud .tune: specifica se gli utenti possono ottimizzare i modelli.
Imposta una policy per le azioni del modello
Puoi impostare una policy per Model Garden utilizzando la console Google Cloud o Google Cloud CLI. Il nome del vincolo è vertexai.allowedModels. Per saperne di più sull'impostazione delle policy, consulta i seguenti argomenti nella documentazione di Resource Manager:
- Per le istruzioni relative alla console Google Cloud , consulta Creazione e gestione delle policy dell'organizzazione.
- Per istruzioni su gcloud CLI, consulta Utilizzo dei vincoli.
Funzionalità dei modelli di partner
Per i modelli dei partner, puoi controllare l'accesso alle seguenti funzionalità:
web_search: specifica se gli utenti possono utilizzare la ricerca web per i modelli partner. Per i progetti che appartengono a un'organizzazione, questa funzionalità è negata per impostazione predefinita e deve essere consentita esplicitamente.structured_outputs: specifica se gli utenti possono utilizzare output strutturati per i modelli partner. Per i progetti che appartengono a un'organizzazione, questa funzionalità è negata per impostazione predefinita e deve essere consentita esplicitamente.
Imposta una policy per le funzionalità dei modelli dei partner
Puoi consentire web_search e structured_outputs per i modelli partner utilizzando il vincolo vertexai.allowedPartnerModelFeatures. Poiché le funzionalità dei modelli partner sono negate per impostazione predefinita, questo vincolo supporta solo le regole allowedValues, allowAll e denyAll e non supporta gli elenchi deniedValues. Per impostare o aggiornare una policy dell'organizzazione, devi disporre del ruolo Organization Policy Administrator (roles/orgpolicy.policyAdmin).
Quando vertexai.allowedPartnerModelFeatures non consente una funzionalità, solo le richieste che la richiamano non vanno a buon fine e restituiscono un errore HTTP 400 FAILED_PRECONDITION. Le richieste di inferenza standard che non richiamano la funzionalità non sono interessate, così come i progetti che non appartengono a un'organizzazione.
Criteri di esempio
Le seguenti policy di esempio sono in formato YAML, che utilizzi quando imposti una policy tramite gcloud CLI.
Nega un insieme di modelli e consenti tutti gli altri modelli
L'esempio seguente nega le azioni su un insieme specifico di modelli.
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
Sostituisci ORGANIZATION_ID con l'ID della tua organizzazione Google Cloud. Per saperne di più, consulta Recupero di una risorsa Organizzazione.
Consenti un insieme di modelli e nega tutti gli altri modelli
L'esempio seguente consente azioni su un insieme specifico di modelli.
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
Abilita web_search per i modelli dei partner
Per attivare la funzionalità web_search per i modelli partner, puoi specificare quanto segue:
- Tutte le funzionalità per tutti i modelli di un publisher specifico, ad esempio:
publishers/anthropic - La funzionalità
web_searchper tutti i modelli di un publisher specifico, ad esempio:publishers/anthropic:web_search - Tutte le funzionalità per un modello specifico, ad esempio:
publishers/anthropic/models/MODEL_NAME - La funzionalità
web_searchper un modello specifico, ad esempio:publishers/anthropic/models/MODEL_NAME:web_search
L'esempio seguente mostra i formati supportati per allowedValues. Includi solo il livello minimo di accesso che vuoi concedere:
name: organizations/ORGANIZATION_ID/policies/vertexai.allowedPartnerModelFeatures spec: rules: values: allowedValues: # Allow all features of this publisher - publishers/anthropic # Allow web_search across all models of this publisher - publishers/anthropic:web_search # Allow all features of this model - publishers/anthropic/models/MODEL_NAME # Allow web_search for this specific model - publishers/anthropic/models/MODEL_NAME:web_search
Abilita structured_outputs per i modelli dei partner
Per attivare la funzionalità structured_outputs per i modelli partner, puoi specificare quanto segue:
- Tutte le funzionalità per tutti i modelli di un publisher specifico, ad esempio:
publishers/anthropic - La funzionalità
structured_outputsper tutti i modelli di un publisher specifico, ad esempio:publishers/anthropic:structured_outputs - Tutte le funzionalità per un modello specifico, ad esempio:
publishers/anthropic/models/MODEL_NAME - La funzionalità
structured_outputsper un modello specifico, ad esempio:publishers/anthropic/models/MODEL_NAME:structured_outputs
L'esempio seguente mostra i formati supportati per allowedValues. Includi solo il livello minimo di accesso che vuoi concedere:
name: organizations/ORGANIZATION_ID/policies/vertexai.allowedPartnerModelFeatures spec: rules: values: allowedValues: # Allow all features of this publisher - publishers/anthropic # Allow structured_outputs across all models of this publisher - publishers/anthropic:structured_outputs # Allow all features of this model - publishers/anthropic/models/MODEL_NAME # Allow structured_outputs for this specific model - publishers/anthropic/models/MODEL_NAME:structured_outputs
Passaggi successivi
Utilizza i modelli in Model Garden
Utilizza i modelli generativi di Model Garden nella console Google Cloud .
Testa le funzionalità del modello in Model Garden
Visualizza e testa rapidamente le funzionalità dei vari modelli utilizzando le demo in Model Garden.