UniShift Platform

Appearance

Агент: Генератор документов (DOCX, PDF, Excel) ​

Агент Генератор документов (slug: doc-generator) предназначен для создания профессионально оформленных документов Word (.docx), Adobe PDF (.pdf) и электронных таблиц Microsoft Excel (.xlsx) на основе данных из базы знаний компании (RAG), таблиц Data Tables, задач и внешних источников.

Возможности и преимущества ​

  • Прямая выгрузка в чат: Сгенерированный файл автоматически загружается в хранилище Storage и прикрепляется к сообщению в виде интерактивной карточки для скачивания и markdown-ссылки.
  • Соблюдение корпоративного стиля: Агент использует системный навык document-styling-guide (палитра #1F4E79, контрастные заголовки, зебра-таблицы, выверенные поля страницы A4).
  • Проверка доступности раннеров: Перед началом рендеринга агент опрашивает статус фоновых раннеров. Если нужный раннер недоступен, агент сразу сообщает об этом и предлагает доступные форматы.
  • Генерация на лету (Ad-hoc): Создание документов происходит через механизм одноразовых задач без замусоривания постоянного каталога команд в Command Manager.

Поддерживаемые форматы ​

1. Документы Word (.docx) ​

  • Механизм: Раннер docx-generator конвертирует валидную семантическую HTML-разметку в бинарный .docx через headless-движок LibreOffice.
  • Что поддерживается:
    • Иерархия заголовков <h1>–<h3> с цветовым акцентом #1F4E79 и отступами.
    • Форматированные абзацы, маркерные и нумерованные списки.
    • Адаптивные таблицы на всю ширину страницы (width: 100%) со стилизованными шапками и чередованием строк #F2F4F7.
    • Разрывы страниц (page-break-before: always).

2. Документы PDF (.pdf) ​

  • Механизм: Раннер pdf-generator выполняет сборку PDF из HTML и строгих встроенных стилей CSS в теге <style>.
  • Что поддерживается:
    • Директива @page с точными полями (A4 portrait, margins: 15–20mm).
    • Защита от разрыва таблиц и карточек между страницами (page-break-inside: avoid).
    • Стилизованные колонтитулы, карточки с акцентной левой рамкой (border-left: 4px solid #1F4E79).
    • Адаптивная типографика с межстрочным интервалом 1.4.

3. Таблицы Excel (.xlsx) ​

  • Механизм: Раннер xlsx-generator собирает электронные книги на базе движка Excelize из структурированной JSON-конфигурации.
  • Что поддерживается:
    • Несколько листов в одном файле (sheets).
    • Автоматический расчет ширины колонок (width), чтобы ячейки не обрезались и не отображали ###.
    • Числовые и валютные форматы (#,##0.00, даты yyyy-mm-dd, проценты 0.0%).
    • Формулы расчета сумм и средних (=SUM(...), =AVERAGE(...)).
    • Заливка шапок контрастным цветом, выравнивание текста и жирное выделение итоговых строк.

Набор инструментов агента ​

ИнструментНазначение
get_document_runnersПроверяет онлайн-статус раннеров (active, paused, offline) и доступные форматы (docx, pdf, xlsx)
render_documentЗапускает задачу генерации на целевом раннере и возвращает ссылку download_url
search_knowledge_baseИзвлечение регламентов, инструкций, брендбуков и фактуры из базы знаний RAG
search_tables / get_table / list_table_rowsЧтение структурированных таблиц из модуля Data Tables для экспорта в Excel или отчеты
search_tasks / get_taskПолучение деталей задач из Task Tracker
search_notes / get_noteЧтение заметок текущего пространства
web_search / fetch_urlСбор актуальной информации и котировок из интернета при необходимости

Примеры использования ​

Пример 1. Создание официального отчета в DOCX ​

Запрос пользователя:«Найди в базе знаний регламент проведения аудита ИБ и сгенерируй на его основе готовый отчет аудита за третий квартал в формате DOCX с таблицей найденных рисков.»

Что делает агент:

  1. Ищет статьи по аудиту ИБ через search_knowledge_base.
  2. Проверяет наличие раннера docx-generator через get_document_runners.
  3. Формирует семантическую разметку со стилизованной таблицей матрицы рисков.
  4. Вызывает render_document с format: "docx" и filename: "Отчет_аудита_ИБ_Q3.docx".
  5. Прикрепляет файл к ответу и выводит ссылку: [Скачать Отчет_аудита_ИБ_Q3.docx](/proxy/storage/api/v1/storage/.../download).

Пример 2. Формирование памятки в формате PDF ​

Запрос пользователя:«Сделай красивую PDF-памятку для новых разработчиков по правилам работы с git-ветками и релизами в нашей компании.»

Что делает агент:

  1. Находит стандарты git-flow в документации пространства.
  2. Составляет HTML-структуру с тегом <style>: стиль @page { size: A4; }, корпоративные заголовки, акцентные плашки для правил наименования веток (feature/*, fix/*).
  3. Запускает render_document с format: "pdf" на раннере pdf-generator.
  4. Возвращает готовый файл с возможностью мгновенного предпросмотра и скачивания.

Пример 3. Сводная финансовая таблица в Excel ​

Запрос пользователя:«Собери из таблицы 'Расходы отделов' сводный бюджет на Q4 в Excel: сгруппируй по отделам, добавь колонку плана/факта, процент отклонения и строку общего итога с формулой суммирования.»

Что делает агент:

  1. Читает строки через search_tables и list_table_rows.
  2. Проверяет доступность раннера xlsx-generator.
  3. Рассчитывает безопасную ширину колонок и настраивает стили ячеек (number_format: "#,##0.00", =SUM(C2:C10)).
  4. Запускает генерацию через render_document с format: "xlsx".
  5. Отдает пользователю файл .xlsx.