# semantic-model-auditor

Субагент semantic-model-auditor проверяет семантические модели Power BI и Fabric на ошибки структуры, лишние таблицы дат и проблемы производительности в коде TMDL и формулах DAX.

- субагент · `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/semantic-models/agents/semantic-model-auditor.agent.md
- Обновлён: 2026-10-28
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/semantic-model-auditor

## Что делает

Субагент автоматизирует проверку семантических моделей. Сначала он запускает экспорт модели из рабочей области Fabric через команду `fab export` во временную папку `/tmp/audit`. Внутри формируются файлы формата TMDL: схема базы, таблицы, связи и вычисляемые выражения.

Затем запускается статический анализ структуры. Субагент ищет двунаправленные связи в `relationships.tmdl`, пропущенные типы данных, скрытые таблицы дат от автокалендаря вроде `LocalDateTable_*` и циклические зависимости между мерами. Он находит столбцы с высокой кардинальностью, неразделённые поля даты и времени, а также неиспользуемые столбцы, которые раздувают словарь VertiPaq. В формулах DAX агент отслеживает вложенные вызовы `CALCULATE` и тяжёлые агрегации `DISTINCTCOUNT`.

Для работы субагенту обязательно нужен Fabric CLI (`fab`) в рабочей среде. Если консольная утилита не настроена или нет доступа к нужной рабочей области, шаг экспорта завершится ошибкой.

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

## Установка

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

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

### Claude Code

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- найти двунаправленные связи и циклические зависимости в мерах
- обнаружить неразделённые столбцы даты и времени, раздувающие словарь VertiPaq
- выявить автосгенерированные таблицы дат и лишние вычисляемые столбцы
- найти вложенные вызовы `CALCULATE` в выражениях DAX

## Примеры запросов агенту
- Проверь модель Sales в рабочей области Production на ошибки и проблемы со скоростью
- Запусти аудит лучшей практики для семантической модели перед деплоем
- Найди антипаттерны в коде DAX и оптимизируй расход памяти модели

## Похожие
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP-сервер · ★ 1297 у репозитория
- [Horizun PBI MCP](https://affpapa.org/nevibecode/mcp/horizun-pbi-mcp.md) — MCP-сервер · ★ 34 у репозитория
- [power-bi-model-design-review](https://affpapa.org/nevibecode/skills/power-bi-model-design-review.md) — скилл · 9000 установок
- [power-bi-dax-optimization](https://affpapa.org/nevibecode/skills/power-bi-dax-optimization.md) — скилл · 9100 установок
- [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
