• Mensagens
  • Agentes Gerenciados
  • Administração
Search...
⌘K
Primeiros passos
Visão geralInício rápidoPrototipar no Console
Definir seu agente
Configuração do agenteFerramentasConector MCPPolíticas de permissãoSkills de Agente
Configurar ambiente do agente
Configuração de ambiente na nuvemReferência de sandbox na nuvem
Delegar trabalho ao seu agente
Iniciar uma sessãoOperações de sessãoFluxo de eventos de sessãoAssinar webhooksDefinir resultadosAutenticar com cofres
Gerenciar contexto do agente
Acessar o GitHubAnexar e baixar arquivos
Orquestração avançada
Sessões multiagenteImplantações agendadas
Referência
Referência de Agentes Gerenciados
Trabalhando com arquivos
API de ArquivosSuporte a PDFImagens e visão
Skills
Visão geralPráticas recomendadasSkills para empresas
MCP
Servidores MCP remotos
Claude em plataformas de nuvem
Claude Platform na AWS
Log in
Operações de sessão
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Agentes Gerenciados/Delegar trabalho ao seu agente

Operações de sessão

Recupere, liste, atualize, arquive e exclua sessões do Claude Managed Agents.

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.

Status da sessão

As sessões progridem por estes status. Consulte Iniciar uma sessão para o ciclo de vida da sessão.

StatusDescrição
idleO agente está aguardando entrada, incluindo mensagens do usuário ou confirmações de ferramentas. As sessões começam em idle.
runningO agente está executando ativamente.
reschedulingOcorreu um erro transitório, tentando novamente de forma automática.
terminatedA sessão foi encerrada devido a um erro irrecuperável.

Atualizando a configuração do agente

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.

Recuperando uma sessão

Listando sessões

Arquivando uma sessã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.

Excluindo uma sessão

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?

  • Status da sessão
  • Atualizando a configuração do agente
  • Recuperando uma sessão
  • Listando sessões
  • Arquivando uma sessão
  • Excluindo uma sessão
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
ant 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"