Коннектор

Yandex Cloud: ИИ-агент для учёта ресурсов

Сервиса нет в каталоге. Подключение по описанию API.

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

Что такое агент

Агент — программа, которая делает дело целиком. Не объясняет, как создать машину, а обходит каталог и приносит список расхождений с учётом.

Три признака. Работает в ваших сервисах: в облаке и в таблице учёта. Доводит до результата: сверка сделана, список правок готов. Работает без вас — по расписанию.

Чат-бот объяснит, где кнопка. Агент вернётся таблицей: какой диск висит без машины и у какого ресурса нет владельца.

Что такое коннектор

Коннектор описывает подключение к облаку: где взять доступ, что видно, как проверить связь. Доступ выдаётся сервисному аккаунту: он получает роли, а запросы идут с IAM-токеном или с API-ключом этого аккаунта.

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

Что это за сервис

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

Для запросов важен каталог: идентификатор каталога передаётся в заголовке, и от него зависит, к каким ресурсам обращается агент. У сервисов есть консоль управления, API и описания в документации, поэтому читать состояние проекта можно без ручных выгрузок. Документация сервиса сверена по официальному зеркалу yandex-cloud.

Что делает агент с Yandex Cloud

### Своя система по API: чтение и запись

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

### Пересчёт чужой таблицы: найти ошибку

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

### Индексация и техошибки: список правок

Агент собирает технические замечания: ресурсы без меток, сервисные аккаунты без ограничения прав, каталоги без бюджета. На выходе — список правок по приоритету, чтобы администратор шёл от риска к мелочи.

Что остаётся человеку

Решение об удалении ресурса и о выдаче роли принимает администратор. Он же подтверждает запись через API и разбирает спорный случай с владельцем проекта.

Как подключить

В консоли управления создайте сервисный аккаунт в нужном каталоге и выдайте ему роли только на чтение тех сервисов, которые нужны. Затем выпустите для него API-ключ или получите IAM-токен и передайте агенту вместе с идентификатором каталога. Проверка связи — чтение списка машин: пустой список тоже ответ, значит доступ работает.

Чего агент не делает

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

Вопросы

Что такое агент, если коротко? Программа, которая доводит дело до результата: обходит каталог по API, сверяет ресурсы с учётом и приносит список правок.

Что такое коннектор? Описание подключения: сервисный аккаунт с ролями, его ключ и идентификатор каталога. Пароль администратора агент не хранит.

Зачем нужен идентификатор каталога? Он определяет границы: к каким ресурсам агент обращается. Без него запрос не найдёт нужный проект.

Подключение

  1. Шаг 1: войдите в консоль управления Yandex Cloud и выберите каталог, в котором будет работать агент.
  2. Шаг 2: создайте сервисный аккаунт и выдайте ему роли только на чтение нужных сервисов, затем выпустите API-ключ или получите IAM-токен.
  3. Шаг 3: передайте агенту ключ и идентификатор каталога, проверьте связь чтением списка виртуальных машин.

Роли

Сценарии