Находите нужный дашборд и датасет DataLens из чата

Агент ходит в api.datalens.tech и обходит кабинет через RPC-ручки: листает директорию коллекций и воркбуков постранично, спускается внутрь и собирает дашборды, чарты, датасеты и подключения к источникам. Дальше он выстраивает связи между объектами — какой чарт на каком датасете, какой датасет на каком подключении, — находит дубли одного отчёта и подсказывает, где лежит нужный.

Главное про DataLens агент понимает сразу: API отдаёт устройство отчёта, а не его содержимое. Из дашборда приходит конфигурация, из датасета — поля, источники и настройки, но строк данных в ответе нет. Поэтому на вопрос про цифры агент не пересказывает дашборд по памяти, а идёт за ними в исходную систему и говорит, что сам DataLens числа через API не отдаёт.

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

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