Sandboxes, Vorlagen und Snapshots verwalten

Auf dieser Seite wird gezeigt, wie Sie den Lebenszyklus Ihrer Sandbox-Umgebungen, Sandbox-Vorlagen und Sandbox-Snapshots mit dem Python SDK verwalten. Sie können vorhandene Ressourcen auflisten, ihre Details ansehen oder sie löschen, wenn sie nicht mehr benötigt werden.

Hinweis

Zum Verwalten von Sandboxes und Vorlagen benötigen Sie die folgenden Rollen für Ihr Projekt:

  • Agent Platform User (roles/aiplatform.user)

Sandboxen verwalten

Sie können aktive Sandbox-Umgebungen, die mit einer Agent Platform-Instanz verknüpft sind, auflisten, Details dazu aufrufen und sie löschen. Wenn Sie die Konfiguration einer vorhandenen Sandbox ändern möchten, müssen Sie sie löschen und eine neue erstellen.

Sandboxes auflisten

So listen Sie alle mit einer Agent Platform-Instanz verknüpften Sandboxes auf:

import vertexai

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

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

for sandbox in sandboxes:
    print(sandbox.name)

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Die Google Cloud -Region Ihrer Agent Platform-Instanz. Unterstützte Regionen
  • INSTANCE_ID: Die Instanz-ID der Agent Platform.

Sandbox-Details ansehen

So rufen Sie die Konfiguration und den Status einer bestimmten Sandbox auf:

sandbox_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironments/SANDBOX_ID'

sandbox = client.agent_engines.sandboxes.get(name=sandbox_name)
print(sandbox)

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Die Google Cloud -Region Ihrer Agent Platform-Instanz. Unterstützte Regionen
  • INSTANCE_ID: Die ID der Agent Platform-Instanz, die Ihre Sandbox enthält.
  • SANDBOX_ID: Die ID der vorhandenen Sandbox, für die ein Snapshot erstellt werden soll.

Die Ausgabe enthält Details wie den Erstellungszeitpunkt, den Status (z.B. STATE_RUNNING) und die Sandbox-Spezifikation.

Sandbox löschen

So löschen Sie eine Sandbox-Umgebung explizit und geben Ressourcen kostenlos:

client.agent_engines.sandboxes.delete(name=sandbox_name)
print("Sandbox deleted.")

Sandbox-Vorlagen verwalten

Sandbox-Vorlagen dienen als Blaupausen für benutzerdefinierte Container-Sandboxes. Sie können diese Vorlagen auflisten, ansehen und löschen.

Wenn Sie die Konfiguration einer Vorlage ändern möchten, z. B. das Container-Image, löschen Sie die vorhandene Vorlage und erstellen Sie eine neue mit der aktualisierten Konfiguration.

Vorlagen auflisten

So listen Sie alle Sandbox-Vorlagen auf, die mit einer Agent Platform-Instanz verknüpft sind:

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

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

Vorlagendetails ansehen

So rufen Sie die Konfiguration einer bestimmten Sandboxvorlage auf:

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)

So löschen Sie eine Vorlage:

So löschen Sie eine Sandbox-Vorlage:

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

Snapshots verwalten

Mit Sandbox-Snapshots wird der Status Ihrer Sandbox-Umgebung beibehalten. Mit dem Python SDK können Sie alle Snapshots auflisten, Details zu einem bestimmten Snapshot ansehen oder Snapshots löschen.

Snapshots auflisten

So listen Sie alle Sandbox-Snapshots auf, die mit einer Agent Platform-Instanz verknüpft sind:

snapshots = client.agent_engines.sandboxes.snapshots.list(name=instance_name)

print(f"Size of sandbox snapshot list: {len(snapshots)}")
for snapshot in snapshots:
    print(snapshot)

Snapshot-Details ansehen

So rufen Sie die Details eines bestimmten Sandbox-Snapshots auf:

snapshot_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironmentSnapshots/SNAPSHOT_ID'

snapshot = client.agent_engines.sandboxes.snapshots.get(name=snapshot_name)
print(snapshot)

Ersetzen Sie SNAPSHOT_ID durch die ID Ihres spezifischen Sandbox-Snapshots.

Snapshot löschen

So löschen Sie einen Sandbox-Snapshot, der nicht mehr benötigt wird:

snapshot_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironmentSnapshots/SNAPSHOT_ID'

client.agent_engines.sandboxes.snapshots.delete(name=snapshot_name)
print("Snapshot deleted.")