Коннектор
Yandex Cloud: ИИ-агент для учёта ресурсов
Сервиса нет в каталоге. Подключение по описанию API.
Yandex Cloud — облачная платформа: виртуальные машины, хранилище, базы данных, сети и мониторинг в одном аккаунте. Агент ведёт хозяйственную часть: сверяет ресурсы с учётом, ищет расхождения и собирает список правок, а решения по инфраструктуре остаются за администратором.
Что такое агент
Агент — программа, которая делает дело целиком. Не объясняет, как создать машину, а обходит каталог и приносит список расхождений с учётом.
Три признака. Работает в ваших сервисах: в облаке и в таблице учёта. Доводит до результата: сверка сделана, список правок готов. Работает без вас — по расписанию.
Чат-бот объяснит, где кнопка. Агент вернётся таблицей: какой диск висит без машины и у какого ресурса нет владельца.
Что такое коннектор
Коннектор описывает подключение к облаку: где взять доступ, что видно, как проверить связь. Доступ выдаётся сервисному аккаунту: он получает роли, а запросы идут с IAM-токеном или с API-ключом этого аккаунта.
Это не плагин в консоли и не доработка проекта. Пароль администратора агент не хранит: у него свой сервисный аккаунт, и его права в любой момент отзываются.
Что это за сервис
Платформа собрана из отдельных сервисов, и каждый отвечает за свой участок: вычисления, объектное хранилище, управляемые базы данных, сети, балансировка нагрузки, очереди и обмен данными. Рядом стоят сервисы наблюдаемости — метрики, логи, аудит, — а также управление доступами и биллинг.
Для запросов важен каталог: идентификатор каталога передаётся в заголовке, и от него зависит, к каким ресурсам обращается агент. У сервисов есть консоль управления, API и описания в документации, поэтому читать состояние проекта можно без ручных выгрузок. Документация сервиса сверена по официальному зеркалу yandex-cloud.
Что делает агент с Yandex Cloud
### Своя система по API: чтение и запись
Агент читает состояние каталога — машины, диски, хранилища, сети — и складывает в свою таблицу. Запись он делает только в те сервисы, где сервисному аккаунту выдали роль, и только после подтверждения человеком.
### Пересчёт чужой таблицы: найти ошибку
Агент сверяет выгрузку из облака с таблицей учёта: ищет ресурсы без владельца, тома без снимков, хранилища без политики хранения. Каждое расхождение он показывает с идентификатором и предлагает правку, но не применяет её сам.
### Индексация и техошибки: список правок
Агент собирает технические замечания: ресурсы без меток, сервисные аккаунты без ограничения прав, каталоги без бюджета. На выходе — список правок по приоритету, чтобы администратор шёл от риска к мелочи.
Что остаётся человеку
Решение об удалении ресурса и о выдаче роли принимает администратор. Он же подтверждает запись через API и разбирает спорный случай с владельцем проекта.
Как подключить
В консоли управления создайте сервисный аккаунт в нужном каталоге и выдайте ему роли только на чтение тех сервисов, которые нужны. Затем выпустите для него API-ключ или получите IAM-токен и передайте агенту вместе с идентификатором каталога. Проверка связи — чтение списка машин: пустой список тоже ответ, значит доступ работает.
Чего агент не делает
Не удаляет ресурсы и не меняет роли. Не хранит секреты проекта. Не работает с сервисами, которые не включены в каталоге.
Вопросы
Что такое агент, если коротко? Программа, которая доводит дело до результата: обходит каталог по API, сверяет ресурсы с учётом и приносит список правок.
Что такое коннектор? Описание подключения: сервисный аккаунт с ролями, его ключ и идентификатор каталога. Пароль администратора агент не хранит.
Зачем нужен идентификатор каталога? Он определяет границы: к каким ресурсам агент обращается. Без него запрос не найдёт нужный проект.
Подключение
- Шаг 1: войдите в консоль управления Yandex Cloud и выберите каталог, в котором будет работать агент.
- Шаг 2: создайте сервисный аккаунт и выдайте ему роли только на чтение нужных сервисов, затем выпустите API-ключ или получите IAM-токен.
- Шаг 3: передайте агенту ключ и идентификатор каталога, проверьте связь чтением списка виртуальных машин.