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 \
  --name "python-dev" \
  --config '{type: cloud, networking: {type: unrestricted}}'

Verwende einen eindeutigen, aussagekräftigen name, damit du die 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 festgelegte Version installieren die neueste Version.

ant beta:environments create <<'YAML'
name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted
YAML

Unterstützte Paketmanager:



Netzwerk

Das Feld networking steuert den ausgehenden Netzwerkzugriff der Sandbox. Es hat keinen Einfluss auf die erlaubten Domains für die Tools web_search oder web_fetch.

Das folgende Beispiel erstellt eine Umgebung mit limited-Netzwerk:

ant beta:environments create <<'YAML'
name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true
YAML

Bei Verwendung des limited-Netzwerks:

• 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 für den Agent konfiguriert sind, zusätzlich zu denen, die im allowed_hosts-Array aufgeführt sind. Standardwert ist false.
• allow_package_managers erlaubt ausgehenden Zugriff auf öffentliche Paket-Registries (wie PyPI und npm) zusätzlich zu denen, die im allowed_hosts-Array aufgeführt sind. 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 Dateisystemzustand.
• 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

# Environments auflisten
ant beta:environments list

# Ein bestimmtes Environment abrufen
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Ein Environment archivieren (schreibgeschützt, bestehende Sessions laufen weiter)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Ein Environment löschen (nur wenn keine Sessions 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