Обзор Workflow
Что такое Workflow?
Workflow — это основная функция Zotero Agents, позволяющая комбинировать несколько шагов навыков в автоматизированные конвейеры обработки. Workflow определяет полную задачу: от получения ввода, обработки данных до создания вывода.
Структура Workflow
workflow.json (файл манифеста)
├── manifest: объявляет метаданные, версию, название
├── parameters: определяет настраиваемые параметры
├── inputs: определяет типы ввода (вложения, элементы, заметки и т.д.)
├── hooks: скрипты хуков JavaScript (фильтрация вводов, создание запросов, применение результатов)
└── provider: указывает требуемый тип бэкенда
Типы единиц ввода
| Тип | Описание |
|---|---|
attachment | Файлы вложений элемента |
parent | Родительский элемент выбранного элемента |
note | Элемент заметки |
workflow | Область пакетной обработки |
Система хуков
Workflow могут запускать пользовательские скрипты JavaScript на различных этапах выполнения:
- validateSelection: Декларативная фильтрация и проверка входных данных перед выполнением JavaScript-хуков
- preflight: Проверить разрешенную входную единицу, прикрепить контекст выполнения, пропустить, замкнуть на
applyResultили расширить один вход на несколько единиц запроса - buildRequest: Создание содержимого запроса, отправляемого бэкенду
- normalizeSettings: Нормализация пользовательских настроек
- applyResult: Применение результатов, возвращённых бэкендом, к Zotero
Три бэкенда выполнения
Workflow могут выполняться через три типа бэкендов:
| Бэкенд | Тип запроса | Сценарий использования |
|---|---|---|
| Skill-Runner | skill.run.v1 | Общее выполнение навыков, поддерживает интерактивный режим |
| ACP | acp.skill.run.v1 | Выполнение навыков через бэкенд ACP |
| Generic HTTP | generic-http.request.v1 | Вызовы HTTP API |
Официальный пакет Workflow
Официальные Workflow публикуются и устанавливаются как автономные пакеты, отделённые от самого плагина. Способы установки:
- Контекстное меню → Zotero Agents → 📦 Установить официальный пакет Workflow
- Нажмите Установить официальный пакет Workflow в Настройках
Официальные пакеты поддерживают три канала обновлений: stable / beta / dev. Плагин автоматически проверяет обновления при запуске.
Официальные Workflow
Плагин включает серию официальных Workflow, сгруппированных по функциям:
📚 Набор инструментов анализа литературы
| Workflow | Назначение | Ввод | Бэкенд | Документация |
|---|---|---|---|---|
| Анализ литературы ⭐ | Генерация дайджеста, ссылок, анализа цитирований из PDF/MD. Может каскадировать в регулировку тегов | Вложение | Skill-Runner | Подробности |
| Literature Metadata Curator | Запрос, исправление и дополнение библиографических метаданных элемента Zotero | Родительский элемент | Skill-Runner | Подробности |
| Literature Translator | Перевод академической литературы с управлением глоссарием и контролем качества | Вложение | Skill-Runner | Подробности |
| Интерактивный пояснитель литературы | Многократный диалог с ИИ для глубокого понимания литературы, с проверенными ответами для предотвращения галлюцинаций | Вложение | Skill-Runner | Подробности |
| Глубокое чтение | Генерация структурированного HTML-представления глубокого чтения с поддержкой перевода | Вложение | ACP | Подробности |
| Поиск и приём литературы | Позволить агенту искать академическую литературу и принимать напрямую в Zotero | workflow | ACP | Подробности |
| Collection Collector | Выбор существующей литературы из библиотеки для коллекции по объявленной области | workflow | ACP | Подробности |
| Export/Import Literature Bundle | Экспорт/импорт портативных ZIP-пакетов элементов Zotero с метаданными, вложениями и заметками | Родительский элемент / workflow | Бэкенд не требуется | Подробности |
| Export Research Bundle | Автоматическая сборка пакета исследования только для чтения для проекта из библиотеки и контекста Synthesis | workflow | Skill-Runner | Подробности |
| Tag Auditor | Сканирование всех элементов библиотеки по контролируемому словарю тегов и отчёт о соответствии | workflow | Бэкенд не требуется | Подробности |
| Tag Bootstrapper | Интерактивное создание контролируемого словаря тегов для исследовательской области | workflow | Skill-Runner | Подробности |
| Tag Regulator | Нормализация тегов на основе контролируемого словаря и вывод новых тегов | Родительский элемент | Skill-Runner | Подробности |
| Экспорт/Импорт заметок | Экспорт или импорт аналитических заметок с поддержкой редактирования и повторного импорта | Родительский элемент | Бэкенд не требуется | Подробности |
🛠️ Утилиты
| Workflow | Назначение | Ввод | Бэкенд | Документация |
|---|---|---|---|---|
| Разбор PDF MinerU | Вызов сервиса MinerU для разбора PDF в Markdown | Вложение | Generic HTTP | Подробности |
| Topic Synthesis | Трёхшаговый конвейер для создания анализа и отчётов синтеза тем | workflow | ACP | Подробности |
| Manuscript Literature Framing | Генерация черновиков LaTeX Introduction / Related Work | workflow | ACP | Подробности |
🔧 Инструменты отладки
| Workflow | Назначение | Бэкенд | Документация |
|---|---|---|---|
| Debug Probe | Тестирование и диагностика системы Workflow | Skill-Runner | Подробности |
Следующие шаги
- Вызов и настройка Workflow
- Конфигурация бэкендов — Подробные инструкции по настройке бэкендов