AI-отчёт из нескольких систем: как свести факты в один рабочий документ

Руководитель просит сводку: продажи из CRM, отгрузки из учётной системы и обращения из поддержки за неделю. Агент может получить три ответа инструментов за секунды, но они описывают разные даты, статусы и единицы. Прежде чем поручать модели выводы, нужно собрать совместимый набор фактов для отчёта.

Согласуйте смысл показателей

В CRM продажей может считаться подписанный договор, в учётной системе — проведённая реализация. Обе цифры верны в своих определениях. Если в отчёте назвать их одним словом, модель начнёт объяснять расхождение как проблему бизнеса. Для каждого показателя сохраните определение, единицу и правило отнесения к периоду.

Задайте отчётный интервал с началом и исключаемым концом, часовой пояс и дату среза. Обращение, созданное в воскресенье вечером по UTC, может относиться к понедельнику в рабочем часовом поясе. Дата выгрузки тоже важна: источник за неделю мог обновиться только до пятницы.

Соберите пакет фактов до генерации текста

Каждый инструмент должен вернуть не только значение, но и метаданные расчёта. Например: metric_id, value, unit, period_start, period_end, as_of и source. Приложение проверяет совместимость периода и единицы. Если данные поддержки не готовы, отчёт явно получает статус частичного.

Для финансовых показателей передавайте валюту и основание пересчёта. Для количества заказов — правило исключения отменённых и тестовых записей. Модель хорошо пишет связный текст из подготовленного набора; вычисление итогов по полным выгрузкам удобнее оставить обычному коду или SQL.

Проверьте пакет до написания выводов

Код ниже принимает три уже рассчитанных показателя. Он обнаруживает, что поддержка вернула другой период. Значения разных метрик не складываются: проверка только решает, можно ли строить отчёт за один общий интервал. После устранения расхождения пакет передают модели вместе с определениями показателей.

period = ("2026-10-19", "2026-10-26")
facts = [
    {"metric": "orders", "period": period, "value": 80, "unit": "orders"},
    {"metric": "shipments", "period": period, "value": 72, "unit": "shipments"},
    {"metric": "tickets", "period": ("2026-10-20", "2026-10-27"), "value": 15, "unit": "tickets"},
]
mismatch = [f["metric"] for f in facts if f["period"] != period]
assert mismatch == ["tickets"]
print({"ready": not mismatch, "period_mismatch": mismatch})

Отделите наблюдение от объяснения

Фраза «заказов стало меньше» описывает сравнение двух срезов. Фраза «из-за задержки поставок» требует дополнительных оснований. В шаблоне отчёта полезно разделить изменения показателей, подтверждённые причины и вопросы для проверки. Тогда ассистент не обязан придумывать объяснение каждому отклонению.

Сохраняйте рядом с отчётом пакет входных фактов. Через неделю данные в CRM могут измениться, а сотруднику понадобится понять, почему в отправленной сводке стояло другое число. Версия пакета и время получения источников позволяют повторить именно подготовку текста.

Попросите владельцев показателей проверить первый отчёт по отдельности. Финансист подтверждает смысл выручки, поддержка — правила подсчёта обращений. После этого руководитель оценивает полезность структуры и выводов. Одна общая оценка «хорошая сводка» не обнаружит тихую подмену определения.

Для повторяющегося отчёта вынесите договорённости в конфигурацию и добавьте проверки граничных дат. Следующий запуск должен либо собрать сопоставимый пакет, либо ясно назвать отсутствующие источники. Именно эта подготовка делает регулярный AI-отчёт рабочим инструментом команды.

Продолжить проект на практике

Следующий шаг — подключить источники и наблюдать, как собирается отчёт. В платном курсе AI Agents PRO вы поработаете с внешними API, состоянием агента и трассировкой production-сервиса. На этой основе можно отделить получение фактов, проверку пакета и подготовку текста, сохраняя данные для разбора ошибок.

Откройте программу курса и выберите следующий этап своего проекта.

По теме: План AI-агента и исполнение: какие проверки ставить между ними.