Что вы создадите
В этом руководстве вы научитесь создавать практичный плагин Интеллос, который экспортирует разговоры в популярные форматы документов. К концу руководства ваш плагин будет:- Преобразовывать текст Markdown в документы Word (.docx)
- Экспортировать разговоры в файлы PDF
- Обрабатывать создание файлов с корректным форматированием
- Обеспечивать удобный пользовательский опыт при экспорте документов
Требуемое время
15 минут
Предварительные требования
Базовые знания Python и знакомство с библиотеками для работы с документами
Шаг 1. Настройте окружение
1
Установите Интеллос CLI
- Mac
- Linux
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:
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, для других языковРедактировать эту страницу | Сообщить о проблеме

