Как организовать внедрение ИИ в разработку ПО

Документ описывает, как начать внедрение, организовать работу участников и вести её по методологии. Этапы, результаты и условия перехода между ними определены в процессе внедрения.

Термины «агент», «платформа» и «производство ПО» используются в значениях словаря методологии.

Порядок внедрения

Общий порядок

Сначала на предприятии проводится проверка применимости: реальные задачи, ограниченный ресурс и решение о целесообразности внедрения. Она не требует паспорта, офиса и комплекта документов программы.

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

В каждой подключаемой команде внедрение проходит три этапа: Подготовка → PoC → Пилот. На Подготовке создаются условия для первых задач. В ходе PoC ИИ-инженер адаптирует агентов к продукту и рабочим процессам, проверяет их возможности и готовит команду. На Пилоте участники продуктовой команды работают с агентом при инженерном сопровождении, измеряют эффект и постепенно повышают автономность агентов.

Для планирования и отслеживания прогресса используется Git-репозиторий внедрения. В нём хранятся сведения о проекте, план работ, принятые решения, журналы и подтверждения результатов. Поэтому при переходе к организованному внедрению нужно определить, где будет размещён этот репозиторий и кто получит к нему доступ. Можно создать отдельный репозиторий либо выделить раздел в существующем.

Методология задаёт правила работы и предоставляет шаблоны. Рабочие документы конкретного внедрения создаются на её основе и заполняются по мере выполнения работ. Существующие документы организации можно использовать по ссылкам, не создавая дубликатов.

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

Способ подключения агента зависит от доступной инфраструктуры:

Если экземпляр платформы и подходящий инференс уже доступны, агента внедрения можно создать на платформе.
Если платформа и инференс ещё разворачиваются, для начала работы рекомендуется использовать персонального агента с допустимым для организации инференсом.
Если предоставить такой инференс невозможно, участники ведут внедрение вручную по этой методологии.

Инференс — сервис выполнения запросов к языковой модели. Инференс персонального агента внедрения может отличаться от того, который впоследствии будут использовать агенты.

Следующий порядок относится к организованному внедрению в команду; он не является комплектом обязательных действий для предварительного исследования. Независимо от способа ведения работы нужно:

Определить продукт, цели внедрения и участников.
Подготовить репозиторий и создать стартовый комплект документов.
Выбрать вариант размещения платформы, инференс и системы, необходимые для первых задач.
Выполнить Подготовку и подтвердить готовность к PoC.
Пройти PoC, проверить выбранный поток задач и подготовить команду к Пилоту.
Провести Пилот, оценить результаты и принять решение о дальнейшей работе.

Ведение внедрения с агентом

Агенту нужны доступ к методологии и рабочим документам, возможность читать и изменять файлы, работать с Git и обсуждать вопросы с участниками. В зависимости от принятого в организации инструментария можно использовать jcode, opencode, pi, Claude Code, Codex или другой агент с необходимыми возможностями.

Качество работы зависит от выбранной модели. Она должна уверенно работать с объёмными документами, выполнять инструкции, пользоваться инструментами и сохранять согласованность изменений. При выборе инференса стоит проверить эти способности на первых задачах внедрения: изучении методологии, подготовке плана и обновлении документов по результатам диалога.

Начало работы

Подготовьте Git. Выберите существующий Git-сервер или установите новый, создайте репозиторий внедрения. Создайте или выберите учётную запись для агента и предоставьте необходимые права.
Предоставьте методологию. Передайте агенту архив, доступную ссылку или локальную папку. Рекомендуемый способ — разместить зафиксированную версию методологии в Git, используемом для внедрения. Исходную методологию и заполненные документы проекта нужно различать; версия методологии должна быть записана.
Настройте доступ. Укажите агенту адрес репозитория, рабочую ветку и расположение документов. Подключите токен через предусмотренный вашим инструментом механизм доступа. Токены и пароли не сохраняются в документах внедрения и Git.
Поручите начать внедрение. Например:

