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

環境設定

Zotero Agentsの設定はZotero → 設定 → Zotero Agents（Windows/Linux）またはZotero → 環境設定 → Zotero Agents（macOS）に配置されている。

Workflow設定​

Workflowディレクトリ​

  • パス: Workflowを格納するカスタムディレクトリ
  • デフォルト場所: <Zotero Data>/zotero-agents/data/workflows
  • Workflowをスキャン: ボタンをクリックしてディレクトリを再スキャンし、すべてのWorkflowをロード

Skillディレクトリ​

  • パス: Skillパッケージを格納するカスタムディレクトリ
  • スキャン: ボタンをクリックしてディレクトリをスキャンし、Skillをロード

公式Workflowパッケージ​

公式Workflowは独立したコンテンツパッケージとして配布され、プラグイン本体からは切り離されている。

Workflow設定ページ

設定タイプ説明
公式WorkflowパッケージをインストールボタンGitHub / Giteeから最新の公式パッケージをダウンロードしてインストール
更新を確認ボタンリモートで新バージョンが利用可能かを確認
ステータステキスト現在インストールされているパッケージのバージョンとチャネル情報を表示

公式Workflowパッケージの内容

更新チャネル​

3つの更新チャネルから選択できる。

チャネル説明
stable安定版リリース（推奨）
betaベータリリース。今後の機能を含む
dev開発リリース。最新の実験的変更を含む

チャネルを切り替えた後、更新を確認をクリックしてそのチャネルの最新パッケージを取得する。

実行時設定​

  • Skill実行フィードバックを有効にする: 有効にすると、スキル実行はMarkdownフィードバックサイドカーを書き込める。これらはダッシュボードのSkillフィードバックパネルで収集される

Host Bridge​

外部のAIツールやCLIがZoteroライブラリにアクセスするための組み込みHTTPサービスである。詳細はHost Bridgeを参照。

設定タイプ説明
MCPサーバーを有効にするブール値MCPプロトコルインターフェースも公開する
書き込み承認を無効にするブール値危険：すべての書き込み承認をバイパスする
LANアクセスを有効にするブール値LANアクセスを許可する
固定ポートブール値ランダムポートではなく固定ポートを使用する
ポート番号数値固定ポート値（デフォルト26570）
LAN IP文字列通知するIPを手動で指定（空欄で自動検出）

Host Bridge設定ページ

アクションボタン：

  • スタート/エンドポイントを表示: サービスを開始し、エンドポイントURLを表示
  • トークンをローテーション: セッショントークンをローテーション
  • マスタートークンを作成/ローテーション: 永続トークンを生成
  • マスタートークンをコピー: クリップボードにコピー
  • リモートCLIプロファイルをコピー: リモート接続設定を取得
  • CLIをインストール: zotero-bridgeをワンクリックでインストール

Host Bridge危険なアクションエリアを展開

SkillRunnerローカルバックエンド​

⚠️ このモードは、エージェントツールのインストールに全く馴染みがなく、Dockerも使用できないユーザーにのみ適している。ACPエージェントがすでにあるか、Dockerを使用できる場合は、ACPバックエンドまたはDockerデプロイのSkill-Runnerを優先されたい。

ローカルSkill-Runnerはプラグインの開始/停止とともに起動・停止する。Zoteroを閉じるとすべてのタスクが終了する。実行時管理機能は以下の通りである。

機能説明
ワンクリックデプロイSkill-Runnerランタイムの最新版をダウンロードしてインストール
スタートローカルSkill-Runnerプロセスを起動
ストップ実行中のローカルSkill-Runnerを停止
アンインストールインストールされたランタイムファイルを削除
管理UIを開くプラグイン内でバックエンド管理インターフェースを開く
Skillsフォルダを開くSkillファイルが格納されているディレクトリを開く
モデルキャッシュを更新バックエンドのモデルリストキャッシュをアップデート
デバッグコンソールを開くバックエンドのログ出力を表示

SkillRunnerローカルバックエンド設定ページ

バックエンドマネージャー​

すべてのバックエンドプロファイルを管理する。

  • プロバイダ別にグループ化（SkillRunner、ACP、Generic HTTP）
  • バックエンドの追加・編集・削除
  • 各バックエンドは以下を設定可能：ID、Base URL、Bearer Token、タイムアウト

WebDAV同期​

Synthesis Workbenchのデバイス間同期ソリューション。非推奨となったGit Syncに代わるものである。詳細はWebDAV同期を参照。

設定タイプデフォルト説明
WebDAV同期を有効にするブール値falseメインスイッチ
Base URL文字列""WebDAVサーバーアドレス
リモートパス文字列"zotero-agents"リモートディレクトリパス
ユーザー名文字列""WebDAVユーザー名
パスワード/トークン暗号化""パスワードまたはアプリトークン（AES-256-GCM暗号化）
自動同期ブール値false各変更後に自動的に同期をトリガー
自動リトライブール値false失敗時に自動的にリトライ

アクションボタン：設定を保存、認証情報を保存、接続テスト。

WebDAV同期設定ページ

実行時データ​

永続化ルートディレクトリ、実行時の使用量、整合性診断を表示する。

  • 永続化ルート: <Zotero Data>/zotero-agents/data/
  • Synthesis正規ストア: ローカルSQLite + 永続パッケージ
  • ディレクトリサイズ: data/、cache/、logs/、tmp/など
  • 診断パネル: ファイルシステムの問題を検出（WALファイルの未クリーンアップなど）

注：Synthesis正規ストアとステータスデータベースは診断専用であり、ここからクリーンアップはできない。

実行時データと永続化管理ページ

一般オプション​

  • デフォルトバックエンド: 使用するデフォルトのバックエンドインスタンスを選択
  • ローカルバックエンドを自動開始: Zotero起動時にSkill-Runnerを自動的に開始
  • ログレベル: ログレベルを設定
  • 組み込みMarkdownリーダーを有効にする: チェックすると、.md添付ファイルをダブルクリックした際に組み込みリーダーで開く。チェックを外すと、システムのデフォルトオープナーが復元される（デフォルトで有効）

設定ナビゲーションパス​

Zotero → 設定 → Zotero Agents
├── Workflow設定
│   ├── Workflowディレクトリ
│   ├── Skillディレクトリ
│   ├── 公式Workflowパッケージ
│   └── 実行時設定
├── Host Bridge
│   ├── サービスの開始/停止
│   ├── ネットワークとポート
│   └── トークン管理
├── SkillRunnerローカルバックエンド
├── バックエンドマネージャー
├── WebDAV同期
├── 実行時データ
└── 一般オプション