Appearance
Генерация документов (DOCX, XLSX, PDF)
Нативная генерация документов в AI Router: чистый Go, без внешних раннеров и LibreOffice. Тулы оркестратора (multi-agent/agent, а также обычный чат через artifact-allowlist); отдельная карточка-агент не создаётся миграцией — при необходимости админ вешает тулы на кастомную карточку через её tools.
Тулы
| Тул | Формат | Вход |
|---|---|---|
create_docx | .docx | title, template? (slug), document{accent?, orientation?, sections:[{heading, paragraphs, bullets, table:{caption, columns, rows}}]} |
update_docx | .docx | file_id, ops (add/replace/remove_section, set_heading/paragraphs/bullets/table/title/subtitle/accent/template/orientation) или полный document |
create_xlsx | .xlsx | title, template? (slug), workbook{accent?, sheets:[{name, headers, rows, widths?}]} |
create_pdf | .pdf | title, 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:
- Шаблон-образец (детерминированное оформление). Админ загружает корпоративный
.docx/.xlsxв «Настройки → AI Router → Ассеты» (kinddocx_template/xlsx_template, base64 вbody, ≤10MB).docx_template: рендер идёт в styles.xml образца — шрифты, цвета заголовков, колонтитулы, поля и ориентация страницы сохраняются.xlsx_template: configured sheets пишутся в открытую книгу; пустой первый лист переименовывается под первый лист конфига, листы с контентом не трогаются. Тегdefault— шаблон применяется, когда юзер/модель шаблон не назвали. - Выбор в команде: «сделай КП по шаблону kp-corp» → каталог подсвечивается в системном промпте хода (
assetCatalogKindsForTools) → планировщик передаёт slug в параметрtemplate. Скилл может маршрутизировать выбор («отчёты → corp-report, КП → kp-template»). - Разовый стиль:
accent(hex или red/blue/green/teal/purple/orange/navy) иorientation(portrait/landscape) в IR.
Стиль применяется шаблоном, а не текстом промпта — скилл выбирает шаблон, шаблон красит. RAG (search_knowledge_base) — источник контента, не стиля.
Примеры
DOCX-отчёт с итерацией
«Найди в базе знаний регламент аудита ИБ и собери отчёт за Q3 в docx по нашему шаблону, с таблицей рисков».
search_knowledge_base→ фактура.create_docx{template:"...", document:{sections:[...]}}→ карточка файла.- «Добавь раздел с рекомендациями» →
update_docx{file_id, ops:[{op:"add_section", ...}]}.
Excel-сводка
«Собери из таблицы 'Расходы отделов' бюджет на Q4: колонка отклонения и строка итога».
search_tables+list_table_rows→ данные.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-контейнерах не присутствуют.