Находите нужный дашборд и датасет DataLens из чата
Подключите Яндекс DataLens к ИИ-агенту: коллекции, воркбуки, дашборды, датасеты и подключения. Агент найдёт нужный отчёт и покажет, что уже построено.
Как агент работает с Яндекс DataLens
Агент ходит в api.datalens.tech и обходит кабинет через RPC-ручки: листает директорию коллекций и воркбуков постранично, спускается внутрь и собирает дашборды, чарты, датасеты и подключения к источникам. Дальше он выстраивает связи между объектами (какой чарт на каком датасете, какой датасет на каком подключении), находит дубли одного отчёта и подсказывает, где лежит нужный.
Агент читает конфигурацию отчётов и получает строки датасетов через экспериментальный getDatasetData API v3. Для запроса нужны GUID полей; при выгрузке частями агент учитывает сортировку и сообщает о неполном результате.
API поддерживает создание, изменение и удаление объектов, доступы и экспорт/импорт воркбуков. Агент выполняет изменения по запросу пользователя в рамках выданных прав и проверяет результат. Перенос воркбука между коллекциями идёт экспортом и импортом: агент дожидается готовности файла.
Подключение идёт по авторизованному ключу сервисного аккаунта Yandex Cloud: организацию DataLens подключение находит по ключу само, а IAM-токен агент обновляет без участия человека. Обход кабинета идёт постранично, и на большой организации агент забирает директорию частями, складывая связи объектов по мере спуска, а не одним запросом. Частоту он держит в пределах лимита, а пустой результат называет прямо и отличает «отчётов нет» от «отчёты не видны», а не выдаёт одно за другое.
Сценарии интеграции
Навигация по коллекциям и воркбукам
Агент обойдёт коллекции и воркбуки организации и подскажет, где лежит нужный дашборд, датасет или подключение к источнику.
Инвентаризация отчётов
Агент соберёт список дашбордов, чартов и датасетов, найдёт дубли одного и того же отчёта и покажет связи между объектами.
Аудит доступов и изменений
Агент покажет права на объекты, проверит доступ конкретного пользователя и поднимет историю изменений начиная с нужной даты.
Перенос воркбука между коллекциями
Агент запустит экспорт воркбука, дождётся готовности файла и импортирует его в другую коллекцию той же организации.
Лицензии и embed-ссылки
Агент поднимет лицензии организации и embed-ссылки объектов и покажет, какие отчёты выведены наружу и на что хватает текущего тарифа.
Из чего собран датасет
Агент раскроет поля датасета, его источники и настройки: видно, какие срезы вообще есть, а за самими цифрами он пойдёт в исходную систему.
Примеры: Яндекс DataLens
В коллекции «Финансы», воркбук «Отчётность 2026», и у него есть близнец.
Обошёл 6 коллекций и 23 воркбука: второй такой же дашборд лежит в «Архиве» и тянет тот же датасет. Доступ к обоим только у пяти человек из отдела.
Как подключить
Перед подключением
- Сервисный аккаунт Yandex Cloud с ролью в DataLens нужной организации.
- Доступ сервисного аккаунта к коллекциям и воркбукам уровня viewer.
- Права администратора DataLens у того, кто выдаёт роль.
- 1
В IAM создайте сервисный аккаунт
Консоль Yandex Cloud → «Identity and Access Management» → «Создать сервисный аккаунт» в облаке той организации, где работает DataLens.
- 2
В организации выдайте ему роль DataLens
Cloud Center → «Права доступа» организации → «Назначить права» → сервисный аккаунт: datalens.admin для полного доступа или datalens.visitor для входа.
- 3
На коллекциях назначьте роль viewer
Роль на организацию содержимого не открывает: на каждой коллекции и воркбуке назначьте аккаунту datalens.collections.viewer и datalens.workbooks.viewer.
- 4
В карточке аккаунта скачайте JSON-ключ
«Создать новый ключ» → «Создать авторизованный ключ» → «Скачать файл с ключами» и вставьте JSON целиком: организацию подключение найдёт само.
Частые вопросы
Ключом сервисного аккаунта Yandex Cloud: вставьте JSON-файл авторизованного ключа целиком, организацию подключение найдёт само. Права в DataLens выдаются на организацию, поэтому аккаунту нужна роль в ней, а на коллекциях и воркбуках нужен доступ уровня viewer, иначе содержимое останется невидимым.
Структуру кабинета: коллекции, воркбуки, дашборды, чарты, датасеты и подключения, их связи и права, историю изменений, лицензии организации и embed-ссылки.
Да, через экспериментальный метод getDatasetData API v3, если источник и выданные права допускают чтение. Сама конфигурация дашборда чисел не содержит.
Агент может создавать, изменять и удалять объекты, работать с доступами и переносить воркбуки по запросу пользователя в рамках выданных прав.