Давай приступим к внедрению ИИ в разработку ПО. Изучи методологию и имеющиеся материалы проекта. Определи, что уже известно, какие решения нужно принять и какие работы можно начать. Задавай вопросы по одному, сохраняй ответы и договорённости в репозитории внедрения. Подготовь начальный план и предложи ближайшие действия.

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

Подробный порядок подготовки репозитория приведён в отдельном гайде.

Работа в ходе внедрения

Обращайтесь к агенту по мере выполнения работ: попросите определить ближайшие действия, помочь заполнить документ, записать решение, обновить план или подготовить сводку к встрече.

Агент использует доступные сведения из Git, трекера, чатов и других подключённых систем. Если сведений недостаточно, он запрашивает их у участников. Выполненные работы отмечаются по подтверждённым результатам; неизвестные обстоятельства остаются открытыми вопросами.

Сначала агент работает по запросам участников. После проверки качества его работы можно настроить обновления по событиям и расписанию: сбор фактов, подготовку к встречам, недельные сводки. Для каждой такой функции определяются источники, допустимые действия и порядок проверки результата.

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

Ведение внедрения без агента внедрения

В этом варианте планирование и ведение документов выполняют участники внедрения. Использование агентов для разработки продукта остаётся целью проекта.

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

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

Варианты внедрения

Внедрение on-prem

При внедрении on-prem новый экземпляр платформы разворачивается в инфраструктуре организации.

Размещение платформы и размещение инференса выбираются отдельно. Для платформы можно использовать доступный организации сервис моделей либо развернуть собственный. Подготовка GPU-инфраструктуры требуется, если выбран собственный инференс и необходимых ресурсов ещё нет.

Работа начинается с организационной Подготовки: определения целей, участников, Git внедрения и первых задач. Эти действия можно выполнять параллельно с подготовкой инфраструктуры, используя персонального агента внедрения или ведя документы вручную.

Далее необходимо:

Определить размещение платформы, доступные ресурсы и требования к её эксплуатации.
Выбрать инференс и подготовить его подключение; при необходимости развернуть сервис моделей.
Установить платформу по документации выбранной версии и проверить её работу.
Подключить проектные системы: Git, трекер, чаты, средства сборки и тестовые среды, необходимые для первых задач.
Подготовить материалы продукта, рабочее место ИИ-инженера и первую задачу.
Подтвердить готовность к PoC и перейти к адаптации агентов и проверке рабочего процесса.

Установка платформы — часть Подготовки. Результат внедрения оценивается по работе агентов с задачами продукта и достигнутому эффекту.

Подробности: развёртывание платформы, развёртывание моделей, выбор инфраструктуры PoC.

Внедрение на облачной платформе или подключение нового проекта

Этот вариант применяется, когда платформа уже работает: в облаке поставщика либо в инфраструктуре организации. Для нового продукта создаётся и настраивается проект на существующем экземпляре.

Развёртывание самой платформы в работы проекта не включается. При этом нужно проверить, доступны ли новому проекту необходимые модели, ресурсы и подключения.

Порядок действий:

Определить экземпляр платформы, создать или выбрать проект и назначить участников.
Подготовить Git внедрения. При наличии необходимых доступов создать агента внедрения на платформе.
Выбрать доступный проекту инференс и проверить его работу.
Настроить доступ к репозиториям продукта, трекеру, чатам и тестовым средам. Если системы находятся в разных контурах, обеспечить и проверить связь между ними.
Предоставить материалы продукта, определить рабочий процесс и подготовить первую задачу.
Подтвердить готовность к PoC, адаптировать агентов к новому продукту и проверить выполнение задач.

Наличие работающего экземпляра платформы сокращает инфраструктурную подготовку, но для каждого нового продукта нужно настроить знания, навыки, подключения и взаимодействие с командой.

Для PoC можно использовать целевые системы либо согласованную временную инфраструктуру. Выбранные условия и ограничения результатов фиксируются в документах внедрения. При смене инфраструктуры перед Пилотом повторно проверяются затронутые подключения и рабочие сценарии.

Подробности — в гайде выбора размещения и инфраструктуры PoC.