Что вы создадите

В этом руководстве вы научитесь создавать практичный плагин Интеллос, который экспортирует разговоры в популярные форматы документов. К концу руководства ваш плагин будет:
  • Преобразовывать текст Markdown в документы Word (.docx)
  • Экспортировать разговоры в файлы PDF
  • Обрабатывать создание файлов с корректным форматированием
  • Обеспечивать удобный пользовательский опыт при экспорте документов

Требуемое время

15 минут

Предварительные требования

Базовые знания Python и знакомство с библиотеками для работы с документами

Шаг 1. Настройте окружение

1

Установите Интеллос CLI

Проверьте установку:
2

Создайте проект плагина

Инициализируйте новый проект плагина:
Следуйте подсказкам:
  • Name: “md_exporter”
  • Type: “tool”
  • Заполните остальные детали в соответствии с подсказками

Шаг 2. Опишите манифест плагина

Создайте файл manifest.yaml, чтобы задать метаданные плагина:

Шаг 3. Опишите инструмент экспорта в Word

Создайте файл word_export.yaml, чтобы задать инструмент экспорта в документ Word:

Шаг 4. Опишите инструмент экспорта в PDF

Создайте файл pdf_export.yaml для экспорта в PDF:

Шаг 5. Установите необходимые зависимости

Создайте или обновите файл requirements.txt, добавив нужные библиотеки:

Шаг 6. Реализуйте функциональность экспорта в Word

Создайте служебный модуль в utils/docx_utils.py:

Шаг 7. Реализуйте функциональность экспорта в PDF

Создайте служебный модуль в utils/pdf_utils.py:

Шаг 8. Создайте реализации инструментов

Сначала создайте инструмент экспорта в Word в tools/word_export.py:
Затем создайте инструмент экспорта в PDF в tools/pdf_export.py:

Шаг 9. Создайте точку входа

Создайте файл main.py в корне проекта:

Шаг 10. Протестируйте плагин

1

Настройте окружение для отладки

Сначала создайте файл .env из шаблона:
Укажите в нём данные вашего окружения Интеллос:
2

Установите зависимости

3

Запустите плагин в режиме отладки

Шаг 11. Упакуйте для распространения

Когда плагин будет готов к публикации:
Эта команда создаёт файл plugin.difypkg для распространения.

Идеи для применения

Генерация отчётов

Используйте этот плагин, чтобы преобразовывать аналитические сводки в профессиональные отчёты для клиентов

Документирование сессий

Экспортируйте заметки коучинговых или консалтинговых сессий в виде форматированных документов

За пределами базового сценария

Вот несколько интересных способов расширить этот плагин:
  • Пользовательские шаблоны: добавьте фирменный стиль компании или персонализированное оформление
  • Поддержка нескольких форматов: расширьте экспорт до HTML, Markdown или других форматов
  • Работа с изображениями: обрабатывайте и включайте изображения из разговоров
  • Поддержка таблиц: реализуйте корректное форматирование таблиц данных
  • Совместное редактирование: добавьте интеграцию с Google Docs или аналогичными платформами
Главная сложность при конвертации документов — сохранить форматирование и структуру. Подход, использованный в этом плагине, сначала преобразует Markdown в HTML (промежуточный формат), а затем обрабатывает этот HTML в целевой формат.Двухэтапный процесс даёт гибкость: вы можете расширить его для поддержки дополнительных форматов, просто добавив новые модули вывода, работающие с HTML-представлением.Для генерации PDF выбран WeasyPrint, поскольку он обеспечивает высококачественный рендеринг PDF с поддержкой CSS. Для документов Word библиотека python-docx даёт детальный контроль над структурой документа.

Итоги

Вы создали практичный плагин, который добавляет реальную ценность платформе Интеллос, позволяя пользователям экспортировать разговоры в профессиональные форматы документов. Эта функциональность устраняет разрыв между разговорами с ИИ и традиционными процессами работы с документами.

Документация

Напишите файл README.md на английском (en_US), описав функциональность, настройку и примеры использования

Локализация

Создайте дополнительные файлы README, например readme/README_zh_Hans.md, для других языков

Редактировать эту страницу | Сообщить о проблеме