メインコンテンツまでスキップ

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への短絡、または1つの入力を複数のリクエストユニットに展開します
  • buildRequest: バックエンドに送信するリクエストコンテンツを構築
  • normalizeSettings: ユーザー設定を正規化
  • applyResult: バックエンドから返された結果をZoteroに適用

3つの実行バックエンド​

Workflowは3つのバックエンドタイプを通じて実行できます。

バックエンドリクエストタイプ用途
Skill-Runnerskill.run.v1一般的なスキル実行、インタラクティブモードに対応
ACPacp.skill.run.v1ACPバックエンド経由のスキル実行
Generic HTTPgeneric-http.request.v1HTTP API呼び出し

公式Workflowパッケージ​

公式Workflowはスタンドアロンパッケージとして公開・インストールされ、プラグイン本体とは切り離されています。インストール方法:

  • 右クリックメニュー → Zotero Agents → 📦 Install Official Workflow Package
  • 環境設定でInstall Official Workflow Packageをクリック

公式パッケージは3つのアップデートチャネルに対応しています: stable / beta / dev。プラグインは起動時に自動的にアップデートをチェックします。

公式Workflow​

プラグインには機能別にグループ化された一連の公式Workflowが含まれています:

📚 文献分析ツールキット​

Workflow目的入力バックエンドドキュメント
Literature Analysis ⭐PDF/MDからダイジェスト、参考文献リスト、引用分析を生成。タグ正規化へカスケード可能添付ファイルSkill-Runner詳細
Literature Metadata CuratorZotero アイテムの書誌メタデータをクエリ、修正、補完親アイテムSkill-Runner詳細
Literature Translator用語集管理と品質ゲート付きで学術文献を翻訳添付ファイルSkill-Runner詳細
Interactive Literature ExplainerAIとのマルチターン対話による文献の深い理解、検証済み回答で幻覚を防止添付ファイルSkill-Runner詳細
Deep Reading翻訳サポート付きの構造化された深読HTMLビューを生成添付ファイルACP詳細
Literature Search & Ingestエージェントに学術文献を検索させ、Zoteroに直接取り込むworkflowACP詳細
Collection Collector宣言されたスコープに基づき既存コレクション用にライブラリから既存文献を選択workflowACP詳細
Export/Import Literature Bundleメタデータ、添付ファイル、ノート付き Zotero アイテムのポータブル ZIP バンドルをエクスポート/インポート親アイテム / workflowバックエンド不要詳細
Export Research Bundleライブラリと Synthesis コンテキストから論文プロジェクトの読み取り専用リサーチバンドルを自動構成workflowSkill-Runner詳細
Tag Auditorライブラリの全アイテムを統制タグ語彙に対してスキャンし適合性を報告workflowバックエンド不要詳細
Tag Bootstrapper研究ドメインの統制されたタグ語彙を対話的に作成workflowSkill-Runner詳細
Tag Regulator統制語彙に基づいてタグを正規化し、新しいタグを推論親アイテムSkill-Runner詳細
Export/Import Notes分析ノートのエクスポート・インポート、編集と再インポートに対応親アイテムバックエンド不要詳細

🛠️ ユーティリティ​

Workflow目的入力バックエンドドキュメント
MinerU PDF ParsingMinerUサービスを呼び出してPDFをMarkdownに解析添付ファイルGeneric HTTP詳細
Topic Synthesisトピック統合分析とレポートを作成する3ステップのパイプラインworkflowACP詳細
Manuscript Literature FramingIntroduction / Related WorkのLaTeXドラフトを生成workflowACP詳細

🔧 デバッグツール​

Workflow目的バックエンドドキュメント
Debug ProbeWorkflowシステムの開発テストと診断Skill-Runner詳細

次のステップ​