Как я называю вещи в текстах, как их называют обычно и что это.
| термин | что это | как называют обычно |
|---|---|---|
| сырые таблицы | таблицы, как пришли от генератора | raw, landing, bronze |
| промежуточная таблица | таблицы stg_*: почищено, дедуплицировано, приведено к UTC | staging, silver |
| витрина | таблицы fct_* / dim_*, из них агент и считает | mart, gold |
| код сборки | SQL-файлы | dbt-модель, transformation |
| манифест сборки | JSON, пишется при компиляции | dbt manifest |
| описания витрин | YAML: витрины, промежуточные таблицы; до агента доезжают через манифест | dbt docs, model descriptions |
| тесты сборки | проверки, которые сборка прогоняет над своими таблицами: нет дублей, ключи не пустые, связи между таблицами сходятся | dbt tests |
| срез клиентов | customers_asof — состояние клиентов на курсор | snapshot, as-of table |
Витрина — это результат, код сборки — это причина. Их постоянно смешивают, потому что в dbt и то и другое называется model.
| термин | что это | как называют обычно |
|---|---|---|
| файл определений метрик | metrics.yml | semantic layer, metrics layer |
| решение | за какой период, включать ли гостей | business logic, definition |
| развилка | место, где решение можно было принять иначе; признак — можно поставить другое, и запрос останется рабочим | — |
| термин | что это | как называют обычно |
|---|---|---|
| модель | языковая модель, только она | LLM |
| агент | модель плюс обвязка | agent, LLM app |
| обвязка | код, который собирает промпт и исполняет SQL; ядро + модуль под тип | harness, scaffolding |
| отбор контекста | что положить в промпт | retrieval, RAG |
слой tables | общий выключатель отбора: сразу для схемы, описаний и примеров значений | — |
| промпт | текст, который уходит модели на один вопрос | prompt |
| инструкция | константа SYSTEM_FREE | system prompt |
| блок | часть промпта | prompt section |
| раннер | скрипт прогона под тип задачи | runner, eval script |
| петля | у нас её нет: один план, перезапуск только при падении | agent loop, multi-step |
| контекст хода | вводим, когда появится петля: всё, что модель видит на данном ходу; промпт — его первая часть | context window |
Отбор контекста здесь не RAG в привычном смысле. Нет ни векторов, ни эмбеддингов, ни похожести. Это правила: взять таблицы, названные в определении метрики, взять их описания из манифеста. Роль та же — решить, что попадёт в промпт.
| термин | что это | как называют обычно |
|---|---|---|
| эталонный запрос | пишется по сырым таблицам, правда по построению | ground truth query |
| эталон кейса | вердикт, который автор генератора хотел заложить. Намерение, а не пересчёт из данных | label, ground truth |
| стенд | данные плюс вопросы плюс эталоны | benchmark, eval harness |
| приёмка | проверка результата под тип; см. приёмку по типам | evaluation, acceptance check |
| подложенная копия | заведомо верный или неверный ответ, которым проверяют приёмку до прогона | planted answer, canary |
| отпечаток | layer_sha, context_sha — снимаются с того, что видела модель, не с файла | hash, fingerprint |
Приёмка зависит от образа результата. У числа своя правда, у выгрузки другая, у исследования её нет вовсе.
Передаваемость не про сложность. Задача отдаётся не потому, что простая, а потому, что решения в ней объявлены.
| тип | чем принимать | что она не видит |
|---|---|---|
| число | сверка с эталонным запросом; разложение числа на слагаемые; сложение двумя способами; пересчёт с другим решением | совпадение при разных определениях |
| правка | сверка с прошлой версией с допуском: снятый фильтр — старые строки не тронуты; агрегат — ключи те же | лишние правки кода — смотреть дифф запроса |
| выгрузка | внутренние проверки плюс сверка ключей и значений | пустую таблицу — внутренние проверки её пропускают |
| A/B | вердикт против заложенного; ширина интервала против порога; деление групп | улики вне сводки |
| исследование | устойчивость вывода между повторами | верность — её мерить не с чем |
Общий приём для всех типов — чтение того, что агент решил сам: он называет развилки даже без права спросить.