Онбординг агентов: навыки и заметки
Гайд · Пример · Все формы Подготовки.
Проект: … · Область: … · Версия/дата: … · Заполняет: …
Онбординг выполняется на неделе 1 PoC по процедуре, включая промпт адаптации и минимальный проход. До PoC заполняются условия и источники ниже; адаптированные агенты, промпты, навыки и заметки становятся результатом недели 1.
Условия и источники онбординга
| Что зафиксировать | Ссылка / версия / подтверждение |
|---|---|
| Платформа или проект в облаке поставщика | Адрес, ответственный, результат проверочного запуска агента и доступ к журналам |
| Рабочее место ИИ-инженера | Локальный агент с подключением к платформе / рабочее место на платформе; аккаунт и проверенные операции |
| Доступы инженера и интеграции платформы | Отдельные результаты проверок из обоих контуров; ссылки на реестры Git, систем и чата, оркестратора и моделей |
| Hub дистрибутивной методологии | URL и версия промптов демо-проектов и универсальных навыков |
| Git материалов внедрения | URL, ревизия, индекс материалов по продукту и процессам |
| Литература проекта | URL репозитория, базовая ветка, права на MR, способ подключения выбранной версии к платформе |
| Участники и ответы по развилкам | ИИ-инженер сопровождения, ИИ-инженер клиента, эксперты и владельцы решений; канал рабочих вопросов |
| Задача минимального прохода | Ссылка, критерии результата, feature-ветка, DEV и способ проверки; включение в план недели 1 |
| Остаток готовности | Что отсутствует, исполнитель, срок и зависимый шаг |
Для выбранных задач агент получает практические инструкции: где брать контекст, как выполнять действия и как проверять результат. Начальный комплект агентов и инструкций формируется адаптацией каталог исходных материалов в MR литературы; навыки и/или заметки, сформированные в диалоге, сохраняются в проекте. Создавать одновременно два одинаковых комплекта не требуется.
Результат диалога сохраняется в доступном агенту источнике и используется в последующих задачах. Переписка, оставшаяся только в контексте одной сессии без способа повторного использования, не подтверждает онбординг.
| Навык / заметка | Назначение и применимые задачи | Где хранится / версия | Источники правил и решений | Как платформе находит или подключает материал | Владелец и проверивший содержание |
|---|---|---|---|---|---|
| … | … | Ссылка | Документы, решения команды, проверенные команды | Условие применения, путь поиска или настройка подключения | Имена и дата |
Процессы, работа с агентами и проектные практики
| Область | Что описывают навыки / заметки | Шаблон и пример |
|---|---|---|
| Процесс задач | Статусы трекера, поля, переходы, ответственность и условия завершения | Шаблон · Пример |
| Работа с агентами и HITL | Допуск через чат/статус, полномочия, вопросы и ответы, ожидание, возобновление и передача | Маршрут · Пример |
| Git-процесс и ревью | Базовые и рабочие ветки, MR, ревью кода и тестов, замечания, повторная проверка, полномочия и условия merge | Шаблон · Пример |
| Проектные практики | Устройство продукта, правила кода, источники требований, сборка, тестирование, миграции, деплой, данные и диагностика | Форма заметки и действующие инструкции проекта |
Для каждой области в реестре выше указываются конкретные материалы, версии и способ применения агентом. Один навык может охватывать несколько областей, несколько навыков — одну; смысловые границы должны быть видны независимо от количества файлов. «Проектные практики» — название для остальных прикладных инструкций, без смешения с правилами движения задачи и MR.
Для каждого применимого направления нужен материал либо ссылка на уже пригодный источник с инструкцией его использования. К завершению онбординга достаточно комплекта для минимального прохода; остальные материалы дополняются на простых и целевых задачах. Секреты в навыки и заметки не включаются.
Форма заметки
- Название и ситуации применения: …
- Что агент должен сделать и в какой последовательности: …
- Где взять актуальные данные и правила: …
- Команды / инструменты / доступы: … (без секретов).
- Ожидаемый результат и способ проверки: …
- Ограничения, вопросы человеку и порядок помощи: …
- Источник решения, версия, владелец и дата проверки: …
Подтверждение онбординга
Журнал хода адаптации и проверок: … . Агент ведёт его в свободной форме по описанию и шаблону.
| Материал / версия | Проверка в контексте новой задачи | Ожидаемое действие агента | Фактический результат и доказательство | Кто проверил / дата / остаток |
|---|---|---|---|---|
| … | Какой пример и как предоставлен доступ | Найти и прочитать нужную инструкцию без повторного пересказа человеком | Ссылка на проверку | … |
Перед PoC проверяются платформа, рабочее место, источники и доступы. На неделе 1 фиксируются MR литературы, подключённая ревизия, результаты пробных вызовов агентов и минимального набора, включая FLOW-07 и итоговый FLOW-11. MR литературы: …; MR кода пробной задачи: …; результат, проверивший и дата: … . На неделях 2–4 материалы совершенствуются; перед Пилотом фиксируются проверенные версии для целевого потока.