Назначение задач агентам

Назначьте задачу агенту, и он будет работать в качестве официального исполнителя (assignee) до тех пор, пока работа не будет выполнена. Он может читать весь контекст задачи (описание + все комментарии), изменять статус, оставлять комментарии и редактировать поля. Это самый распространенный и ресурсоемкий из четырех путей запуска в Предиктор Икс. Этот же процесс поддерживает назначение задачи на команду (squad) — в этом случае Предиктор Икс запускает лидирующего агента (leader agent) этой команды.

«Автоповтор» (Auto retry) относится к повторным попыткам после сбоев инфраструктуры (отключение среды выполнения, таймаут). Бизнес-ошибки на стороне агента (например, если модель возвращает ошибку) повторно не обрабатываются. Подробнее см. в разделе Задачи.

Назначение через интерфейс (UI)

На странице с деталями задачи нажмите на поле выбора исполнителя (Assignee). В нем отображаются все участники рабочего пространства, все неархивированные агенты и каждая неархивированная команда. Выберите агента (или команду), и задача будет назначена мгновенно.

Несколько правил:

• Агенты пространства (Workspace agents) могут быть назначены любым участником; приватные агенты (private agents) могут быть назначены только их владельцем или администратором пространства.
• Вы можете назначать задачи только тем агентам, у которых есть активная среда выполнения в сети (online runtime). Агенты без запущенной среды отображаются в списке выбора как недоступные.
• Если задача находится в статусе Бэклог (Backlog), назначение не запускает агента. Бэклог — это зона ожидания; агент попадает в очередь только после того, как вы переведете задачу в статус «К исполнению» (Todo) или «В работе» (In Progress).

Назначение через CLI

Аналог команды в интерфейсе командной строки:

predictorx issue assign MUL-42 --to alice
predictorx issue assign MUL-42 --to-id 5fb87ac7-23b5-4a7a-81fa-ed295a54545d

Параметр --to принимает имя пользователя или имя агента (нечеткое совпадение). При совпадении имен — например, если есть агент J и агент Cursor - J — передайте вместо этого идентификатор --to-id <uuid>, используя user_id (для пользователя) или id (для агента) из вывода команд predictorx workspace member list --output json / predictorx agent list --output json. Сопоставление по UUID является строгим и однозначным, что отлично подходит для скриптов и агентов, управляющих CLI. Параметры --to и --to-id являются взаимоисключающими.

Снятие назначения:

predictorx issue assign MUL-42 --unassign

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

Когда задача, не находящаяся в Бэклоге, назначается агенту, Предиктор Икс немедленно выполняет в фоновом режиме следующие действия:

1. Добавляет в очередь задачу task в статусе queued с приоритетом, унаследованным от исходной задачи, направляя ее в среду выполнения (runtime), где запущен агент.
2. Демон агента забирает задачу task при следующем опросе и переводит ее в статус dispatched.
3. Агент начинает работу, и task переходит в статус running; по завершении статус меняется на completed или failed.
4. Во время выполнения агент может менять статус задачи, оставлять комментарии и редактировать поля — эти действия регистрируются под именем самого агента.

Если агент находится вне сети, задача task ожидает в очереди — ее время ожидания истекает через 5 минут, и она завершается ошибкой с причиной runtime_offline. Для источников с поддержкой повторных попыток (назначение, @-упоминание, чат) Предиктор Икс автоматически создает задачу в очереди повторно. Полные правила повторных попыток см. в разделе Задачи.

Назначение также автоматически подписывает агента на задачу. Однако в Предиктор Икс агенты не получают уведомления во входящие (их получают только пользователи). Эта подписка является внутренней системной операцией и не имеет видимых для пользователя побочных эффектов.

Переназначение или снятие назначения

При изменении исполнителя с Агента А на Агента Б:

1. Все запущенные процессы Агента А отменяются — каждая задача task в статусе queued, dispatched или running помечается как cancelled.
2. Для Агента Б немедленно создается новая задача task в очереди (если задача не в Бэклоге и у Б активна среда выполнения).

Снятие назначения (--unassign или выбор значения «none» в интерфейсе) помечает все активные записи task как cancelled и не создает новых задач в очереди. Существующие подписки не удаляются автоматически — прежний исполнитель остается в списке подписчиков (но по-прежнему не получает уведомлений во входящие).

Почему для одного агента по одной задаче может быть только одна активная task

Один агент может иметь не более одной задачи task в статусе queued или dispatched по одной и той же задаче одновременно. Это ограничение обеспечивается уникальным индексом на уровне базы данных и логикой резервирования задач — это предотвращает дублирование очередей и перезапись результатов при параллельном выполнении.

При этом разные агенты могут работать над одной задачей параллельно. Например, Агент А назначен исполнителем, а Агент Б вызван через @-упоминание; обе задачи task могут существовать одновременно, выполняясь в своих средах. Полные правила последовательного и параллельного выполнения см. в разделе Задачи.

Что дальше

• @-упоминание агента в комментарии — более легкий способ вызова, не меняющий исполнителя и статус задачи.
• Команды — назначение задачи группе агентов, где лидер распределяет работу.
• Чат — личный диалог с агентом вне рамок задачи.
• Автопилоты — автоматический запуск работы агентов по расписанию.