EGGENT документация
Работа с агентом

Доска задач

Отдавай агенту работу карточками. Каждая карточка выполняется в своём разговоре, одна за другой; карточки могут ждать друг друга, а доска говорит, когда какая-то ждёт тебя.

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

Открывается кнопкой Доска в боковой панели, под «Новым чатом». Число рядом — сколько карточек ждут тебя; точка — какие-то карточки сейчас в работе.

Колонки

Колонка Что в ней
Входящие Записанные, но не начатые карточки. Всё, что предлагает агент, попадает сюда и ждёт тебя
Очередь Карточки, которые начнутся сами, как только освободится место, сверху вниз
В работе Карточки, над которыми агент работает прямо сейчас
Ждёт тебя Карточки, остановленные ради тебя: агент задал вопрос, запуск упал, ты его остановил или результат ждёт твоей проверки
Готово Законченные карточки. Последний ответ каждой — её результат

Как написать карточку

Новая карточка, дальше:

  1. Название — коротко.
  2. Задача — что сделать, так, чтобы это можно было сделать без тебя: откуда брать данные, каким должен быть результат, куда его сохранить.
  3. Проект — карточка выполняется в этом проекте, с его инструкциями, навыками, памятью и файлами, или у оркестратора.
  4. Начать после — карточки, которых эта ждёт (см. ниже). Необязательно.
  5. Дать мне проверить результат — закончив, карточка остановится в «Ждёт тебя», а не уйдёт сразу в «Готово». Необязательно.

Начать сейчас ставит её в очередь, Сохранить во входящие откладывает на потом.

Попросить агента составить план

В любом чате:

«Разбей исследование конкурентов на задачи и положи на доску».

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

Карточки, которые ждут друг друга

Карточка с Начать после стартует, только когда готовы все карточки, которых она ждёт, а в её первом сообщении есть то, к чему они пришли: их итоговые ответы и сделанные файлы. Так выполняется цепочка вроде «собрать → сравнить → подвести итог», в том числе через проекты: первая карточка в одном проекте, следующая в другом.

Каждая карточка — разговор

Всё, что агент сделал по карточке, — в её разговоре: это обычный чат, в списке чатов он помечен значком доски. Открывается с карточки кнопкой Открыть разговор.

В него можно писать: ответ, уточнение, поправку. Карточка следит за этим ходом — пока он идёт, она в работе, а когда закончится, берёт новый результат. Строка вверху чата говорит, что это за карточка и где она сейчас.

Когда карточка ждёт тебя

  • Вопрос. Когда никто не смотрит, агент кладёт вопрос на карточку и останавливается. Ответь на карточке — кнопкой или своими словами: карточка встанет в начало очереди и продолжит с твоим ответом. Пусть решит агент — продолжить без ответа.
  • Ошибка. Запуск, закончившийся ошибкой, сам повторяется один раз через минуту. Если и он упадёт, карточка ждёт с текстом ошибки; Запустить ещё раз — когда причина устранена.
  • Замолчала. Запуск, который слишком долго ничего не говорит, останавливается, как в обычном чате.
  • Остановлена. Ты нажал Стоп. Продолжить — с того места, где остановилась.
  • Проверь результат. Карточку попросили проверить. Принять как готовое или Запустить ещё раз.
  • Прервана. Пространство перезапустилось посреди работы. Доска сама подхватывает такую карточку, не больше двух раз подряд; дальше она ждёт тебя.

Когда сервис моделей отказывает

Если сервис моделей отказал в запуске карточки — закончился баланс, пространство закрыто, — встаёт вся доска: иначе каждая карточка из очереди получила бы тот же отказ. Разберись с причиной и нажми Продолжить на доске.

Сколько одновременно

Одновременно работают до трёх карточек, и не больше одной на проект: карточки одного проекта работают в одной его папке и могли бы перезаписать файлы друг друга. Карточки разных проектов идут параллельно. На своём сервере это задают EGGENT_BOARD_MAX_RUNNING и EGGENT_BOARD_MAX_PER_PROJECT (см. «Настройки сервера»).

Перемещение карточек

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

Убрать прячет законченную карточку из «Готово»; Показать убранные под доской возвращает их на вид. Удалить удаляет карточку и её разговор; сделанные ею файлы остаются на месте.

Что агент может делать с доской

Агент читает доску и записывает новые карточки инструментом eggent_board. Запускаешь работу только ты: карточка, которую написал агент, всегда ждёт во «Входящих», а у запущенной карточки агент больше не может поменять задачу. Так задумано: агент читает страницы, файлы и сообщения извне, и строчка в любом из них не должна ставить в очередь задачу, у которой есть доступ к командной строке.

Пайплайны

Доска заменила пайплайны: цепочка шагов теперь — это карточки, которые ждут друг друга. Старая страница пайплайнов открывает доску.