semantic-model-auditor — субагент Claude Code: аудит и запуск
Субагент semantic-model-auditor проверяет семантические модели Power BI и Fabric на ошибки структуры, лишние таблицы дат и проблемы производительности в коде TMDL и формулах DAX.
GPL-3.0 ★ 1 104 обновлён 2026-10-28
.github/agents/semantic-model-auditor.agent.mdЧто делает semantic-model-auditor
Субагент автоматизирует проверку семантических моделей. Сначала он запускает экспорт модели из рабочей области Fabric через команду fab export во временную папку /tmp/audit. Внутри формируются файлы формата TMDL: схема базы, таблицы, связи и вычисляемые выражения.
Затем запускается статический анализ структуры. Субагент ищет двунаправленные связи в relationships.tmdl, пропущенные типы данных, скрытые таблицы дат от автокалендаря вроде LocalDateTable_* и циклические зависимости между мерами. Он находит столбцы с высокой кардинальностью, неразделённые поля даты и времени, а также неиспользуемые столбцы, которые раздувают словарь VertiPaq. В формулах DAX агент отслеживает вложенные вызовы CALCULATE и тяжёлые агрегации DISTINCTCOUNT.
Для работы субагенту обязательно нужен Fabric CLI (fab) в рабочей среде. Если консольная утилита не настроена или нет доступа к нужной рабочей области, шаг экспорта завершится ошибкой.
Какие задачи решает
- найти двунаправленные связи и циклические зависимости в мерах
- обнаружить неразделённые столбцы даты и времени, раздувающие словарь VertiPaq
- выявить автосгенерированные таблицы дат и лишние вычисляемые столбцы
- найти вложенные вызовы
CALCULATEв выражениях DAX
Примеры запросов агенту
- Проверь модель Sales в рабочей области Production на ошибки и проблемы со скоростью
- Запусти аудит лучшей практики для семантической модели перед деплоем
- Найди антипаттерны в коде DAX и оптимизируй расход памяти модели
Как установить semantic-model-auditor
Вручную: положить файлы
.github/agents/semantic-model-auditor.agent.md1Через маркетплейс плагинов
/plugin marketplace add data-goblin/power-bi-agentic-development/plugin install semantic-models@power-bi-agentic-development2Вручную: положить файлы
.claude/agents/semantic-model-auditor.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code
Вручную: положить файлы
.codex/agents/semantic-model-auditor.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/semantic-model-auditor.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о semantic-model-auditor
Как установить semantic-model-auditor в Claude Code?
Подключите репозиторий командой /plugin marketplace add data-goblin/power-bi-agentic-development, затем установите плагин через /plugin install semantic-models@power-bi-agentic-development.
Что делает semantic-model-auditor?
Субагент выгружает семантическую модель Power BI или Fabric в формат TMDL и проверяет её файлы на антипаттерны, утечки памяти VertiPaq и некорректные связи.
Что требуется субагенту для запуска аудита?
В системе должна быть установлена утилита Fabric CLI (fab) с доступом к целевой рабочей области, так как агент начинает работу с команды экспорта.