Пример: работа с агентами
Вымышленный проект «Обращения». Названия статусов, участников и сроки показывают способ заполнения маршрута, а не обязательный процесс клиента. Все решения и подтверждения в рабочем документе должны иметь реальные ссылки.
Область
Агент меняет форму обращения и связанные API/тесты. На PoC ИИ-инженер Павел подбирает задачи с командой и ведёт их выполнение с агентом. С начала Пилота задачи готовит, запускает и ведёт аналитик Мария, MR напрямую проверяют Алексей и Борис. Павел и Ирина выполняют роль ИИ-инженера: поддерживают платформу, диагностируют сбои, улучшают навыки. Павел постепенно передаёт Ирине эту инженерную работу; факты отражаются в журнале. Продуктовые решения принимает Ольга, аналитику ведёт Мария, код проверяет Алексей, тесты и поведение — Борис. В этом примере измерение заканчивается после приёмки и merge в main.
В трекере используются статусы из процесса задач. Отдельного статуса «Ожидает человека» нет: используются поля «Причина ожидания», «Адресат», «Запрос» и «Продолжить с шага».
Запуск задачи
В примере разрешены два способа. Мария пишет в канале проекта «APP-42 можно брать в работу» со ссылкой на согласованные требования либо переводит готовую задачу из «Бэклог» в «Готово к выполнению». Для второго способа агент выбирает проект APP, этот статус и назначение agent-project. Перевести может Мария; простое назначение без статуса запуском не считается.
Перед выполнением проверяются постановка и отсутствие уже принятого запуска APP-42. Чат и трекер связываются с одним делом; повторное поручение не создаёт вторую работу. Приняв задачу, агент подтверждает приём и переводит её в «В работе» по разрешению маршрута. Продуктовая статусная модель — в примере процесса задач, правила MR — в Git-примере.
Переходы
| Событие | Что делает агент | Человек / подтверждение | Статус и поля |
|---|---|---|---|
| Готовая задача допущена чатом или статусом | Проверяет входы, принимает один запуск | На PoC Павел, на Пилоте Мария поручают работу выбранным способом | «В работе», связаны задача и запуск |
| Обнаружены два варианта бизнес-правила | Пишет Марии вопрос с вариантами, останавливает зависимую реализацию | Мария даёт ответ в пределах своих полномочий либо запрашивает Ольгу | «В работе», причина «Предметный вопрос», адресат и ссылка |
| Получен ответ | Сохраняет ссылку на решение, обновляет постановку/спецификацию при необходимости, продолжает зависимую работу | Решение Марии/Ольги записано в задаче | Поля ожидания очищены с сохранением истории, старт не меняется |
| Код и проверки готовы | Открывает MR, прикладывает результат и доказательства | На PoC сначала Павел, затем Алексей и Борис; на Пилоте сразу Алексей и Борис | «На проверке», ссылка на MR и запросы ревью |
| Есть замечание | Исправляет, повторяет затронутые проверки, отвечает по существу | Автор замечания или назначенный ревьюер проверяет исправление | «В работе» на исправлении, затем «На проверке» |
| Продуктовая проверка успешна, ревью выполнено | Подготавливает комплект к интеграции | Борис фиксирует проверки, Ольга — приёмку, Алексей выполняет merge | До merge — «На проверке» |
| Фактический merge подтверждён | Связывает commit, MR и задачу | В этом примере агенту разрешено обновить статус по выполненным условиям | «Готово»; исход S |
| Доработка не даёт прогресса | Запрашивает решение, готовит контекст передачи | Мария и Алексей фиксируют передачу; Алексей принимает выполнение. При технической проблеме Ирина помогает с диагностикой | «В работе», исполнитель Алексей, режим «Человек»; исход H |
| Задача больше не нужна | Сохраняет причину решения и состояние изменений | Ольга подтверждает отмену | «Отменено»; исход C |
Передача не закрывает продуктовую задачу. Если к отсечке когорты нет решения, принятой передачи или отмены, отчёт фиксирует P; в трекере задача продолжает отображать фактическую работу.
HITL на предметном вопросе
Запрос агента: «В задаче APP-42 требуется ограничить длину обращения. В постановке указано 500 символов, в действующей спецификации — 1000. Какое правило действует? Реализация проверки длины приостановлена; независимую настройку сообщения об ошибке пока не изменяю, поскольку текст зависит от лимита».
Мария в этом примере отвечает в течение четырёх рабочих часов; при отсутствии ответа запрос эскалируется Ольге. Напоминание не сбрасывает начало ожидания. Ответ «посмотрю позже» не разрешает выбрать лимит.
Ольга подтверждает 1000 символов. Мария обновляет постановку со ссылкой на решение. Агент фиксирует ответ, продолжает реализацию и добавляет проверки границы. В журнале PoC сохраняются запрос, решение, изменение поля ожидания и результат возобновления.
Границы доработки и связь с Git
После двух циклов замечаний проводится разбор с человеком до следующего запуска; при повторении одной ошибки — раньше. Новое пожелание о вложениях оформляется следующей самостоятельной задачей, а не бесконечным расширением APP-42.
Правила ветки, MR, approvals и merge — в Git-примере. Статус «На проверке» сам по себе не разрешает merge. Если обновление трекера не удалось, агент сообщает об ошибке Ирине и не утверждает, что переход выполнен.