query-listener — субагент для Claude Code: перехват DAX-запросов
Субагент query-listener для Claude Code подключается к локальному Analysis Services и перехватывает DAX-запросы, которые генерируют визуалы Power BI Desktop. Запускается, когда нужно понять, что уходит в модель при клике по визуалу.
GPL-3.0 ★ 1 104 обновлён 2026-10-28
.github/agents/query-listener.agent.mdЧто делает query-listener
Субагент работает с Power BI Desktop через ADOMD.NET: находит порт локального экземпляра Analysis Services по командной строке процесса msmdsrv, подключается к нему и опрашивает DISCOVER_SESSIONS каждые 500 мс до 60 секунд. Ловятся сессии, где SESSION_LAST_COMMAND начинается с DEFINE, EVALUATE или VAR. Повторы отсекаются по метке времени сессии, XMLA- и схемные команды отбрасываются сразу.
По каждому запросу видно время выполнения в миллисекундах и CPU time, плюс полный текст DAX. После остановки субагент подводит итог: сколько запросов поймано, какой оказался самым долгим, есть ли заметные проблемы вроде потерянного контекста фильтра или крупного TOPN. Найденное складывается в текстовый файл, чтобы не пропало после завершения агента.
Инструменты у субагента ограничены Bash, Read и Write. Нужен установленный ADOMD.NET: если сборки нет, установщик предложит сначала пройти шаги из скилла connect-pbid. В первые 15 секунд запросы часто не появляются, потому что срез через слайсер не всегда порождает обращение к модели — клик по обычному визуалу надёжнее.
Какие задачи решает
- увидеть точный DAX, который отправляет конкретный визуал
- замерить время выполнения запроса визуала
- разобраться, почему матрица или график тормозит
- сравнить запросы нескольких визуалов между собой
- сохранить пойманные запросы в файл для разбора
Примеры запросов агенту
- Перехвати DAX-запрос, который отправляет моя столбчатая диаграмма
- Слушай запросы визуалов, я сейчас покликаю по отчёту
- Поймай запрос медленной матрицы вместе со временем выполнения
Как установить query-listener
Вручную: положить файлы
.github/agents/query-listener.agent.md1Через маркетплейс плагинов
/plugin marketplace add data-goblin/power-bi-agentic-development/plugin install pbi-desktop@power-bi-agentic-development2Вручную: положить файлы
.claude/agents/query-listener.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code
Вручную: положить файлы
.codex/agents/query-listener.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/query-listener.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о query-listener
Как установить query-listener в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add data-goblin/power-bi-agentic-development, затем установите плагин: /plugin install pbi-desktop@power-bi-agentic-development. После этого субагент доступен как .claude/agents/query-listener.md.
Что делает query-listener?
Подключается к локальному Analysis Services, который поднимает Power BI Desktop, и в реальном времени вылавливает DAX-запросы визуалов. Каждый запрос отдаёт вместе со временем выполнения и CPU time.
Что нужно для работы query-listener?
Установленный ADOMD.NET — без него подключение к экземпляру Analysis Services не соберётся. Сборка загружается из локального пути, а если её нет, субагент отсылает к скиллу connect-pbid.