본문으로 건너뛰기

Workflow 개요

Workflow란?​

Workflow는 Zotero Agents의 핵심 기능으로, 여러 스킬 단계를 자동화된 처리 파이프라인으로 결합할 수 있습니다. Workflow는 하나의 완전한 작업을 정의합니다. 입력 수신, 데이터 처리, 출력 생성까지 전 과정을 포함합니다.

Workflow 구조​

workflow.json (manifest 파일)
├── manifest: 메타데이터, 버전, 이름 선언
├── parameters: 설정 가능한 파라미터 정의
├── inputs: 입력 유형 정의 (첨부파일, 항목, 노트 등)
├── hooks: JavaScript 훅 스크립트 (입력 필터링, 요청 빌드, 결과 적용)
└── provider: 필요한 백엔드 유형 지정

입력 단위 유형​

유형설명
attachment항목의 첨부파일
parent선택된 항목의 상위 항목
note노트 항목
workflow일괄 처리 범위

훅 시스템​

Workflow는 실행의 여러 단계에서 사용자 정의 JavaScript 스크립트를 실행할 수 있습니다.

  • validateSelection: JavaScript 훅이 실행되기 전에 입력을 선언적으로 필터링하고 검증합니다
  • preflight: 해결된 입력 유닛을 검사하고, 실행 컨텍스트를 첨부하고, 건너뛰거나, applyResult로 단락하거나, 하나의 입력을 여러 요청 유닛으로 확장합니다
  • buildRequest: 백엔드로 전송할 요청 콘텐츠를 빌드합니다
  • normalizeSettings: 사용자 설정을 정규화합니다
  • applyResult: 백엔드에서 반환된 결과를 Zotero에 적용합니다

세 가지 실행 백엔드​

Workflow는 세 가지 백엔드 유형을 통해 실행할 수 있습니다.

백엔드요청 유형사용 사례
Skill-Runnerskill.run.v1일반 스킬 실행, 인터랙티브 모드 지원
ACPacp.skill.run.v1ACP 백엔드를 통한 스킬 실행
Generic HTTPgeneric-http.request.v1HTTP API 호출

공식 Workflow 패키지​

공식 Workflow는 플러그인 자체와 분리된 독립 패키지로 게시 및 설치됩니다. 설치 방법:

  • 마우스 오른쪽 메뉴 → Zotero Agents → 📦 공식 Workflow 패키지 설치
  • 환경설정에서 공식 Workflow 패키지 설치 클릭

공식 패키지는 세 가지 업데이트 채널을 지원합니다: stable / beta / dev. 플러그인은 시작 시 자동으로 업데이트를 확인합니다.

공식 Workflow​

플러그인은 기능별로 그룹화된 일련의 공식 Workflow를 포함합니다:

📚 문헌 분석 툴킷​

Workflow목적입력백엔드문서
Literature Analysis ⭐PDF/MD에서 다이제스트, 참고문헌, 인용 분석을 생성합니다. 태그 규제로 연속 실행 가능첨부파일Skill-Runner상세
Literature Metadata CuratorZotero 항목의 서지 메타데이터를 쿼리, 수정 및 보완상위 항목Skill-Runner상세
Literature Translator용어집 관리 및 품질 게이트로 학술 문헌 번역첨부파일Skill-Runner상세
Interactive Literature Explainer문헌 심층 이해를 위한 AI와의 다중 턴 대화, 환각 방지를 위한 검증된 답변 제공첨부파일Skill-Runner상세
Deep Reading번역 지원 포함 구조화된 심층 독서 HTML 보기를 생성합니다첨부파일ACP상세
Literature Search & IngestAI가 학술 문헌을 검색하여 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 파싱MinerU 서비스를 호출하여 PDF를 Markdown으로 파싱합니다첨부파일Generic HTTP상세
Topic Synthesis토픽 통합 분석 및 보고서를 생성하는 3단계 파이프라인workflowACP상세
Manuscript Literature Framing서론 / 관련 작업 LaTeX 초안을 생성합니다workflowACP상세

🔧 디버그 도구​

Workflow목적백엔드문서
Debug ProbeWorkflow 시스템 개발 테스트 및 진단Skill-Runner상세

다음 단계​