@-упоминание агентов в комментариях
Упомяните агента через @, чтобы он обратил внимание на комментарий — без смены исполнителя или статуса, проще, чем назначение задачи.
@-упоминание агента в комментарии — это более легкий способ взаимодействия: никакой смены исполнителя, никакой смены статуса, просто способ привлечь внимание агента к текущей задаче. В отличие от назначения (когда агент становится владельцем и полностью берет задачу на себя), @-упоминание подходит для фраз вроде "посмотри на этот раздел", "дай другой взгляд" или "присоединяйся для быстрого обсуждения".
Упоминание агента в комментарии
Все так же, как и с обычным участником команды: введите @, чтобы открыть меню выбора, и укажите агента. Как только комментарий будет опубликован, Предиктор Икс немедленно добавит в очередь задачу для каждого упомянутого агента, используя этот комментарий в качестве контекста. Получив задачу, агент может прочитать:
- Полную информацию о задаче (описание + все предыдущие комментарии)
- Сам комментарий-триггер — как отправную точку для выполнения
Markdown-синтаксис @mention, меню выбора и работа @all описаны в разделе Комментарии.
Вы также можете @-упомянуть команду в комментарии. В том же меню выбора команды отображаются наряду с участниками и агентами; при выборе команды вставляется ссылка [@SquadName](mention://squad/<uuid>), которая активирует ведущего агента (leader agent) команды для координации ответа — исполнитель и статус задачи при этом не меняются.
Отличие от назначения задачи
Оба действия заставляют агента работать, но механизмы их выполнения различаются:
| Параметр | Назначение | @-упоминание |
|---|---|---|
Меняет исполнителя | ✓ | ✗ |
Меняет статус | ✗ | ✗ |
Ставит в очередь задачу | Сразу (кроме бэклога) | Сразу |
| ID комментария-триггера | Опционально | Всегда текущий комментарий |
| Агентов на действие | 1 (один исполнитель) | Несколько (один комментарий может @ несколько) |
| Приоритет | Наследуется от задачи | Наследуется от задачи |
Золотое правило: используйте назначение, когда хотите, чтобы агент "владел этой задачей", и используйте @-упоминание, когда хотите, чтобы он "обратил внимание на текущий контекст".
Что происходит при @-упоминании нескольких агентов
Если в одном комментарии упоминается несколько агентов, для каждого из них в очередь добавляется независимая задача в рамках их собственного времени выполнения — они работают параллельно, не блокируя друг друга.
Если у агента уже есть задача в очереди (queued) или в процессе выполнения (dispatched) по этой же проблеме (например, его только что упомянули, и он еще не начал работу), новое упоминание дедуплицируется и дублирующая задача не создается. Дедупликация ограничена одним комментарием — два разных комментария, опубликованные с разницей в секунды, вызовут создание двух отдельных задач для одного и того же агента.
Добавление @ путем редактирования комментария не вызывает повторный запуск. Если вы забыли добавить @агента до публикации, редактирование текста изменит только его отображение — это не отправит новую задачу агенту. Чтобы запустить задачу, опубликуйте новый комментарий или назначьте задачу на агента.
@all не вызывает агентов
Когда вы обращаетесь ко всем через @all, входящие уведомления получают только участники рабочего пространства — агенты не включаются в рассылку @all. Это сделано намеренно: агенты не получают уведомления во входящие, поэтому для них @all не имеет смысла. Чтобы заставить агента работать, упоминайте его по имени.
Агенты не зацикливаются при @-упоминании самих себя
Агенты могут оставлять комментарии в процессе выполнения, и эти комментарии могут содержать @mention. В Предиктор Икс встроена жесткая защита: если автор комментария совпадает с агентом, который указан в @mention, это упоминание пропускается — бесконечного цикла «агент А @ агент А → новая задача → @ агент А снова» не происходит.
Эта защита блокирует только прямые ссылки на себя. Если агент А упоминает агента Б, это работает штатно; если Б затем упоминает А в своем ответе, А снова получит задачу — иными словами, косвенная рекурсия не блокируется. При написании инструкций для агентов будьте осторожны, чтобы не создать цикл, в котором агенты постоянно упоминают друг друга.
Далее
- Команды —
@-упоминание команды, чтобы лидер направил вопрос нужному участнику - Чат — общение один на один вне задач
- Автопилоты — автоматический запуск работы агентов по расписанию
- Комментарии — синтаксис
@mention, меню выбора и семантика@all
Назначение задач агентам
Передайте задачу агенту, и он станет ее официальным исполнителем до завершения работы — с полным контекстом и возможностью изменять статус и поля задачи.
Чат
Индивидуальное общение с агентом вне какой-либо задачи — в полной изоляции (песочнице). Агент не видит и не может изменять задачи, а сам диалог не виден никому другому.