Автоматизация отчетности

Автоматизация отчетности превращает воспроизводимую выгрузку исходных данных в отчёт по заданным правилам проверки, расчёта и публикации. Сначала определите отчётный период и требования к записям, рассчитайте итоги по проверенным данным, затем добавьте комментарии со ссылками на эти записи. Процесс подготовки отчёта на основе компонентов каталога в AI Flowi Workflow позволяет подготовить Table, создать черновик текста и подставить проверенные значения в документ Google Docs.

Цель — воспроизводимый операционный отчёт, например сводка состояния проекта по утверждённой выгрузке. Это руководство отделяет детерминированные итоги от пояснений, написанных моделью, чтобы правдоподобный текст не мог незаметно изменить числа.

Автор: Ai Flowi · Опубликовано

Определите требования к отчёту

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

Load CSV предоставляет записи из файла, а JSON Operations предлагает JQ Expression через operations и query. Используйте эти детерминированные операции для проверки обязательных полей и вычислений по определённой формуле. Изучите интерфейс JSON Operations с описанием этих настроек, затем сверьте формулу отчёта с независимо рассчитанными ожидаемыми значениями.

Подготовьте учётные записи и распределите обязанности по проверке

Подготовьте утверждённую выгрузку, описание отчёта, документ для проверки с известными метками подстановки и авторизованное подключение Google с правами редактирования этого документа. Для комментариев aReduce настройте учётную запись провайдера с API-ключом через учётные данные модели и предусмотрите отдельную оплату услуг провайдера.

Более широкий процесс согласования описан в руководстве по автоматизации документооборота.

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

Настройте этапы подготовки отчёта

Пример конфигурации, а не отчёт о проведённом испытании

Настройка операционного отчёта и точки проверки
КомпонентНастраиваемые входыПроверка результата задачи
Load CSVЗадайте один источник в csv_file или csv_string; сохраните идентификатор источника отдельно от результата разбора.Сверьте поля периода и учитываемые статусы с описанием отчёта.
JSON OperationsВыберите operations = "JQ Expression" для записей отчёта в data; поместите утверждённые правила включения и расчёта в query.Независимо проверьте учитываемые количества и сохранённые причины исключения.
Data → DataFrameПередайте только проверенные записи или выбранный объект сводки отчёта в data_list; используйте отдельные преобразования, если требования к структуре различаются.Каждое значение сводки относится к одной и той же принятой версии источника.
aReduceПодключите проверенную Table к source; настройте model, schema в виде Table и instructions, требующие комментариев со ссылками на записи. Задайте return_multiple_instances = false для одной предлагаемой сводки отчёта.Текстовые утверждения должны указывать подтверждающие записи отчёта, включая существенные исключения.
Template MergeВ document_id укажите копию для проверки за этот период, а в values — утверждённые значения периода, итогов и исключений; остальные настройки описаны в инструкции по подстановке.Период, итоги и примечания об исключениях должны согласовываться в готовом отчёте.
  1. Проверьте выгрузку. До любых расчётов проверьте названия столбцов, идентификаторы, допустимые статусы и интерпретацию дат. Если обязательное поле отсутствует, остановите подготовку отчёта; отсутствующее поле не означает пустой набор данных.
  2. Рассчитывайте по принятым записям. Запишите вычисления в JQ-запросе JSON Operations с явными правилами группировки, включения и обработки null. Зафиксируйте, какие идентификаторы входят в каждый итог. Проверьте формулу на небольшом синтетическом наборе данных с известными результатами.
  3. Ограничьте входные данные модели. Преобразуйте в Table для aReduce только утверждённые данные, подтверждающие отчёт. Его source принимает Table или DataFrame, поэтому исходный JSON загрузчика нельзя подключить непосредственно к этому входу.
  4. Подготовьте черновик текста со ссылками на данные. Попросите aReduce объяснить предоставленные статусы и указать идентификаторы исходных записей в рамках предлагаемой схемы. В описании компонента сказано, что он анализирует весь входной dataframe за один раз; это не доказывает, что выгрузка произвольного размера поместится в выбранную модель.
  5. Проверьте и выполните подстановку. Сравните текст с детерминированными итогами. Если проверенную Table нужно преобразовать для входа values компонента Template Merge, принимающего Data или JSON, передайте её через input_data компонента Type Convert, выбрав "JSON" в output_type. Перед подстановкой проверьте полученную структуру.

Считайте отдельно от поясняющего текста

Для подсчёта нужно правило включения, а не просьба «обобщить данные». Для итоговой суммы нужны заданные единицы измерения и правила обработки пропусков. Не смешивайте валюты, не суммируйте идентификаторы и не считайте неуказанное значение нулём лишь потому, что модель придаёт тексту законченный вид.

Храните проверенные числа как отдельный источник для меток подстановки отчёта. Если aReduce повторяет итог в своём выводе, сравните его с вычисленным значением и отклоните расхождение. Комментарий может описывать предоставленные сведения, но причинные объяснения, например почему проект задержался, требуют исходных материалов, действительно подтверждающих такой вывод.

Проверьте подстановку в Google Docs

Следуйте существующей инструкции по настройке Template Merge для меток подстановки и передаваемых данных.

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

Проверки автоматизации отчёта о состоянии проекта

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

Для текста проверьте, что каждый упомянутый элемент есть во входных данных, а отсутствие подтверждений указано прямо. В готовом отчёте сравните заголовок периода, общий итог и список исключений с тем же принятым набором данных. Правильно подставленный итог прошлого периода всё равно делает отчёт устаревшим; включите идентификатор исходной выгрузки в примечания к проверке, чтобы сверить все эти значения с одной и той же исходной выгрузкой.

Рассмотрим условный период с двумя учитываемыми записями, содержащими количества 3 и 5, и отменённой записью с количеством 4. По правилу, исключающему отменённые элементы, ожидаемое количество — 8, а не 12. Убедитесь, что примечание об исключении объясняет его, не создавая впечатления отсутствующей записи. Если в обновлённой выгрузке отменённая запись становится учитываемой, пересчитайте итог по этой версии и снова проверьте комментарий. Изменение только отображаемого итога оставит текст и подтверждения включения несогласованными.

Каковы ограничения автоматизации отчётов и связанные зафиксированные результаты?

Процесс подготовки отчёта описан в каталоге; Ai Flowi не проверяла его в производственной среде. Сценарий создания документа из данных формы прошёл 42/42 тестовых случая после указанной в нём нормализации переводов строк, включая случаи отклонения. Эти проверки относятся к созданию документа из значений формы и не дают зафиксированных результатов для aReduce, расчётов отчёта или Template Merge.

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

Расходы на подготовку отчётов

Тарифы: Go от USD8 в месяц при годовой оплате (USD10 помесячно), Plus от USD16 (USD20 помесячно), Pro 100 от USD80 (USD100 помесячно), Pro 200 от USD160 (USD200 помесячно) и Pro 500 от USD400 (USD500 помесячно), от 5,000 до 250,000 Flowi Tokens в месяц с возможностью пополнения; 1 токен за каждый запуск узла; использование сторонних API и моделей не включено.

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

Материалы для публикации отчёта

Запись о создании документа из данных формы отделяет проверенный ввод от итогового документа. Если источник отчёта изначально заполнялся через HTTP-запросы, изучите руководство по приёму данных в Sheets. Просмотрите другие зафиксированные сценарии с учётом области проведённых проверок. Используйте извлечение данных из документов с ИИ для извлечения полей из источника и перевод Google Docs для отдельно проверяемой языковой версии готового отчёта.