Orchestrator 설정

파일 위치

Vault 루트의 orchestrator.yaml

Orchestrator 설정

orchestrator:
  prompts_dir: "_Settings_/Prompts"   # 프롬프트 파일 위치
  tasks_dir: "_Settings_/Tasks"       # 작업 파일 위치
  logs_dir: "_Settings_/Logs"         # 로그 파일 위치
  max_concurrent: 3                    # 전역 동시 실행 수
  poll_interval: 1.0                   # 이벤트 큐 폴링 간격 (초)

전역 기본값

defaults:
  executor: claude_code      # 기본 실행 엔진
  timeout_minutes: 30        # 기본 타임아웃
  max_parallel: 3            # Agent별 동시 실행 수
  task_create: true          # 작업 파일 생성 여부

설정값 상세 설명

max_concurrent vs max_parallel:

설정	범위	설명
`max_concurrent`	전역	시스템 전체에서 동시에 실행 가능한 Agent 총 수
`max_parallel`	Agent별	동일한 Agent가 동시에 처리할 수 있는 Task 수

# 예: max_concurrent=3, max_parallel=2인 경우
# Agent A가 2개 Task 실행 중이면, 다른 Agent는 최대 1개만 실행 가능

task_create 사용 가이드:

값	사용 시기
`true`	실행 결과 추적 필요, 재실행 가능성 있음, 디버깅 필요
`false`	빠른 처리 우선, 로깅 불필요, 디스크 공간 절약

poll_interval 권장값:

값	사용 시기
`1.0~2.0`	실시간 반응 필요 (파일 감시)
`5.0`	일반 사용
`30.0+`	배치 작업, 리소스 절약

Agent 설정

기본 Agent

nodes:
  - type: agent
    name: Enrich Ingested Content (EIC)
    input_path: Ingest/Clippings
    output_path: AI/Articles

명시적 prompt 필드

Agent 이름에서 약어를 추출하는 대신 prompt 필드를 명시적으로 지정할 수 있습니다. 동일한 프롬프트를 여러 Agent가 공유할 때 유용합니다.

- type: agent
  name: Search Pilot Eval - Gemini Results
  prompt: SPE    # 명시적 프롬프트 참조
  input_path: Eval/Results/Gemini
  output_path: Eval/Evals/Gemini

Multi-Worker 실행

하나의 입력을 여러 AI 모델(executor)이 동시에 처리할 수 있습니다. 모델 비교/평가에 유용합니다.

- type: agent
  name: Search Pilot Task
  prompt: SPT
  input_path: Eval/Tasks
  workers:
    - executor: gemini_cli
      label: Gemini
      output_path: Eval/Results/Gemini
    - executor: codex_cli
      label: Codex
      output_path: Eval/Results/Codex

Multi-Worker 활용 사례

사례 1: 모델 품질 비교

동일한 아티클을 여러 AI 모델이 요약하여 품질을 비교합니다.

- type: agent
  name: Article Summary Comparison
  prompt: EIC
  input_path: Ingest/Articles
  workers:
    - executor: gemini_cli
      label: Gemini
      output_path: AI/Summary/Gemini
    - executor: claude_code
      label: Claude
      output_path: AI/Summary/Claude

사례 2: 멀티 에이전트 리뷰

하나의 초안을 여러 관점에서 검토합니다.

- type: agent
  name: Draft Review
  prompt: DRV
  input_path: Drafts
  workers:
    - executor: gemini_cli
      label: Technical
      agent_params:
        review_focus: "technical accuracy"
    - executor: claude_code
      label: Editorial
      agent_params:
        review_focus: "clarity and style"

설정 필드 참조

필드	타입	기본값	설명
`name`	string	필수	Agent 이름
`prompt`	string	name에서 추출	프롬프트 파일 참조 (ABBR)
`input_path`	string/list	[]	입력 디렉토리
`input_type`	string	new_file	Trigger 타입 (new_file, updated_file, manual)
`output_path`	string	""	출력 디렉토리
`output_type`	string	new_file	출력 타입 (new_file, update_file)
`executor`	string	claude_code	실행 엔진
`max_parallel`	int	3	Agent별 동시 실행 수
`timeout_minutes`	int	30	실행 타임아웃
`cron`	string	null	스케줄 실행 (cron 표현식)
`workers`	list	[]	Multi-Worker 설정

Worker 설정 필드

필드	타입	설명
`executor`	string	Worker 실행 엔진
`label`	string	Worker 라벨 (출력 파일명에 포함)
`output_path`	string	Worker별 출력 디렉토리
`agent_params`	dict	Worker별 추가 파라미터

Poller 설정

pollers:
  limitless:
    enabled: true
    target_dir: "Ingest/Limitless"
    poll_interval: 3600    # 폴링 간격 (초)
    start_days_ago: 7      # 시작 날짜 범위

  apple_photos:
    enabled: false
    target_dir: "Ingest/Photolog"
    poll_interval: 3600
    days: 7

참조

(0) Orchestrator 개요 - 아키텍처 개요
용어 사전 - 용어 정의

학습 경로

이전	현재	다음
(3) Agent Skill 가이드	Orchestrator 설정	(5) CLI 명령어 가이드

관련 문서:

(0) 실전 가이드 개요 - 전체 시작 가이드
(3) Agent Skill 가이드 - 스킬 가이드