Agenti gestitiDelegare il lavoro al tuo agente

Operazioni sulle sessioni

Recupera, elenca, aggiorna, archivia ed elimina le sessioni di Claude Managed Agents.

Una volta che una sessione esiste, usa queste operazioni per leggerla, aggiornarla, archiviarla o eliminarla. Consulta Avviare una sessione per creare una sessione e inviarle del lavoro.

Tutte le richieste all'API Managed Agents richiedono l'header beta managed-agents-2026-04-01. L'SDK imposta automaticamente l'header beta.

Stati della sessione

Le sessioni attraversano questi stati. Consulta Avviare una sessione per il ciclo di vita della sessione.

Stato	Descrizione
`idle`	L'agente è in attesa di input, inclusi messaggi dell'utente o conferme di strumenti. Le sessioni iniziano in `idle`.
`running`	L'agente è attivamente in esecuzione.
`rescheduling`	Si è verificato un errore transitorio, nuovo tentativo automatico in corso.
`terminated`	La sessione è terminata a causa di un errore irreversibile.

Aggiornare la configurazione dell'agente

Puoi aggiornare agent.tools e agent.mcp_servers di una sessione, incluse le policy di autorizzazione, durante la sessione senza creare una nuova versione dell'agente. Gli aggiornamenti sono locali alla sessione e non si propagano all'agente sottostante.

La semantica di un aggiornamento è la sostituzione completa: l'array fornito è il nuovo valore. Per preservare le voci esistenti, esegui una GET sulla sessione, modifica l'array e invialo nuovamente con una POST.

La sessione deve essere idle per aggiornare l'agente. Interrompi la sessione se devi aggiornare l'agente mentre è in esecuzione.

ant beta:sessions update --session-id "$SESSION_ID" <<'YAML'
agent:
  tools:
    - type: agent_toolset_20260401
    - type: mcp_toolset
      mcp_server_name: linear
  mcp_servers:
    - type: url
      name: linear
      url: https://mcp.linear.app/sse
YAML

Recuperare una sessione

ant beta:sessions retrieve --session-id "$SESSION_ID"

Elencare le sessioni

ant beta:sessions list --agent-id "$AGENT_ID"

Archiviare una sessione

Archivia una sessione per impedire l'invio di nuovi eventi preservandone la cronologia. Una sessione running non può essere archiviata; invia un evento di interruzione se devi archiviarla immediatamente.

ant beta:sessions archive \
  --session-id "$SESSION_ID"

Eliminare una sessione

Elimina una sessione per rimuovere definitivamente il suo record, gli eventi e la sandbox associata. Una sessione running non può essere eliminata; invia un evento di interruzione se devi eliminarla immediatamente.

File, memory store, vault, skill, environment e agent sono risorse indipendenti e non sono influenzati dall'eliminazione della sessione.

ant beta:sessions delete \
  --session-id "$SESSION_ID"

Was this page helpful?

Stati della sessione

Le sessioni attraversano questi stati. Consulta Avviare una sessione per il ciclo di vita della sessione.

Stato	Descrizione
`idle`	L'agente è in attesa di input, inclusi messaggi dell'utente o conferme di strumenti. Le sessioni iniziano in `idle`.
`running`	L'agente è attivamente in esecuzione.
`rescheduling`	Si è verificato un errore transitorio, nuovo tentativo automatico in corso.
`terminated`	La sessione è terminata a causa di un errore irreversibile.

Aggiornare la configurazione dell'agente

La sessione deve essere idle per aggiornare l'agente. Interrompi la sessione se devi aggiornare l'agente mentre è in esecuzione.

ant beta:sessions update --session-id "$SESSION_ID" <<'YAML'
agent:
  tools:
    - type: agent_toolset_20260401
    - type: mcp_toolset
      mcp_server_name: linear
  mcp_servers:
    - type: url
      name: linear
      url: https://mcp.linear.app/sse
YAML

Archiviare una sessione

ant beta:sessions archive \
  --session-id "$SESSION_ID"

Eliminare una sessione

File, memory store, vault, skill, environment e agent sono risorse indipendenti e non sono influenzati dall'eliminazione della sessione.

ant beta:sessions delete \
  --session-id "$SESSION_ID"

Was this page helpful?