Агентна конвертація документів на місці з n8n, MCP та GroupDocs.Conversion ^[draft]

Кожна організація працює з документами — і з крихкими скриптами, які переміщують їх між форматами. Звіти Word перетворюються у PDF, електронні таблиці — у CSV, скановані файли — у пошукові документи. Кожен новий формат або правило означає переписування конвеєра. Є більш гнучкий спосіб: дозволити AI‑агенту виконувати конвертації на вашій інфраструктурі, використовуючи інструменти, які ви йому надаєте. У цій статті показано, як саме це побудувати за допомогою n8n, Model Context Protocol (MCP) та GroupDocs.Conversion MCP server — залишаючи ваші документи (і, за бажанням, вашу AI‑модель) повністю в межах вашої мережі.

Від жорстко закодованих конвеєрів до агентної автоматизації

Традиційна автоматизація кодує як виконується завдання: визначити тип файлу, розгалуження, викликати конвертер, обробити помилки, записати результат. Кожна нова вимога — це зміна коду.

Агентний робочий процес кодує що ви хочете. Ви формулюєте мету — «перетворити ці звіти у PDF, але спочатку перевірити кількість сторінок» — і надаєте набір інструментів. AI‑агент вирішує, які інструменти викликати і в якому порядку, і адаптується до результату. Додайте інструмент — і агент одразу його використовує, без переписування коду. Ця адаптивність і є головною перевагою.

Що таке MCP і чому це важливо тут

Складна частина агентів, що користуються інструментами, завжди була інтеграція — кожен агент спілкувався з кожним інструментом по‑різному. Model Context Protocol — це відкритий, нейтральний до постачальника стандарт, який це виправляє: будь‑який агент, що підтримує MCP, може виявляти та викликати будь‑які можливості MCP‑сервера. Уявіть це як «USB‑C для AI‑інструментів».

GroupDocs публікує операції над документами як MCP‑сервери. GroupDocs.Conversion сервер надає три інструменти, які може викликати агент:

Оскільки сервер працює за протоколом MCP, ваш агент не потребує спеціальної інтеграції GroupDocs. Він просто бачить інструменти.

Архітектура (весь код відкритий, підключайте свою LLM)

Ключовий вибір дизайну: LLM підключається. Вузол Chat Model у n8n не прив’язаний до конкретного постачальника, тому агент і MCP‑інструменти не змінюються, коли ви міняєте модель. У прикладі нижче використано OpenAI, але той самий робочий процес працює з Azure OpenAI, Anthropic, AWS Bedrock — або з повністю самостійно розгорнутою моделлю (Ollama, vLLM), коли потрібне ізольоване розгортання, де документи і AI залишаються у вашій мережі.

Один момент інтеграції: Conversion MCP — це легковаговий stdio сервер (за замовчуванням без мережі). Оскільки n8n підключається до MCP‑інструментів через URL, невеликий відкритий stdio‑to‑SSE міст (supergateway) відкриває його на порту. Сам сервер не змінюється.

Як працює робочий процес

1. Тригер — webhook, вхідна електронна пошта, завантаження форми або спостережувана папка отримує документ.
2. Етап — n8n записує файл у спільну папку, яку читає MCP‑сервер.
3. Мислення — AI‑Agent n8n (ваша Chat Model + Conversion MCP як інструмент) отримує інструкцію типу «Конвертуй report.docx у PDF і повідом кількість сторінок». Він автономно викликає get_document_info, потім convert.
4. Доставка — n8n бере конвертований файл зі спільного сховища і передає його далі — електронною поштою, в об’єктне сховище, SharePoint або у відповідь на запит.

Агент обирає інструменти та їх порядок. Це дозволяє одному робочому процесу обробляти «просто конвертуй», «конвертуй лише якщо більше 10 сторінок» або «конвертуй і підсумуй».

Запустіть за кілька хвилин

Мінімальний стек — два сервіси, що ділять один том: конвертер (за містом) і n8n:

services:
  conversion-mcp:                    # GroupDocs.Conversion MCP, exposed over SSE
    build: ./bridge                  # supergateway --stdio "groupdocs-conversion-mcp" --port 8000
    environment:
      GROUPDOCS_MCP_STORAGE_PATH: /data
      GROUPDOCS_LICENSE_PATH: /license/GroupDocs.Total.lic
    volumes: [ ./data:/data, ./gd-license:/license:ro ]
  n8n:
    image: n8nio/n8n:latest
    ports: ["5678:5678"]
    volumes: [ ./data:/data ]        # SAME folder — the file hand-off

Потім у n8n створіть агент з чотирьох вузлів: Chat Trigger, Chat Model (ваші облікові дані OpenAI), інструмент MCP Client, що вказує на http://conversion-mcp:8000/sse, і AI Agent, який їх з’єднує. Скиньте файл у ./data, відкрийте чат і попросіть агента його конвертувати.

Повний, готовий до запуску набір — docker-compose.yml, образ мосту та імпортований робочий процес n8n — знаходиться у супутньому відкритому репозиторії (див. нижче).

Ліцензування

Без ліцензії GroupDocs.Conversion працює в режимі оцінки: вихідний файл має водяний знак і використання може бути обмеженим. Для продакшн‑середовища розмістіть файл GroupDocs.Total.lic у підключеній папці ліцензій — вихід буде чистим і без обмежень. Ви можете запросити тимчасову ліцензію, щоб спробувати ліцензований результат.

Чому це підходить для підприємств

• Суверенітет даних — документи та движок конвертації залишаються у вашій інфраструктурі. Оберіть самостійно розгорнуту модель, і AI теж залишиться у вас.
• Відсутність прив’язки — кожен шар відкритий або базується на стандартах (MCP). Вільно міняйте LLM, оркестратор або інструменти.
• Аудит — кожне рішення агента і виклик інструменту є видимим, відтворюваним виконанням n8n.
• Композиційність — це кумулятивна перевага. Підключіть той самий агент до інших MCP‑серверів GroupDocs — Redaction, Watermark, Metadata — і одне запитання природною мовою стане повним конвеєром: «замаскуй PII, конвертуй у PDF, потім наклади водяний знак “Confidential”».

Перші кроки

• Супутній відкритий демо‑проект: GroupDocs.Conversion.Agentic — клонувати, додати ваш ключ LLM, docker compose up і почати спілкування з вашими документами.
• NuGet: GroupDocs.Conversion.Mcp
• Docker‑образ: ghcr.io/groupdocs-conversion/conversion-net-mcp
• Детальніше про MCP: modelcontextprotocol.io

Агентна автоматизація документів — це не далека мрія, а лише docker compose up від вас, зібрана з компонентів, які ви можете читати, розгортати та довіряти. Дайте вашим AI‑агентам можливість конвертувати документи на ваших умовах.