Раздел «Главная» → «AI-инструменты» → «Приложения» объединяет приложения каталога с репозиториями GitLab. AI PDLC проводит изменение от постановки и согласования спецификации до реализации агентом, запроса на слияние (MR) и развёртывания выпуска.
Перед началом администратор должен настроить AI PDLC. Сохраните токен GitLab в учётных данных и подключите AI-провайдера.
Выбор приложения
Откройте приложение из списка. Поиск отбирает приложения по названию или идентификатору. В карточке приложения доступны изменения, выпуски и показатели, а блок «Готовность к AI PDLC» показывает репозиторий, ветку по умолчанию, согласующих, окружение выпуска и процесс развёртывания.
Кнопка «Открыть рабочее пространство» открывает ваше пространство для приложения или создаёт его из шаблона AI PDLC. Если у вас несколько AI-провайдеров, выберите один. Чат и IDE доступны владельцу пространства; согласование спецификации не предоставляет доступ к ним другим пользователям.
Новое приложение
Кнопка «Новое приложение» создаёт приложение через реестр шаблонов:
- Выберите шаблон и заполните параметры создания микросервиса.
- При необходимости задайте «Окружение выпуска». Без него приложение можно создать, но автоматическое развёртывание выпусков не начнётся.
- Нажмите «Продолжить» и дождитесь завершения процесса создания.
- На открывшейся странице приложения заполните диалог первого изменения.
Если создание завершается ошибкой, нажмите «Открыть прогон» и проверьте результат процесса. Если окружение выпуска не удалось записать, задайте связь в карточке приложения. Сообщение об отсутствии процесса развёртывания передайте администратору.
Новое изменение
Изменение начинается с постановки задачи:
- Откройте приложение и нажмите «Новое изменение».
- Укажите «Название» и «Постановка»: что требуется изменить и зачем.
- При запросе выберите LLM-провайдера и нажмите «Создать».
- Следите за шагами на странице изменения. Агент подготовит спецификацию в ветке GitLab и передаст её на согласование.
Пока изменение готовит спецификацию или реализацию, приложение занято: другое изменение можно начать после открытия MR или завершения текущего изменения. Страница сообщает название и автора изменения, которое удерживает приложение.
Спецификация хранится в репозитории по пути docs/changes/<идентификатор>.md. DDP проверяет наличие результата в GitLab: ответа агента в чате недостаточно для завершения шага.
Согласование спецификации
Согласующие задаются в параметре приложения «Согласующие спецификаций». Если список пуст, спецификацию согласует автор изменения. При нескольких адресатах достаточно решения одного из них.
Откройте изменение или раздел «Решения», прочитайте спецификацию и выберите действие:
| Действие | Результат |
|---|---|
| «Согласовать» | Агент начинает реализацию согласованной версии спецификации |
| «Вернуть на доработку» | Изменение возвращается автору; комментарий объясняет, что требуется исправить |
| «Доработать агентом» | Автор поручает агенту исправить возвращённую спецификацию |
| «Готово к согласованию» | Автор повторно передаёт текущую спецификацию согласующим |
Для ручной доработки измените спецификацию в рабочем пространстве, сохраните коммит в ветке GitLab и отправьте её на согласование. На странице показаны версия спецификации и SHA согласованного коммита.
Реализация и проверка
После согласования агент изменяет код, выполняет проверки проекта и открывает MR. На странице изменения появляются ссылка на MR и его состояние. Проверку и слияние выполняйте в GitLab; DDP отслеживает результат и переводит изменение в «Влито» или «MR закрыт».
При ошибке страница показывает незавершённый шаг и число попыток. Автор может открыть чат изменения, чтобы проверить ответ агента и результат работы.
Кнопка «Отменить изменение» останавливает процесс. Ветка и MR остаются в GitLab. Удаление доступно после завершения или отмены изменения и также не удаляет ветку и MR.
Выпуски
После слияния DDP собирает изменения приложения в выпуск и запускает настроенный процесс развёртывания. Для этого у приложения должно быть одно «Окружение выпуска», указанное связью в каталоге, и однозначно выбранный процесс развёртывания. Если настройки отсутствуют, изменение остаётся в состоянии «Влито», а страница показывает причину ожидания.
На вкладке «Выпуски» откройте выпуск, чтобы проверить его состав, окружение, версию, release notes и прогон развёртывания. Версия фиксирует SHA основной ветки на момент подготовки развёртывания. Release notes собираются из разделов What changes спецификаций вошедших изменений.
Состояния выпуска означают:
| Состояние | Значение |
|---|---|
| «Ожидает» | Выпуск собран и ожидает запуска; причина ожидания показана на странице |
| «Развёртывается» | Выполняется процесс развёртывания |
| «Развёрнут» | Процесс развёртывания завершился успешно |
| «Не удался» | Развёртывание завершилось ошибкой, было остановлено или его прогон удалён |
Одновременно развёртывается один выпуск приложения. Новые слияния во время развёртывания собираются в следующий выпуск. После неудачного выпуска его изменения войдут в следующий выпуск после нового слияния; автоматического повтора того же выпуска нет.
Статус «Развёрнут» отражает результат процесса. Поле «Образ в окружении» берётся из каталога и зависит от синхронизации данных развёртывания.
Показатели
Вкладка «Показатели» показывает изменения за 30, 90 или 365 дней по дате постановки. Здесь доступны число изменений по состояниям, возвраты на доработку, медианное время стадий и расход агента: токены, число ходов и время работы.
Для стадий учитываются изменения, у которых есть соответствующие отметки времени; рядом с медианой показано их число. На странице отдельного изменения блок «Стоимость и сроки» показывает данные этого изменения. Расход токенов не является денежной оценкой.