Conecte-se a uma sessão do Managed Agents a partir do seu terminal
Conecte a CLI ant a uma sessão do Claude Managed Agents para acompanhar sua transcrição ao vivo, enviar mensagens, permitir ou negar chamadas de ferramentas ou abrir o visualizador de sessões no seu navegador.
ant beta:sessions connect conecta seu terminal a uma sessão existente do Claude Managed Agents. Ele carrega a transcrição da sessão e a acompanha ao vivo enquanto o agente trabalha. Você também pode intervir: enviar uma mensagem, interromper o agente ou permitir ou negar uma chamada de ferramenta que está aguardando aprovação. Com --web, ele abre a sessão no visualizador de sessões do Claude Console no seu navegador.
O comando requer a versão 1.32.0 ou posterior da CLI. Para instalar ou atualizar a CLI e se autenticar, consulte o início rápido da CLI.
Conectar-se a uma sessão
Passe o ID de uma sessão no seu workspace. Você pode copiá-lo da resposta de criação, de ant beta:sessions list ou do Console.
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7Sem --web, o comando precisa de um terminal interativo. Em scripts, use ant beta:sessions:events stream e ant beta:sessions:events send em vez disso. Consulte Scripts e automação com a CLI.
Pressione Ctrl+C para desconectar. A sessão continua em execução, e conectar-se novamente carrega todo o seu histórico.
Acompanhar e direcionar a sessão
A visualização do terminal mostra a conversa ao vivo: mensagens e chamadas de ferramentas, com a duração e o resultado de cada chamada. Uma barra de status mostra se a sessão está em execução, ociosa ou aguardando sua aprovação. Em sessões multiagente, a visualização acompanha a thread principal da sessão, que inclui as mensagens que o coordenador troca com os agentes aos quais delega tarefas.
| Tecla | Ação |
|---|---|
| Enter | Envia sua entrada como um evento user.message. Alt+Enter ou Ctrl+J inicia uma nova linha. |
| Esc | Interrompe o agente enquanto ele está em execução (user.interrupt). |
| Ctrl+O | Mostra ou oculta detalhes: entradas e resultados de ferramentas, uso de tokens e eventos de status. --verbose (-v) inicia com os detalhes exibidos. |
| Page Up, Page Down | Rola pela transcrição. Rolar para cima pausa o acompanhamento; End o retoma. |
| Ctrl+C | Desconecta. Ctrl+D em uma linha de entrada vazia também desconecta. |
Quando uma chamada de ferramenta está aguardando sua aprovação, a linha de entrada muda para Allow tool call? Isso acontece sob uma política always_ask, ou sob auto quando o servidor não chega a uma determinação. Escolha Yes, No ou No, and tell the agent why. A CLI envia sua escolha como um evento user.tool_confirmation, com qualquer motivo que você digitar como seu deny_message.
Se a sessão estiver terminated ou tiver sido excluída, a visualização é somente leitura.
Abrir o visualizador de sessões no seu navegador
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web--web serve o visualizador de sessões do Console a partir de um servidor local em 127.0.0.1, imprime sua URL e a abre no seu navegador. Adicione --no-browser para não abrir o navegador. Você também pode enviar mensagens, interromper o agente e permitir ou negar uma chamada de ferramenta a partir do navegador. Diferentemente da visualização do terminal, o visualizador do navegador acompanha todas as threads de uma sessão multiagente.
A URL pode ser aberta uma única vez, em até dois minutos após ser impressa. Recarregar essa aba funciona, mas para abrir o visualizador em qualquer outro lugar, execute o comando novamente. Suas credenciais nunca saem da CLI: a página envia requisições apenas para o processo ant local, que faz as requisições à API. O servidor é executado até você pressionar Ctrl+C.
Was this page helpful?