Работа с агентами в процессах команды

Гайд описывает подключение агентов к существующим процессам. Результат — заполненный маршрут работы с агентами, связанный с процессом трекера и Git-процессом. Пример маршрута.

Входы и ответственность

Нужны действующие правила задач и Git, доступы, выбранные типы задач и участники. ИИ-инженер с РП клиента, аналитиком, разработчиком и тестировщиком готовит маршрут; участники подтверждают решения в своей области. На старте достаточно выбранного потока; весь процесс предприятия описывать не требуется.

Статусы и условия переходов ведутся в task-workflow.md, ветки и требования к MR — в git-workflow.md. Маршрут агента ссылается на них, определяя кто выполняет шаг, где запрашивает решение и когда продолжает. Уменьшение контроля требует отдельного решения по регламенту ревью.

Запуск задачи

Команда выбирает один или оба способа:

• Человек пишет в установленном чате, что конкретную готовую задачу можно брать в работу. Должны быть понятны задача, согласованный объём и полномочия автора сообщения.
• Человек переводит задачу в реальный статус трекера, из которого агенты берут работу. В маршруте задаются статус/ID и точные условия выборки; обычное назначение исполнителя или произвольный статус не означают запуск.

Агент проверяет выбранный сигнал допуска и готовность входов, связывает задачу с делом/запуском и подтверждает приём. При использовании обоих способов повтор одного поручения не запускает второе выполнение. Очередь, повторная доставка, пауза или восстановление не меняют согласованный объём.

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

HITL в task- и Git-процессе

В двух таблицах HITL отдельно описываются обращения, следующие из процессов задач/Git, и запросы, которые агент формирует по своим навыкам. В каждой таблице два столбца: повод и содержание обращения. Код-ревью, ревью тестов, продуктовая приёмка и согласование интеграции следуют правилам команды; вопросы по неопределённости, выбору решения или препятствию возникают при выполнении задачи.

Любой запрос HITL система направляет через чат с указанием наступившего события и ссылкой на задачу и нужный материал, например MR или результаты проверки. Полный порядок описан в маршруте.

Вопрос, ответ и действие после ответа связываются с задачей и актуальной ревизией. Напоминание не создаёт нового вопроса и не обнуляет ожидание. Молчание и квитанция не разрешают зависимое действие. При противоречии отвечает назначенный владелец решения. Предел доработок, ранний разбор и фактическая передача человеку задаются регламентом.

Подключение и проверка

На Подготовке согласовать выбранный способ запуска и полномочия, роли PoC и Пилота, каналы и точки HITL. На PoC проверить их фактическое исполнение по общему гайду процессов. На Пилоте продуктовую работу ведёт команда; инженер сопровождает платформу и помогает при сбоях. Инструкции и уведомления должны отражать актуальный маршрут.

Маршрут подключается агенту как навык и/или заметка с версией и источником. Изменения процесса и маршрута проверяются в затронутой области. Данные для мониторинга связываются с этими правилами в плане мониторинга, а соответствие событий источникам реализуется в навыке сбора.