Durable agents на телефоне

Экспериментальная. Отображение durable agent на телефоне может измениться, либо функция может быть удалена в следующем минорном релизе. Раздел Durable agents описывает, от чего зависит её сохранение.

На этой странице показаны все места, где durable agent появляется на вашем телефоне: его строка на дашборде, список бесед, вопросы, чат, его стартеры и пуши. Раздел Durable agents описывает предварительное подключение durable agent.

Durable agent отображает элемент управления только для тех действий, которые он заявил в hello. Строка ниже, называющая элемент управления, предполагает, что durable agent его объявил.

Раздел Durable agents на дашборде

Каждый durable agent занимает одну строку в разделе Durable agents, отдельно от ваших spaces.

Durable agent, доступный через сокет либо по http://127.0.0.1 или http://localhost, имеет статус local. Все остальные URL — remote.

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

При включённой настройке «Show only panes that need you» в разделе выводятся только те durable agent, которые ждут вас. Нажмите на строку в любом состоянии, чтобы открыть список разговоров этого durable agent.

Список разговоров

Главный экран durable agent отображает его разговоры так же, как мессенджер отображает чаты.

Сначала идут те, что ждут вас, затем остальные открытые разговоры, сначала новые. Закрытые следуют под меткой Closed. В каждой строке показаны заголовок, значок состояния, время последней активности и одна строка под ним: ожидающий вопрос, иначе подзаголовок durable agent. В строке с ожиданием также указано число открытых вопросов. Строка без названия подписана как «Untitled conversation».

Нажмите на открытую строку, чтобы открыть её в Chat. Нажмите на закрытую строку, чтобы открыть её только для чтения. У закрытого разговора есть кнопка Reopen, если durable agent умеет их открывать повторно.

Открытые строки берутся из собственных данных панели управления, поэтому отображаются сразу. Закрытые поступают от durable agent, которого Collie опрашивает один раз за посещение и повторно при открытии или закрытии разговора, но не при каждом опросе.

Durable agent без истории показывает только свои открытые диалоги, без группы «Closed» и без примечания. Уже отрисованный список остаётся на экране, если последующее чтение завершается с ошибкой.

Вопрос на телефоне

Вопрос от durable agent отображается как карточка в чате, под вызовом соответствующего инструмента.

В подписи указан durable agent: «Needs your answer · desk». Если durable agent задал срок действия, строка под заголовком ведёт обратный отсчёт: «Expires in 4 min», затем «Expires in 40 s», затем «Expired». После истечения срока кнопки остаются, а на позднее нажатие durable agent отвечает сам.

Для «Always allow» требуется два нажатия. Первое меняет кнопку на «Tap again to always allow» и имя инструмента. Второе отправляет ответ. Collie не предлагает этот вариант, если в вопросе не назван инструмент.

Если Collie пришлось сократить или очистить текст durable agent, на карточке выводится «Text shortened» и вариант «Always allow» не предлагается, поскольку вам был показан не весь текст.

Карточка неизвестного для этой версии Collie типа показывает свой текст и сообщение «This ask cannot be answered from the phone.». Диалог отрисовывает первые 5 вопросов как карточки, а строка «Show N more» открывает остальные.

Что происходит после нажатия

Каждое нажатие передаёт один идентификатор запроса, и только нажатие отправляет ответ.

Квитанции

Collie сообщает, чем завершился вопрос, если вы на него не ответили, и почему durable agent отклонён.

Вопрос, на который вы ответили с телефона, или вопрос, завершённый из-за остановки хода, не оставляет такой строки. Ваше нажатие уже содержало карточку.

В блоке предупреждения указано, какую версию протокола использует каждая сторона, например «Program speaks wire v2, this Collie speaks v1. Update Collie, or the durable agent's SDK.». Обновите устаревшую сторону. Правило описано в Версии.

Чат

Диалог durable agent открывается во вкладке Chat — это его единственное представление.

Элемент reply, thinking, notice или markdown, который всё ещё дополняется, содержит курсор на конце и не имеет времени. Курсор исчезает по прибытии финального текста. Остановленный вами ход оставляет пометку «stopped».

Ваша реплика

Ваша реплика появляется в треде в момент нажатия Send со значком маленьких часов. Когда приходит копия от самого durable agent, она встаёт на место этой строки.

Durable agent, который не возвращает request id, сопоставляется по идентичному тексту в течение 30 секунд. Строка, которую durable agent так и не записал в ответ, перестаёт отображаться через 10 минут.

Пока ваша реплика остаётся последней в треде, а durable agent ещё не ответил, троеточие показывает, что идёт работа.

Заголовок

Заголовок состоит из двух строк. Первая строка содержит название диалога и значок Experimental.

Прогресс виден только тогда, когда диалог выполняется или ждёт ваших действий.

Панель действий

На панели действий находятся кнопки Steer и Stop, а затем до четырёх собственных кнопок долгоживущего агента.

Steer отправляет ваш текст в текущий шаг вместо запуска нового. Stop завершает текущий шаг. Кнопка, действие которой сейчас недоступно, становится блёклой на своём месте, поэтому интерфейс не сдвигается.

Нажатие указывает на самый свежий шаг, который отобразился на телефоне. Если диалог уже ушёл дальше, ничего не выполняется, и телефон сообщает об этом: «Диалог продвинулся дальше, поэтому действие не выполнено». Проверьте состояние, а затем нажмите кнопку снова, если действие всё ещё нужно.

Чего нет на панели долгоживущего агента

У долгоживущего агента нет экрана, поэтому на его панели нет режима Terminal, полос вкладок или панелей, а также кнопок Keys, Type или Quick. В его меню нет пунктов History, Pane settings и Pin to top row. Пункт Close в меню называется «Закрыть диалог».

Новый диалог и стартеры

Страница New долгоживущего агента называется «Новый диалог» и содержит список стартеров этого долгоживущего агента.

Стартер не принимает ни папку, ни текст: долгоживущий агент сам решает, где работать. Нажмите на стартер, и долгоживущий агент откроет новый диалог. На странице нельзя выбрать агент, шелл или команду хоста. Если у долгоживущего агента нет стартеров, выводится: «Долгоживущий агент этой машины пока не предлагает стартеров».

Push-уведомление

Вопрос может отправлять push-уведомление на ваш телефон в пределах лимитов для каждого durable agent.

Push-уведомление содержит текст «Permission needed in» и имя панели. Durable agent может добавить собственный заголовок (не более 60 символов) и строку (не более 120 символов). Collie отправляет push-уведомление с вопросом один раз для каждой связки машины, durable agent и вызова инструмента, поэтому вопрос, заданный повторно после перезапуска, отображается на экране, но не отправляет push-уведомление. Подробности см. в Push-уведомления от durable agent.

Маскирование

При включённом маскировании секретов (COLLIE_REDACT, включено по умолчанию) Collie маскирует секреты в заголовках и подзаголовках списка диалогов durable agent.

В составе crew

Дашборд ведущего узла (lead) содержит раздел Durable agents для каждой машины в составе crew. Durable agent участника добавляет имя участника во вторую строку, например pi-durable, local, workshop, а собственные durable agent ведущего узла не содержат имени машины. Вопрос на любой машине перемещает этот раздел выше рабочих пространств. В Durable agents в crew описано, кто и за что отвечает.