Управление агентом

После отправки запроса агент читает файлы, выполняет команды, предлагает план и задаёт вопросы. Всё, что агент делает в ответ на один запрос, называется ходом.

Чтение хода работы

В ленте последовательные команды объединены в раскрываемую серию. Во время выполнения заголовок серии показывает текущую команду, после завершения — итог, например Выполнено 2 команды. Серия из одних чтений подписана Чтение и именами файлов. Время выполнения и код ошибки видны справа в строке команды. Раскройте серию, затем нужную команду: появятся полный текст и вывод. Длинный вывод раскрывается кнопкой Показать все … строк. Если агент дал команде пояснение, строка показывает его вместо текста команды; полный текст виден в раскрытом блоке. Серия раскрывается и сворачивается плавно, а строки выше и ниже неё остаются на месте.

Отметки у команд:

• ждет подтверждения — команда ещё не выполнялась и ждёт вашего решения;
• отклонено — вы отклонили запуск;
• в фоне — команда продолжает работать после окончания хода; заголовок серии показывает, сколько команд работает в фоне. Вывод такой команды продолжает дописываться в её строку и после окончания хода и сохраняется после перезагрузки окна.

Вызовы инструментов MCP собираются в отдельную серию Вызвано N инструментов MCP.

Правки показываются отдельно: Правка, путь и число добавленных и удалённых строк. Щёлкните по строке, чтобы посмотреть изменения. В проекте у строки есть кнопка Открыть в инспекторе: в правой колонке откроется вид Изменения на этом файле.

Другие строки ленты:

• Смена модели — например, «Смена модели · Модель-1 → Модель-2»: появляется, когда вы выбираете другую модель у поля ввода, и показывает, с какого запроса действует новая модель. Если вернуть прежнюю модель до следующего запроса, строка исчезает.
• Хуки — команды, которые проект или вы настроили на события работы агента, показаны серией, как команды: описание хука или, например, «Хук при отправке запроса»; несколько хуков сворачиваются в Выполнено N хуков. Справа — время или итог, например «остановил запрос» или «запретил команду»; в раскрытой строке — сообщение хука, причина и файл, из которого он взят. Если хук остановил запрос, под запросом написано «Не отправлено: запрос остановил хук», а текст запроса возвращается в поле ввода.

Все шаги хода остаются в ленте и после его завершения. После работы с командами или файлами строка Работал: … показывает длительность завершённого хода.

Во время работы над полем ввода показано время. Надпись Думаю… или Размышляю… появляется после паузы модели; сам текст размышлений в ленте не показывается. Если ядро повторяет запрос к модели, под надписью показан номер попытки, например «АСТРА ИИ [ХАБ] отвечает с задержкой, повторяем запрос: 2 из 5». При ожидании подтверждения таймер приостанавливается. Если агент составил список шагов, справа в строке статуса виден прогресс, например «2 из 5»; щелчок по нему открывает весь список, после хода остаётся итог.

Файлы агента

Когда агент подготовил файлы для вас — отчёт, таблицу, картинку, — он показывает их в ленте карточками. На карточке — миниатюра или значок типа, имя файла, тип и размер, например «PDF · 1,2 МБ». Если файлов больше четырёх, остальные открывает кнопка Показать все файлы.

• Щелчок по карточке открывает Markdown, текст, код, картинки и PDF во встроенном просмотре, а документы и архивы — в программе, назначенной в системе.
• Кнопка ⋯ на карточке открывает меню: Открыть в программе по умолчанию, Показать в папке и Копировать путь.
• Отметка Файл удален означает, что файла больше нет на месте; Нет доступа — что приложение его не открывает, например файл лежит в сетевой папке или сессия в архиве.

Имена показанных файлов и полные пути к существующим файлам в ответе агента становятся ссылками: щелчок открывает файл во встроенном просмотре (см. раздел «Git и редактор»). Программы и скрипты по таким ссылкам приложение не запускает. Правый щелчок по ссылке открывает меню: Открыть в…, Показать в папке и Копировать путь (Полный путь, Относительный путь, Имя файла).

Карточки появляются в сессиях и чатах, начатых в версии 1.1.2 или новее.

Формулы в ответах

Формулы LaTeX в ответах агента показываются формулами: в строке текста — между $…$ или \(…\), отдельной строкой — между $$…$$ или \[…\]. Формулы рисуются без обращения к сети. Суммы в долларах вроде $5 и $10, переменные $HOME и $PATH и код остаются текстом. Формула со своими макросами (\def, \newcommand) показывается исходным текстом.

Переход по ленте

Слева в ленте показана рельса ходов — короткая группа чёрточек, по одной на каждый запрос; текущий выделен цветом. При наведении указателя на чёрточку появляется карточка с текстом запроса, началом ответа и кнопкой Сохранить ответ (Убрать из сохраненного). Щелчок по чёрточке переходит к этому запросу.

Строка, которую вы читаете, остаётся на месте, когда вы открываете правую колонку, меняете ширину окна или раскрываете серию выше. Кнопка со стрелкой вниз (К концу ленты) возвращает к концу ленты. На ней появляется отметка, если есть новые ответы (подсказка К новым ответам) или запрос подтверждения (подсказка Внизу ждет подтверждение).

Сводка изменений

В проекте после хода, в котором агент менял файлы, над полем ввода появляется сводка, например «2 файла изменено» с числом добавленных и удалённых строк. Сводка относится к последнему запросу, включая правки его субагентов; если последний запрос файлы не менял, сводки нет. Правка, которую вы отклонили в запросе подтверждения, не попадает ни в сводку, ни в вид Изменения. Пока агент работает или ждёт подтверждения, сводка скрыта.

