Skip to content

Генерация документов (DOCX, XLSX, PDF) ​

Нативная генерация документов в AI Router: чистый Go, без внешних раннеров и LibreOffice. Тулы оркестратора (multi-agent/agent, а также обычный чат через artifact-allowlist); отдельная карточка-агент не создаётся миграцией — при необходимости админ вешает тулы на кастомную карточку через её tools.


Тулы ​

ТулФорматВход
create_docx.docxtitle, template? (slug), document{accent?, orientation?, sections:[{heading, paragraphs, bullets, table:{caption, columns, rows}}]}
update_docx.docxfile_id, ops (add/replace/remove_section, set_heading/paragraphs/bullets/table/title/subtitle/accent/template/orientation) или полный document
create_xlsx.xlsxtitle, template? (slug), workbook{accent?, sheets:[{name, headers, rows, widths?}]}
create_pdf.pdftitle, document — тот же IR, что у create_docx

Правила IR: компактный JSON, никаких OOXML/HTML-байтов от модели. Числа в create_xlsx передаются числами; строка ячейки, начинающаяся с =, пишется формулой (=SUM(B2:B10)). Лимиты: docx — 30 секций / таблица 80×10; xlsx — 10 листов / 500 строк / 30 колонок; pdf — 60 строк таблицы.

Выдача файла — тот же пайплайн, что у create_pptx: SparkGrid Media (space-чат) или Storage category documents (общий чат), результат тула содержит file_id, file_name, download_url; в чате рендерится карточка файла.


Реализация ​

  • DOCX — internal/infrastructure/docx: свой OOXML-писатель (styles/numbering/sectPr) + Assemble в загруженный шаблон. update_docx читает файл обратно в IR (Parse): стили резолвятся через styles.xml пакета, slug шаблона хранится в docProps/custom.xml (UnishiftTemplate).
  • XLSX — internal/infrastructure/xlsx: excelize. Шапка — accent-заливка + freeze первой строки, ширины считаются по контенту (или из widths).
  • PDF — internal/infrastructure/pdf: go-pdf/fpdf, встроенные шрифты DejaVu Sans (+Bold/Oblique, SIL OFL 1.1 — fonts/LICENSE), кириллица из коробки. A4 portrait/landscape, заголовки accent-цветом, таблицы с шапкой-заливкой.

Шаблоны и стиль ​

Три уровня приоритета — как у pptx:

  1. Шаблон-образец (детерминированное оформление). Админ загружает корпоративный .docx/.xlsx в «Настройки → AI Router → Ассеты» (kind docx_template / xlsx_template, base64 в body, ≤10MB). docx_template: рендер идёт в styles.xml образца — шрифты, цвета заголовков, колонтитулы, поля и ориентация страницы сохраняются. xlsx_template: configured sheets пишутся в открытую книгу; пустой первый лист переименовывается под первый лист конфига, листы с контентом не трогаются. Тег default — шаблон применяется, когда юзер/модель шаблон не назвали.
  2. Выбор в команде: «сделай КП по шаблону kp-corp» → каталог подсвечивается в системном промпте хода (assetCatalogKindsForTools) → планировщик передаёт slug в параметр template. Скилл может маршрутизировать выбор («отчёты → corp-report, КП → kp-template»).
  3. Разовый стиль: accent (hex или red/blue/green/teal/purple/orange/navy) и orientation (portrait/landscape) в IR.

Стиль применяется шаблоном, а не текстом промпта — скилл выбирает шаблон, шаблон красит. RAG (search_knowledge_base) — источник контента, не стиля.


Примеры ​

DOCX-отчёт с итерацией ​

«Найди в базе знаний регламент аудита ИБ и собери отчёт за Q3 в docx по нашему шаблону, с таблицей рисков».

  1. search_knowledge_base → фактура.
  2. create_docx{template:"...", document:{sections:[...]}} → карточка файла.
  3. «Добавь раздел с рекомендациями» → update_docx{file_id, ops:[{op:"add_section", ...}]}.

Excel-сводка ​

«Собери из таблицы 'Расходы отделов' бюджет на Q4: колонка отклонения и строка итога».

  1. search_tables + list_table_rows → данные.
  2. create_xlsx{workbook:{sheets:[{name:"Q4", headers:["Отдел","План","Факт","Отклонение"], rows:[..., ["Итого","","","=SUM(D2:D10)"]]}]}}.

PDF-памятка ​

«Сделай PDF-памятку по git-flow для новичков» → create_pdf{document:{...}} — та же структура, что в docx.


Legacy: runner-ветка ​

get_document_runners + render_document (Command Manager раннеры docx-generator/pdf-generator/xlsx-generator, LibreOffice на хосте) остаются включёнными для совместимости. Новые флоу строятся на нативных тулах; раннеры требуют локальной установки LibreOffice и в prod-контейнерах не присутствуют.