Навык 30 из 39
HS-DEV-007-AGENTСоздание ограниченного AI-агента для проверенного процесса
Превратить проверенный вручную повторяемый процесс в одного специализированного AI-агента: определить его цель, входы, выходы, границы роли и условия отказа; задать минимальные инструкции, инструменты, данные, состояние и права; встроить запрос уточнения, human gates, эскалацию и безопасную остановку; затем независимо проверить поведение на обычных, неоднозначных, запрещённых и аварийных сценариях.
Результатом является не персона, длинный system prompt или запущенная сессия, а воспроизводимая конфигурация агента с наблюдаемым контрактом и evidence пригодности в заявленной области. Агент владеет ограниченной целью, циклом выполнения, состоянием, контуром инструментов и permissions, условиями handoff и остановки; он может вызывать готовые AI skills. AI skill, напротив, исполняет ограниченную процедуру внутри host-агента и не получает собственной цели, автономного цикла, состояния или прав. HS-DEV-002-ORCH отвечает за координацию нескольких уже доступных агентов; эта карточка — за создание и проверку одного агента.
Тренажёр навыка
Понять.
Сделать.
Подтвердить.
Что нужно уметь
Превратить проверенный вручную повторяемый процесс в одного специализированного AI-агента: определить его цель, входы, выходы, границы роли и условия отказа; задать минимальные инструкции, инструменты, данные, состояние и права; встроить запрос уточнения, human gates, эскалацию и безопасную остановку; затем независимо проверить поведение на обычных, неоднозначных, запрещённых и аварийных сценариях.
Результатом является не персона, длинный system prompt или запущенная сессия, а воспроизводимая конфигурация агента с наблюдаемым контрактом и evidence пригодности в заявленной области. Агент владеет ограниченной целью, циклом выполнения, состоянием, контуром инструментов и permissions, условиями handoff и остановки; он может вызывать готовые AI skills. AI skill, напротив, исполняет ограниченную процедуру внутри host-агента и не получает собственной цели, автономного цикла, состояния или прав. HS-DEV-002-ORCH отвечает за координацию нескольких уже доступных агентов; эта карточка — за создание и проверку одного агента.
Как закрепить
Выбрать процесс, по которому уже есть несколько ручных прогонов и решение о готовности к ограниченной автоматизации. Зафиксировать baseline выполнения с обычным AI-помощником, описать контракт специализированного агента и собрать первую версию в выбранной среде. Выдать только необходимые инструменты и синтетические данные, подготовить набор положительных и отрицательных сценариев, провести минимум одну итерацию по результатам evals и проверить сброс состояния, остановку и передачу человеку.
Как проверить перенос
За 90 минут получить новый изолированный fixture с принятым readiness-решением и границами ручного процесса, примерами входов, разрешёнными инструментами и agent runtime, но без готовых инструкций агента. Самостоятельно проследить эти границы в контракт и конфигурацию агента и передать её на независимый набор проверок. Набор содержит обычную задачу, недостаточные входные данные, запрос вне области роли, попытку получить лишнее действие или доступ, сбой инструмента и случай, где требуется human gate. Участник должен обнаружить существенный провал первой версии, внести ограниченное исправление и повторно проверить затронутые сценарии.
Результат, а не ощущение
Evidence
освоения
- прослеживаемость от предоставленного readiness-решения и границ ручного процесса к контракту агента;
- версия контракта агента: цель, входы, выходы, границы роли и условия остановки;
- воспроизводимая конфигурация инструкций, инструментов, данных, состояния и permissions;
- парные прогоны обычного AI-помощника и созданного агента на одном новом входе с разбором наблюдаемого delta;
- карта «сценарий → ожидаемое поведение → фактический результат» для обычных и отрицательных случаев;
- логи независимых прогонов, включая уточнение, отказ, human gate, сбой инструмента и безопасную остановку;
- diff между первой и исправленной конфигурацией и повторная проверка без существенной регрессии;
- инструкция запуска, сброса состояния, отключения и возврата к ручному процессу;
- явное решение о границах, в которых агент готов, не готов или требует наблюдения человека.
Антипаттерны
Типовые ошибки
- объявление агентом любого system prompt, чата или персонажа без проверяемого контракта;
- автоматизация процесса, который ещё не воспроизводится вручную;
- широкая цель вида «помогай со всем» без условий отказа и эскалации;
- выдача максимальных инструментов и доступов «на будущее»;
- проверка только счастливого сценария на знакомом примере;
- смешение инструкций, секретов и изменяемых рабочих данных в одной конфигурации;
- неограниченная память без правил записи, чтения и сброса;
- принятие самоотчёта агента вместо независимых evals;
- исправление провала расширением полномочий без анализа причины;
- отсутствие human gate, безопасного отключения или возврата к ручному процессу.