借助 Model Garden 的组织政策,您可以集中控制用户可以访问的模型以及他们可以执行的操作。默认情况下,任何有权使用 Gemini Enterprise Agent Platform 的用户都可以使用 Model Garden 发现、自定义和部署各种 Google 模型和第三方模型。
例如,如果您有一组可在生产环境中使用的已批准 Google 模型和第三方模型,则设置 Model Garden 政策可能会很有用。您可以在组织、文件夹或项目级层定义政策,以便用户只能访问已批准的模型。政策适用于所有主账号。组织政策不是按用户设置的政策。如需了解详情,请参阅组织政策服务简介。
政策评估
在评估时,系统会审核有助于特定资源的所有政策,并且只会合并并评估适用的政策。任何明确的拒绝值都优先于任何明确的允许值。
例如,假设您有一项文件夹政策拒绝特定模型,而一项项目政策允许该模型。假设这些政策已合并,则在项目级层拒绝访问该模型,因为文件夹级层的明确拒绝政策优先。不过,如果您将项目政策设置为替换所有父级政策,则在项目级层允许访问该模型。
如需了解详情,请参阅Resource Manager 文档中的 了解层次结构评估。
注意事项
- Model Garden 组织政策仅适用于 Model Garden 中的模型。例如,此政策不适用于在 Gemini Enterprise Agent Platform Model Registry 中注册的模型。
- 组织政策不能超过 500 个允许值和拒绝值。
- 对于自定义政策,您必须单独指定每个模型。您无法允许或拒绝一组模型。例如,您无法拒绝所有第三方模型,也无法仅对 Google 模型允许执行预测操作。
政策详情
设置政策时,您可以定义以下某项操作:
- 允许所有模型。
- 拒绝所有模型。
- 设置自定义政策规则,以允许或拒绝特定模型列表。
默认情况下,如果未设置或继承任何政策,则允许所有模型和操作。
对于自定义拒绝政策,您可以明确拒绝列出的模型 并隐式允许所有其他模型。同样,对于自定义允许政策,您可以明确允许列出的模型,并隐式拒绝所有其他模型。
如需在自定义政策和模型操作中指定模型,请使用以下格式:
publishers/PUBLISHER/models/MODEL_NAME:ACTION
替换以下内容:
PUBLISHER:拥有政策所适用的模型的发布者的名称。MODEL_NAME:要允许或拒绝的模型的名称。ACTION:要包含在政策中的模型操作。
例如,如需针对 Gemini 2.0 Flash 模型定义有关预测的政策规则,请指定 publishers/google/models/gemini-2.0-flash:predict。
完全限定的 ID (publishers/PUBLISHER/models/MODEL_NAME) 也称为“模型 ID”。如需查找模型的模型 ID,请前往 Model Garden 中的模型卡片。如需查看模型卡片的链接,请参阅
在 Model Garden 中探索 AI 模型中的模型列表。
模型操作
对于每个模型,您可以允许或拒绝以下操作:
predict:指定用户是否可以针对具有托管式 API 的模型(模型即服务)进行在线预测和批量预测。deploy:对于没有托管式 API 的模型,用于指定用户是否可以在 Google Cloud上部署模型。例如,此操作适用于 Google Cloud 控制台中的一键式部署。tune:指定用户是否可以对模型进行调优。
为模型操作设置政策
您可以使用 Google Cloud 控制台或
Google Cloud CLI 为 Model Garden 设置政策。限制条件的名称为 vertexai.allowedModels。如需详细了解如何设置政策,请参阅 Resource Manager 文档中的以下主题:
合作伙伴模型功能
对于合作伙伴模型,您可以允许或拒绝以下操作:
web_search:指定用户是否可以对合作伙伴模型使用网络搜索。 对于属于组织的项目,此功能默认处于拒绝状态,必须明确允许。structured_outputs:指定用户是否可以对合作伙伴模型使用结构化输出。对于属于组织的项目,此功能默认处于拒绝状态,必须明确允许。
为合作伙伴模型功能设置政策
您可以使用 vertexai.allowedPartnerModelFeatures 限制条件来允许或拒绝合作伙伴模型的 web_search 和 structured_outputs。
示例政策
以下示例政策采用 YAML 格式,您可以通过 gcloud CLI 设置政策时使用此格式。
拒绝一组模型并允许所有其他模型
以下示例拒绝对一组特定模型执行操作。
name: organizations/ORGANIZATION_ID/policies/vertexai.allowedModels spec: rules: values: deniedValues: - publishers/meta/models/llama3:deploy - publishers/google/models/gemini-2.0-flash:tune - publishers/hf-google/models/gemma-2b:deploy
将 ORGANIZATION_ID 替换为您的 Google Cloud组织的 ID。如需了解详情,请参阅获取组织资源。
允许一组模型并拒绝所有其他模型
以下示例允许对一组特定模型执行操作。
name: organizations/ORGANIZATION_ID/policies/vertexai.allowedModels spec: rules: values: allowedValues: - publishers/meta/models/llama3:deploy - publishers/google/models/gemini-2.0-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
以下示例为 Anthropic 的所有模型启用 web_search:
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
以下示例为 Anthropic 的所有模型启用 structured_outputs:
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