Cloud-Umgebung einrichten

Umgebungen definieren die Sandbox-Konfiguration, in der dein Agent ausgeführt wird. Du erstellst eine Umgebung einmal und referenzierst dann ihre ID jedes Mal, wenn du eine Session startest. Mehrere Sessions können dieselbe Umgebung gemeinsam nutzen, aber jede Session erhält ihre eigene isolierte Sandbox (einen frischen Linux-Container).

Diese Seite behandelt Umgebungen vom Typ type: cloud. Um Sandboxes auf deiner eigenen Infrastruktur auszuführen, siehe Selbst gehostete Sandboxes.



Eine Umgebung erstellen

ant beta:environments create < python-dev.environment.yaml

name: python-dev
config:
  type: cloud
  networking:
    type: unrestricted

Verwende einen eindeutigen, aussagekräftigen name, damit du Umgebungen voneinander unterscheiden kannst.



Die Umgebung in einer Session verwenden

Übergib die Umgebungs-ID als String, wenn du eine Session erstellst.

ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID"



Konfigurationsoptionen



Pakete

Das Feld packages installiert Pakete vorab in der Sandbox, bevor der Agent startet. Pakete werden von ihren jeweiligen Paketmanagern installiert und über Sessions hinweg gecacht, die dieselbe Umgebung nutzen. Wenn mehrere Paketmanager angegeben sind, werden sie in alphabetischer Reihenfolge ausgeführt (apt, cargo, gem, go, npm, pip). Du kannst optional bestimmte Versionen festlegen. Pakete ohne Versionsangabe installieren die neueste Version.

ant beta:environments create < environment.yaml

name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted

Unterstützte Paketmanager:



Netzwerk

Das Feld networking steuert den ausgehenden Netzwerkzugriff der Sandbox. Es hat keinen Einfluss auf die Tools web_search oder web_fetch, die auf den Servern von Anthropic ausgeführt werden; um die Websites einzuschränken, die diese Tools erreichen können, setze allowed_domains oder blocked_domains im Eintrag des Tools im Agent-Toolset. Siehe Domains für Websuche und Web-Fetch einschränken.

Das folgende Beispiel erstellt eine Umgebung mit limited-Netzwerk:

ant beta:environments create < environment.yaml

name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true

Bei Verwendung von limited-Netzwerk:

• allowed_hosts gibt Domains an, die die Sandbox erreichen kann. Gib reine Hostnamen oder Wildcard-Muster an (wie *.example.com). Füge kein URL-Schema, keinen Port und keinen Pfad hinzu.
• allow_mcp_servers erlaubt ausgehenden Zugriff auf MCP-Server-Endpunkte, die auf dem Agent konfiguriert sind, über die im allowed_hosts-Array aufgeführten hinaus. Standardwert ist false.
• allow_package_managers erlaubt ausgehenden Zugriff auf öffentliche Paket-Registries (wie PyPI und npm) über die im allowed_hosts-Array aufgeführten hinaus. Standardwert ist false.



Lebenszyklus von Umgebungen

• Umgebungen bleiben bestehen, bis sie explizit archiviert oder gelöscht werden.
• Jede Session erhält ihre eigene Sandbox-Instanz, auch wenn mehrere Sessions dieselbe Umgebung referenzieren. Sessions teilen keinen Dateisystem-Zustand.
• Umgebungen sind nicht versioniert. Wenn du eine Umgebung häufig aktualisierst, führe deine eigenen Aufzeichnungen über die Änderungen, damit du nachvollziehen kannst, welche Konfiguration jede Session verwendet hat.



Umgebungen verwalten

# Umgebungen auflisten
ant beta:environments list

# Eine bestimmte Umgebung abrufen
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Eine Umgebung archivieren (schreibgeschützt, bestehende Sitzungen laufen weiter)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Eine Umgebung löschen (nur wenn keine Sitzungen darauf verweisen)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



Vorinstallierte Laufzeitumgebungen

Cloud-Sandboxes enthalten gängige Laufzeitumgebungen von Haus aus. Siehe Cloud-Sandbox-Referenz für die vollständige Liste der vorinstallierten Sprachen, Datenbanken und Dienstprogramme.



Nächste Schritte