Почему названия недостаточно
«Выручка», «активный клиент» и «конверсия» звучат понятно, пока два отдела не считают их по-разному. ИИ выбирает наиболее правдоподобное определение или ближайшее поле, а аккуратный ответ скрывает конфликт. Словарь нужен не для бюрократии, а чтобы вопрос имел один проверяемый смысл. Начните с десяти показателей, которые входят в еженедельное решение, а не пытайтесь описать всё хранилище.
Карточка одной метрики
Запишите деловое название, техническое имя, формулу, единицу, часовой пояс, период и владельца. Добавьте источники и допустимую задержку обновления. Ключевое поле — исключения: тестовые заказы, возвраты, сотрудники, внутренние аккаунты. Рядом должен лежать простой числовой пример с ожидаемым ответом. Если пример нельзя посчитать вручную, определение ещё слишком расплывчато.
Соберите разногласия
Попросите продажи, финансы и продукт независимо определить три общих показателя. Не сглаживайте различия. Иногда нужны отдельные названия: продуктовая активность и платёжная активность отвечают на разные вопросы. Для временного перехода храните старое и новое определение вместе с датой. ИИ не должен решать организационный спор, но может показать, что один запрос затрагивает две версии.
Свяжите бизнес и таблицы
Укажите таблицу, поле, ключ соединения и фильтр. Ссылка на поле без логики join недостаточна: дубликат клиента способен удвоить сумму. Для каждого источника назовите владельца и SLA. Если схема меняется, словарь получает новую версию, а контрольный запрос запускается снова. Не разрешайте модели искать похожий столбец во всём хранилище, когда критическая метрика должна использовать утверждённый путь.
Добавьте вопросы-проверки
На каждую карточку подготовьте три вопроса: обычный, пограничный и невозможный. Для конверсии это полный месяц, неполная текущая неделя и период до появления события. Ожидаемый ответ может быть «данных недостаточно». Такая формулировка полезнее случайного нуля. Сохраните SQL или ручной расчёт эталона, чтобы после обновления агента сравнить не стиль, а число и выбранные фильтры.
Покажите словарь в запросе
Пользователь не обязан писать техническое имя. Интерфейс может подсказать доступные определения и попросить выбрать вариант при неоднозначности. В ответе показываются использованная версия, период и исключения. Если вопрос выходит за границы словаря, агент задаёт уточнение или маркирует исследовательский расчёт, но не выдаёт его за официальный показатель.
Назначьте процесс обновления
Владелец метрики подтверждает изменение, инженер обновляет привязку, аналитик прогоняет примеры. Дата и причина сохраняются. Старый отчёт не переписывается новой формулой задним числом без заметной отметки. Раз в месяц полезно смотреть запросы, на которые агент часто отвечает уточнением: это кандидаты для нового определения, а не повод отключать вопросы.
Проверьте словарь на живом вопросе
Возьмите запрос руководителя, в котором есть период, сегмент и сравнение. Пусть аналитик сначала ответит привычным способом, затем агент — со словарём. Сравните число, фильтры и время проверки. После этого намеренно измените одно исключение и убедитесь, что версия ответа обновилась, а прошлый отчёт остался воспроизводимым. Если система продолжает использовать старую формулу без предупреждения, не подключайте новые метрики: сначала исправьте обновление контекста и журнал версий.
Добавьте границы использования
В карточке метрики напишите, для каких решений она подходит и для каких нет. Показатель маркетинговых лидов может помогать планировать нагрузку, но не заменять признанную выручку. Среднее время ответа поддержки не описывает тяжёлые отдельные случаи. Попросите владельца привести пример неверного применения и добавьте его в подсказку агенту. Если пользователь задаёт такой вопрос, система объясняет ограничение и предлагает подходящий показатель, а не просто выполняет расчёт.
Не превращайте документ в кладбище определений
Архивные метрики помечайте неактивными и указывайте замену, но не удаляйте без истории. В рабочем интерфейсе по умолчанию показываются текущие определения. Раз в квартал удаляйте дубли, находите карточки без владельца и проверяйте ссылки на таблицы. Словарь остаётся полезным, пока его открывают при споре и обновляют вместе с продуктом. Если он живёт отдельно от отчётов, агент скоро начнёт повторять устаревший смысл.
Однодневный план
Утром выберите десять метрик и соберите владельцев на 45 минут. До обеда заполните карточки и разногласия. После обеда свяжите пять самых важных с данными и прогоните по три вопроса. В конце дайте словарь коллеге, который не участвовал в обсуждении. Если он воспроизводит формулу и понимает исключения, первая версия готова. Остальные метрики добавляйте по реальному спросу.
Финиш и FAQ
Словарь готов к пилоту, когда каждый критический ответ показывает версию определения и проходит тестовый пример. Нужна ли отдельная платформа? Для первых десяти метрик достаточно управляемой таблицы с историей изменений. Кто владелец — инженер? Нет, деловой смысл утверждает функция, инженер отвечает за реализацию. Можно ли поручить ИИ заполнить словарь? Он соберёт черновик из документов, но конфликт и актуальность подтверждают люди. Что делать с двумя правильными формулами? Дать разные имена и явно выбирать контекст.