Configurazione dell'ambiente cloud

Gli ambienti definiscono la configurazione del container in cui viene eseguito il tuo agente. Crei un ambiente una volta, poi fai riferimento al suo ID ogni volta che avvii una sessione. Più sessioni possono condividere lo stesso ambiente, ma ogni sessione ottiene la propria istanza di container isolata.

Crea un ambiente

ant beta:environments create \
  --name "python-dev" \
  --config '{type: cloud, networking: {type: unrestricted}}'

Il campo name deve essere univoco all'interno della tua organizzazione e workspace.

Usa l'ambiente in una sessione

Passa l'ID dell'ambiente come stringa quando crei una sessione.

Opzioni di configurazione

Pacchetti

Il campo packages pre-installa i pacchetti nel container prima che l'agente si avvii. I pacchetti vengono installati dai rispettivi gestori di pacchetti e memorizzati nella cache tra le sessioni che condividono lo stesso ambiente. Quando vengono specificati più gestori di pacchetti, vengono eseguiti in ordine alfabetico (apt, cargo, gem, go, npm, pip). Puoi facoltativamente specificare versioni precise; il valore predefinito è l'ultima versione disponibile.

Gestori di pacchetti supportati:

Networking

Il campo networking controlla l'accesso alla rete in uscita del container. Non influisce sui domini consentiti degli strumenti web_search o web_fetch.

Quando si utilizza il networking limited:

• allowed_hosts specifica i domini raggiungibili dal container. Devono essere preceduti dal prefisso HTTPS.
• allow_mcp_servers consente l'accesso in uscita agli endpoint del server MCP configurati sull'agente, oltre a quelli elencati nell'array allowed_hosts. Il valore predefinito è false.
• allow_package_managers consente l'accesso in uscita ai registri di pacchetti pubblici (PyPI, npm, ecc.) oltre a quelli elencati nell'array allowed_hosts. Il valore predefinito è false.

Ciclo di vita dell'ambiente

• Gli ambienti persistono fino a quando non vengono esplicitamente archiviati o eliminati.
• Più sessioni possono fare riferimento allo stesso ambiente.
• Ogni sessione ottiene la propria istanza di container. Le sessioni non condividono lo stato del file system.
• Gli ambienti non sono versionati. Se aggiorni frequentemente i tuoi ambienti, potresti voler registrare questi aggiornamenti dalla tua parte, per mappare lo stato dell'ambiente con le sessioni.

Gestisci gli ambienti

Runtime pre-installati

I container cloud includono runtime comuni già pronti all'uso. Consulta il Riferimento container per l'elenco completo dei linguaggi, database e utility pre-installati.