Claude Platform Docs

Connettiti a una sessione di Managed Agents dal tuo terminale

Collega la CLI ant a una sessione di Claude Managed Agents per seguirne la trascrizione in tempo reale, inviare messaggi, consentire o negare chiamate agli strumenti oppure aprire il visualizzatore della sessione nel tuo browser.

ant beta:sessions connect collega il tuo terminale a una sessione esistente di Claude Managed Agents. Carica la trascrizione della sessione e la segue in tempo reale mentre l’agente lavora. Puoi anche intervenire: inviare un messaggio, interrompere l’agente oppure consentire o negare una “tool call” (chiamata a uno strumento) in attesa di approvazione. Con --web, apre invece la sessione nel visualizzatore delle sessioni della Claude Console nel tuo browser.

Il comando richiede la versione 1.32.0 o successiva della CLI. Per installare o aggiornare la CLI ed effettuare l’autenticazione, consulta la guida rapida della CLI.

Connettiti a una sessione

Passa l’ID di una sessione nel tuo workspace. Puoi copiarlo dalla risposta di creazione, da ant beta:sessions list oppure dalla Console.

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7

Senza --web, il comando richiede un terminale interattivo. Negli script, usa invece ant beta:sessions:events stream e ant beta:sessions:events send. Consulta Scripting e automazione con la CLI.

Premi Ctrl+C per scollegarti. La sessione continua a essere eseguita e, connettendoti di nuovo, ne viene caricata l’intera cronologia.

Segui e guida la sessione

La vista del terminale mostra la conversazione in tempo reale: messaggi e chiamate agli strumenti, con la durata e l’esito di ciascuna chiamata. Una barra di stato indica se la sessione è in esecuzione, inattiva o in attesa della tua approvazione. Nelle sessioni multiagente, la vista segue il thread principale della sessione, che include i messaggi scambiati tra l’agente eseguito dalla sessione e gli agenti a cui delega.

TastoAzione
InvioInvia il tuo input come evento user.message. Alt+Invio o Ctrl+J inizia una nuova riga.
EscInterrompe l’agente mentre è in esecuzione (user.interrupt).
Ctrl+OMostra o nasconde i dettagli: input e risultati degli strumenti, utilizzo dei token ed eventi di stato. --verbose (-v) avvia la vista con i dettagli visibili.
Pagina su, Pagina giùScorre la trascrizione. Scorrere verso l’alto mette in pausa il tracciamento; Fine lo riprende.
Ctrl+CScollega. Anche Ctrl+D su una riga di input vuota scollega.

Quando una chiamata a uno strumento è in attesa della tua approvazione, la riga di input diventa Allow tool call? Questo accade con una policy always_ask, oppure con auto quando il server non giunge a una determinazione. Seleziona Yes, No oppure No, and tell the agent why. La CLI invia la tua scelta come evento user.tool_confirmation, con l’eventuale motivazione che digiti come suo deny_message.

Se la sessione è terminated o eliminata, la vista è di sola lettura.

Apri il visualizzatore della sessione nel tuo browser

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web

--web serve il visualizzatore delle sessioni della Console da un server locale su 127.0.0.1, ne stampa l’URL e lo apre nel tuo browser. Aggiungi --no-browser per evitare l’apertura del browser. Dal browser puoi anche inviare messaggi, interrompere l’agente e consentire o negare una chiamata a uno strumento. A differenza della vista del terminale, il visualizzatore nel browser segue ogni thread di una sessione multiagente.

L’URL può essere aperto una sola volta, entro 2 minuti dalla sua stampa. Ricaricare quella scheda funziona, ma per aprire il visualizzatore altrove esegui di nuovo il comando. Le tue credenziali non lasciano mai la CLI: la pagina invia richieste solo al processo ant locale, che effettua le richieste API. Il server rimane in esecuzione finché non premi Ctrl+C.

Was this page helpful?