Depois que uma sessão existe, use estas operações para lê-la, atualizá-la, arquivá-la ou excluí-la. Consulte Iniciar uma sessão para criar uma sessão e enviar trabalho a ela.
Todas as requisições à Managed Agents API exigem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.
As sessões progridem por estes status. Consulte Iniciar uma sessão para o ciclo de vida da sessão.
| Status | Descrição |
|---|---|
idle | O agente está aguardando entrada, incluindo mensagens do usuário ou confirmações de ferramentas. As sessões começam em idle. |
running | O agente está executando ativamente. |
rescheduling | Ocorreu um erro transitório, tentando novamente de forma automática. |
terminated | A sessão foi encerrada devido a um erro irrecuperável. |
Você pode atualizar agent.tools e agent.mcp_servers de uma sessão, incluindo políticas de permissão, no meio da sessão sem criar uma nova versão do agente. As atualizações são locais à sessão e não se propagam de volta ao agente subjacente.
A semântica de uma atualização é de substituição completa: o array fornecido é o novo valor. Para preservar entradas existentes, faça um GET na sessão, modifique o array e envie-o de volta com POST.
A sessão deve estar em idle para atualizar o agente. Interrompa a sessão se você precisar atualizar o agente enquanto ela estiver em execução.
Arquive uma sessão para impedir que novos eventos sejam enviados, preservando seu histórico. Uma sessão em running não pode ser arquivada; envie um evento de interrupção se você precisar arquivá-la imediatamente.
Exclua uma sessão para remover permanentemente seu registro, eventos e sandbox associado. Uma sessão em running não pode ser excluída; envie um evento de interrupção se você precisar excluí-la imediatamente.
Arquivos, armazenamentos de memória, vaults, skills, ambientes e agentes são recursos independentes e não são afetados pela exclusão da sessão.
Was this page helpful?
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
YAMLant beta:sessions retrieve --session-id "$SESSION_ID"ant beta:sessions list --agent-id "$AGENT_ID"ant beta:sessions archive \
--session-id "$SESSION_ID"ant beta:sessions delete \
--session-id "$SESSION_ID"