Cada zona de pruebas está respaldada por una plantilla de entorno de zona de pruebas, que describe la imagen del contenedor que se ejecutará. Las plantillas de zona de pruebas sirven como planos para las zonas de pruebas de contenedores personalizados. En esta página, se muestra cómo administrar el ciclo de vida de las plantillas de zona de pruebas con el SDK de Agent Platform. Puedes enumerar las plantillas existentes, ver sus detalles o borrarlas cuando ya no sean necesarias.
Para modificar la configuración de una plantilla (como cambiar la imagen del contenedor), borra la plantilla existente y crea una nueva con la configuración actualizada.
Antes de comenzar
Para administrar las plantillas de zona de pruebas, necesitas los siguientes roles en tu proyecto:
- Usuario de Agent Platform (
roles/aiplatform.user)
Cómo volver a usar plantillas en zonas de pruebas
Para las zonas de pruebas de uso de la computadora y de shell, si no especificas una plantilla, se crea la plantilla predeterminada (DEFAULT_CONTAINER_CATEGORY_COMPUTER_USE o DEFAULT_CONTAINER_CATEGORY_SHELL_SANDBOX) para la zona de pruebas.
Se crea una plantilla nueva durante cada llamada a create() que no nombra una plantilla. Borrar la zona de pruebas no borra la plantilla, por lo que debes borrar las plantillas por separado. Si creas muchas zonas de pruebas, te recomendamos que vuelvas a usar las plantillas para conservar los recursos.
Para crear una plantilla, haz lo siguiente:
from agentplatform._genai import types
template_op = client.agent_engines.sandboxes.templates.create(
name=instance_name,
display_name="shell-sandbox-template",
config=types.CreateSandboxEnvironmentTemplateConfig(
default_container_environment=types.SandboxEnvironmentTemplateDefaultContainerEnvironment(
default_container_category=types.DefaultContainerCategory.DEFAULT_CONTAINER_CATEGORY_SHELL_SANDBOX,
),
),
)
template = template_op.response.name
Asocia cada zona de pruebas con la plantilla configurando sandbox_environment_template:
operation = client.sandboxes.create(
name=instance_name,
spec={"shell_environment": {}},
config={
"sandbox_environment_template": template,
"wait_for_completion": True,
},
)
Enumerar plantillas
Para enumerar todas las plantillas de zona de pruebas asociadas con una instancia de Agent Platform, haz lo siguiente:
import agentplatform
client = agentplatform.Client(project='PROJECT_ID', location='LOCATION')
instance_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID'
templates_response = client.sandboxes.templates.list(name=instance_name)
for template in templates_response.sandbox_environment_templates:
print(template.name)
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Cloud de Confiance proyecto de.LOCATION: La Cloud de Confiance región de tu instancia de Agent Platform. Consulta Regiones admitidas.INSTANCE_ID: Es el ID de la instancia de Agent Platform.
Ver los detalles de la plantilla
Para ver la configuración de una plantilla de zona de pruebas específica, haz lo siguiente:
template_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/SandboxEnvironmentTemplate/TEMPLATE_ID'
template = client.sandboxes.templates.get(name=template_name)
print(template)
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Cloud de Confiance proyecto de.LOCATION: La Cloud de Confiance región de tu instancia de Agent Platform. Consulta Regiones admitidas.INSTANCE_ID: Es el ID de la instancia de Agent Platform que contiene tu plantilla de zona de pruebas.TEMPLATE_ID: Es el ID de la plantilla de zona de pruebas.
Ver la plantilla de una zona de pruebas
Para ver la plantilla de zona de pruebas asociada con una zona de pruebas, ejecuta lo siguiente:
print(sandbox.sandbox_environment_template)
Borrar una plantilla
Para borrar una plantilla de zona de pruebas, haz lo siguiente:
client.sandboxes.templates.delete(name=template_name)
print("Template deleted.")