PDM

ИИ-агенты ​

PDM можно подключить к ИИ-помощнику — например, к Claude Code или другому приложению, которое умеет работать с внешними инструментами. После подключения помощник получает доступ к данным PDM и может сам отвечать на вопросы о стендах, настройках, релизах и сборках, а при необходимости — выполнять операции.

Такое подключённое приложение мы дальше называем агентом. Работает оно не «само по себе»: агент обращается к PDM от вашего имени и строго в пределах ваших прав.

Зачем это нужно ​

Обычно, чтобы ответить на вопрос вида «а где у нас уже стоит новая версия сервиса», приходится открывать несколько стендов подряд и сравнивать значения глазами. Агент делает это за вас: он обходит нужные данные сам и отвечает одной фразой.

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

Примеры запросов ​

Запрос формулируется обычными словами — специального синтаксиса нет:

  • «На каких стендах выложена версия 1.42 сервиса api3?»
  • «Покажи, чем отличаются настройки стенда prj-demo1 и prj-demo2.»
  • «Какие стенды сейчас недоступны и как давно?»
  • «Что вошло в последний релиз и на сколько стендов он раскатан?»
  • «Найди все стенды, где для этого параметра задано переопределение.»
  • «Собери ветку feature/login для сервиса ui2.»

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

Границы: что агенту доступно, а что нет ​

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

Из этого следует неочевидное: пустой ответ агента не всегда означает «данных нет». Иногда это означает «нет прав». Если ответ выглядит подозрительно пустым, проверьте, видите ли вы то же самое в интерфейсе PDM.

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

Данные отражают последнюю синхронизацию

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

Операции, которые что-то меняют ​

Агент может обновить конфигурацию стенда, запустить действие приложения или сборку, создать релиз.

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

Изменения доходят до реальных окружений

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

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

Длительные операции и «команда отправлена» ​

Долгие операции в PDM выполняются в фоне: запрос отрабатывает сразу, а сама работа идёт дальше шагами. В интерфейсе прогресс приходит сам собой, а вот агент живой поток событий не получает — чтобы узнать результат, он должен перезапросить состояние операции.

Практический вывод: ответ агента «команда отправлена» означает именно это, а не «деплой завершён». Попросите его проверить состояние через какое-то время или посмотрите страницу обработки сами.

Ответственность и отзыв доступа ​

Всё, что сделает агент, будет числиться за вашей учётной записью. Поэтому:

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

Подключённое приложение занимает отдельную сессию с пометкой «Агент»; её завершение немедленно лишает агента доступа — см. Активные сессии.

Что дальше ​