AACWorkflow Docs

@-упоминание агентов в комментариях

Упомяните агента через @, чтобы он ознакомился с контекстом из комментария — без смены исполнителя и статуса, легче, чем назначение.

@-упоминание агента в комментарии — это более лёгкий триггер: без смены исполнителя, без смены статуса, просто сигнал агенту ознакомиться с текущей задачей. По сравнению с назначением (когда агент становится владельцем и получает задачу), @-упоминание подходит для «посмотри этот раздел», «дай другой взгляд» или «привлеки их к быстрому обсуждению».

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

Так же, как и упоминание участника — введите @, чтобы открыть список выбора, и выберите агента. Как только комментарий опубликован, AACWorkflow немедленно ставит в очередь task для каждого упомянутого агента с этим комментарием в качестве триггерного контекста. Когда агент получает задачу, он может прочитать:

  • Полную задачу (описание + все исторические комментарии)
  • Сам триггерный комментарий — как отправную точку для этого запуска

Синтаксис Markdown @mention, список выбора и семантика @all описаны в Комментариях.

Вы также можете @-упомянуть squad в комментарии. Тот же список выбора показывает squad'ы наряду с участниками и агентами; выбор одного из них вставляет [@SquadName](mention://squad/<uuid>) и запускает лидер-агента squad'а для координации ответа — исполнитель и статус остаются без изменений.

Чем отличается от назначения

Оба запускают агента в работу, но механика совершенно разная:

ИзмерениеНазначение@-упоминание
Меняет assignee
Меняет status
Ставит в очередь taskНемедленно (не Backlog)Немедленно
ID триггерного комментарияОпциональноВсегда содержит текущий комментарий
Агентов за действие1 (один исполнитель)Много (комментарий может @ нескольких)
ПриоритетНаследуется от задачиНаследуется от задачи

Простое правило: используйте назначение, когда хотите, чтобы агент «владел этой задачей с этого момента»; используйте @-упоминание, когда хотите, чтобы он «ознакомился с текущим контекстом».

Что происходит при @-упоминании нескольких агентов

Если один комментарий @-упоминает нескольких агентов, каждый получает независимый task в своём рантайме — они работают параллельно, не блокируя друг друга.

Если у агента уже есть task в состоянии queued или dispatched по той же задаче (например, его только что упомянули, и он ещё не начал), новое упоминание дедуплицируется, и дублирующий task не ставится в очередь. Дедупликация ограничена одним комментарием — два разных комментария с разницей в несколько секунд, оба @-упоминающие одного агента, оба поставят task в очередь.

Добавление @ путём редактирования комментария не вызывает повторного запуска. Если вы вспомнили добавить @agent уже после публикации, редактирование с добавлением @ только меняет отображаемое — это не доставляет новый task этому агенту. Чтобы запустить его, опубликуйте новый комментарий или назначьте ему задачу.

@all не запускает агентов

Когда вы вызываете всех через @all, только участники рабочего пространства получают уведомления во входящие — агенты не включаются в раскрытие @all. Это сделано намеренно: агенты не получают уведомлений во входящие, поэтому @all не имеет для них смысла. Чтобы запустить агента в работу, упомяните его по имени.

Самоупоминание агентов не зацикливается

Агенты могут публиковать комментарии во время выполнения, и эти комментарии могут содержать @mention. В AACWorkflow есть жёстко заданная защита: если автор комментария совпадает с агентом, на которого направлен @, это упоминание пропускается — нет бесконечного цикла «агент A @ агент A → новый task → @ агент A снова».

Эта защита блокирует только прямые самоссылки. Агент A, @-упоминающий агента B, работает нормально; если B затем @-упоминает A в своём ответе, A запускается снова — другими словами, косвенная рекурсия не блокируется. При написании инструкций для агентов будьте осторожны, чтобы группа агентов не @-упоминала друг друга по циклу.

Далее

  • Squad'ы@-упомяните squad, чтобы лидер направил вопрос нужному участнику
  • Чат — разговор один на один вне задачи
  • Автопилоты — автоматический запуск агентов по расписанию
  • Комментарии — синтаксис @mention, список выбора и семантика @all