Claude Platform Docs

Подключение к сессии Managed Agents из терминала

Подключите ant CLI к сессии Claude Managed Agents, чтобы следить за её стенограммой в реальном времени, отправлять сообщения, разрешать или запрещать вызовы инструментов или открывать средство просмотра сессий в браузере.

ant beta:sessions connect подключает ваш терминал к существующей сессии Claude Managed Agents. Команда загружает «transcript» (стенограмму) сессии и отслеживает её в реальном времени, пока агент работает. Вы также можете вмешаться: отправить сообщение, прервать агента, разрешить или запретить «tool call» (вызов инструмента), который ожидает одобрения. С флагом --web команда вместо этого открывает сессию в «session viewer» (средстве просмотра сессий) Claude Console в вашем браузере.

Для команды требуется версия 1.32.0 или более поздняя версия «command-line interface» (интерфейса командной строки), или CLI. Чтобы установить или обновить CLI и пройти аутентификацию, см. краткое руководство по CLI.

Подключение к сессии

Передайте ID сессии из вашего рабочего пространства. Его можно скопировать из ответа на запрос создания, из вывода ant beta:sessions list или из Console.

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7

Без --web команде требуется интерактивный терминал. В скриптах используйте вместо неё ant beta:sessions:events stream и ant beta:sessions:events send. См. Скрипты и автоматизация с CLI.

Нажмите Ctrl+C, чтобы отключиться. Сессия продолжит работу, а при повторном подключении загрузится вся её история.

Отслеживание сессии и управление ею

Терминальное представление показывает диалог в реальном времени: сообщения и вызовы инструментов с длительностью и результатом каждого вызова. «Status bar» (строка состояния) показывает, выполняется ли сессия, простаивает ли она или ожидает вашего одобрения. В мультиагентных сессиях представление отслеживает основной поток сессии, который включает сообщения, которыми координатор обменивается с агентами, которым он делегирует задачи.

КлавишаДействие
EnterОтправить введённый текст как событие user.message. Alt+Enter или Ctrl+J начинает новую строку.
EscПрервать агента во время его работы (user.interrupt).
Ctrl+OПоказать или скрыть подробности: входные данные и результаты инструментов, использование токенов и события состояния. С --verbose (-v) подробности отображаются с самого начала.
Page Up, Page DownПрокрутка стенограммы. Прокрутка вверх приостанавливает отслеживание; End возобновляет его.
Ctrl+CОтключиться. Ctrl+D в пустой строке ввода также отключает.

Когда вызов инструмента ожидает вашего одобрения, строка ввода меняется на Allow tool call? Это происходит при политике always_ask или при политике auto, когда сервер не приходит к решению. Выберите Yes, No или No, and tell the agent why. CLI отправляет ваш выбор как событие user.tool_confirmation, а введённая вами причина передаётся в его поле deny_message.

Если сессия находится в состоянии terminated или удалена, представление доступно только для чтения.

Открытие средства просмотра сессий в браузере

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web

--web запускает средство просмотра сессий Console на локальном сервере по адресу 127.0.0.1, выводит его URL и открывает его в вашем браузере. Добавьте --no-browser, чтобы не открывать браузер. Из браузера также можно отправлять сообщения, прерывать агента, разрешать или запрещать вызовы инструментов. В отличие от терминального представления, средство просмотра в браузере отслеживает все потоки мультиагентной сессии.

URL можно открыть только один раз и только в течение двух минут после его вывода. Перезагрузка этой вкладки работает, но чтобы открыть средство просмотра где-либо ещё, запустите команду снова. Ваши учётные данные никогда не покидают CLI: страница отправляет запросы только локальному процессу ant, который и выполняет запросы к API. Сервер работает, пока вы не нажмёте Ctrl+C.

Was this page helpful?