管理沙盒模板

沙盒模板充当 自定义容器沙盒的蓝图。本页面演示了如何使用 Python SDK 管理沙盒模板的生命周期。您可以列出现有模板、查看其详细信息，或在不再需要时将其删除。

如需修改模板的配置（例如更改容器映像），请删除现有模板，然后使用更新后的配置创建新模板。

准备工作

如需管理沙盒模板，您需要在项目中拥有以下角色：

  • Agent Platform User (roles/aiplatform.user)

列出模板

如需列出与 Agent Platform 实例关联的所有沙盒模板，请执行以下操作：

import vertexai

client = vertexai.Client(project='<var>PROJECT_ID</var>', location='<var>LOCATION</var>')
instance_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID'

templates_response = client.agent_engines.sandboxes.templates.list(name=instance_name)

for template in templates_response.sandbox_environment_templates:
    print(template.name)

替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • LOCATION：Agent Platform 实例的区域。 Google Cloud 请参阅支持的区域。
  • INSTANCE_ID：Agent Platform 实例 ID。

查看模板详细信息

如需查看特定沙盒模板的配置，请执行以下操作：

template_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/SandboxEnvironmentTemplate/TEMPLATE_ID'

template = client.agent_engines.sandboxes.templates.get(name=template_name)
print(template)

替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • LOCATION：Agent Platform 实例的区域。 Google Cloud 请参阅支持的区域。
  • INSTANCE_ID：包含沙盒模板的 Agent Platform 实例 ID。
  • TEMPLATE_ID：沙盒模板 ID。

删除模板

如需删除沙盒模板，请执行以下操作：

client.agent_engines.sandboxes.templates.delete(name=template_name)
print("Template deleted.")