# query-listener

Субагент query-listener для Claude Code подключается к локальному Analysis Services и перехватывает DAX-запросы, которые генерируют визуалы Power BI Desktop. Запускается, когда нужно понять, что уходит в модель при клике по визуалу.

- субагент · `type=agent` · Claude Code, Codex, Cursor, GitHub Copilot · ★ 1104 у репозитория
- Автор: Kurt Buhler
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/data-goblin/power-bi-agentic-development/tree/HEAD/plugins/pbi-desktop/agents/query-listener.agent.md
- Обновлён: 2026-10-28
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/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 секунд запросы часто не появляются, потому что срез через слайсер не всегда порождает обращение к модели — клик по обычному визуалу надёжнее.

## Требования
- Работает с: Power BI

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/agents/query-listener.agent.md`

### Claude Code

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add data-goblin/power-bi-agentic-development
```
В чате агента (не в терминале):
```text
/plugin install pbi-desktop@power-bi-agentic-development
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/query-listener.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/query-listener.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/query-listener.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/data-goblin/power-bi-agentic-development/tree/HEAD/plugins/pbi-desktop/agents/query-listener.agent.md

## Когда брать
- увидеть точный DAX, который отправляет конкретный визуал
- замерить время выполнения запроса визуала
- разобраться, почему матрица или график тормозит
- сравнить запросы нескольких визуалов между собой
- сохранить пойманные запросы в файл для разбора

## Примеры запросов агенту
- Перехвати DAX-запрос, который отправляет моя столбчатая диаграмма
- Слушай запросы визуалов, я сейчас покликаю по отчёту
- Поймай запрос медленной матрицы вместе со временем выполнения

## Похожие
- [Power BI Performance Expert Mode](https://affpapa.org/nevibecode/agents/power-bi-performance-expert-mode.md) — субагент · ★ 41430 у репозитория
- [powerbi-modeling](https://affpapa.org/nevibecode/skills/powerbi-modeling.md) — скилл · 9934 установки
- [SemanticOps MCP (for Power BI)](https://affpapa.org/nevibecode/mcp/semanticops-mcp-for-power-bi.md) — MCP-сервер · ★ 256 у репозитория
- [power-bi-build](https://affpapa.org/nevibecode/skills/power-bi-build.md) — скилл · 688 установок
- [power-bi-salespulse-360-dashboard](https://affpapa.org/nevibecode/skills/power-bi-salespulse-360-dashboard.md) — скилл · 661 установка
- [power-bi-retail-analytics-salespulse360](https://affpapa.org/nevibecode/skills/power-bi-retail-analytics-salespulse360.md) — скилл · 659 установок

Из того же набора: [data-goblin/power-bi-agentic-development](https://affpapa.org/nevibecode/by/data-goblin/power-bi-agentic-development.md) — 59 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