• Обзор — открыть вид Изменения в правой колонке;
• стрелка — показать или свернуть список файлов; щелчок по файлу открывает его изменения;
• × (подсказка Закрыть) — скрыть сводку.

Как проверить и откатить изменения — см. раздел «Проверка, откат и повтор запроса».

Добавить следующий запрос

Во время работы агента введите сообщение и нажмите Enter или кнопку Поставить в очередь. Сообщение появится над полем ввода в блоке В очереди. После успешного завершения текущего хода сообщения запускаются по одному в заданном порядке. Очередь работает и в фоновой сессии.

У каждого сообщения сохраняются вложения и режим, выбранные при добавлении; права берутся из сессии в момент отправки. Когда сообщение из очереди уходит агенту новым ходом, над очередью виден блок Отправляется…. Чтобы уточнить текущий запрос, используйте кнопку Подкинуть.

Действия строки:

• Подкинуть — передать сообщение текущему агенту: он прочитает его после текущего шага. В блоке Подкинуто сообщение остаётся до прочтения агентом. Режим и права текущего хода сохраняются.
• Отправить — начать новый ход только с этим сообщением. Это та же кнопка: во время хода она называется Подкинуть, когда агент не работает — Отправить.
• Изменить — отредактировать текст. Кнопка Сохранить или клавиша Enter применяет правку, кнопка Отмена или клавиша Esc отменяет её. Если сохранить пустой текст, запись удаляется; если у сообщения есть вложения, остаются только они.
• × (подсказка Удалить из очереди) — убрать ещё не отправленное сообщение.

Порядок сообщений меняется перетаскиванием за ручку строки. Когда ручка в фокусе, используйте Alt+↑ и Alt+↓.

Пример уточнения:

Не меняй файлы тестов. Ограничь правку README.

Поставьте его в очередь, затем нажмите Подкинуть, если уточнение должно повлиять на текущую работу. Файлы, которые агент уже записал, остаются изменёнными. Чтобы прекратить работу сразу, остановите ход (см. ниже).

Во время проверки изменений (/review), сжатия контекста и индексации проекта ядро не принимает уточнения: кнопка Подкинуть недоступна, причина показана в подсказке. Сообщение остаётся в очереди и уйдёт после хода.

Работающие субагенты не мешают отправить новый запрос: его можно отправить, как только закончится ход основного агента.

Остановить работу

Нажмите кнопку Остановить выполнение у поля ввода. Она останавливает ход основного агента и всех работающих субагентов; пока субагенты работают, кнопка видна и после окончания хода. В ленте появится отметка Ход остановлен, поле ввода снова станет доступно. Проверьте файлы и терминал.

Очередь получит отметку на паузе. Непрочитанные сообщения из блока Подкинуто вернутся в её начало. Чтобы продолжить, отправьте новый запрос или нажмите Отправить у нужной строки; оставшаяся очередь продолжится после успешного завершения этого хода.

Записанные файлы остаются на диске. Чтобы отменить правки, откатите запрос (см. раздел «Проверка, откат и повтор запроса»). Фоновые процессы остановите командой /stop или в терминале.

Очередь также встаёт на паузу при ошибке — кроме предупреждения «Ядро не открыло базу состояния…»: с ним очередь продолжается. Отметка ждет решения по плану означает, что агент предложил план. Кнопка Выполнить план сама запускает следующий ход, а режим меняется на Правки; если вы отклонили план, очередь встаёт на паузу — отправьте новый запрос или нажмите Отправить у строки. Очередь не сохраняется после перезапуска приложения: перед закрытием скопируйте нужные неотправленные сообщения.

Если ход не выполнен

Если ход прервался из-за связи с АСТРА ИИ [ХАБ] или моделью, в ленте появляется строка Ход не выполнен с причиной, например «Связь с АСТРА ИИ [ХАБ] оборвалась во время ответа. Нажмите «Повторить запрос».», и кнопкой Повторить запрос. Кнопка возвращает текст запроса в поле ввода: проверьте его и отправьте. Состояние связи с АСТРА ИИ [ХАБ] описано в разделе «Вход и аккаунт АСТРА ИИ [ХАБ]».

Ответить агенту

Карточка разрешения команды или вызова MCP находится в ленте под строкой этой команды или вызова. Основные действия — кнопки Разрешить и Отклонить, остальные решения собраны в меню Еще. Кнопка Ответить сообщением позволяет предложить агенту другой способ выполнения; прочитайте пояснение под полем.

Запрос субагента приходит такой же карточкой с именем субагента в заголовке, например «Запрос на выполнение команды · субагент Einstein». В ленте основной сессии она стоит в конце ленты, а также видна в панели субагента и в разделе Входящие. Ответить субагенту сообщением нельзя. Запросы субагентов доходят и после того, как вкладку сессии закрыли и открыли снова.

Набор кнопок зависит от запроса; подробнее — см. раздел «Права и подтверждения». Запросы, которые ждут вашего ответа во всех сессиях, собраны в разделе Входящие (см. раздел «Интерфейс и навигация»).

Долгие команды

Команда, которая продолжает работать после окончания хода, отмечена в ленте в фоне; эта отметка сохраняется и после отката. Команда /ps показывает фоновые терминалы сессии. Вывод команды виден в её строке в ленте и на вкладке Агент терминала внизу правой колонки (Ctrl+3). Команда /stop (синоним — /clean) останавливает все фоновые терминалы сессии.

Перед повторным запуском убедитесь, что первая команда завершилась. Остановка хода фоновые команды не завершает — для этого есть /stop.