인과 트리 엔진

인과 트리 엔진 (Causal Tree Engine, CTE)은 최종 응답을 커밋하기 전에 여러 응답 전략을 병렬로 평가하는 투기적 실행 시스템입니다. PRX 에이전트 파이프라인에서 인텐트 분류와 LLM 호출 사이에 통합됩니다.

기본적으로 비활성화됨. CTE는 옵트인 기능입니다. 설정 파일에서 causal_tree.enabled = true로 활성화하세요.

작동 흐름

스냅샷 → 확장 → 리허설 → 스코어링 → 선택 → 피드백

1. 스냅샷 — 현재 인과 상태 캡처 (세션 컨텍스트, 예산, 제약 조건)
2. 확장 — 후보 분기 생성 (직접 응답, 도구 사용, 하위 에이전트 위임 등)
3. 리허설 — 유망한 분기의 경량 "드라이 런"을 읽기 전용 모드로 실행
4. 스코어링 — 신뢰도, 비용, 지연 시간의 가중 복합으로 분기 순위 지정
5. 선택 — 최고 점수 분기가 임계값을 충족하면 커밋, 그렇지 않으면 폴백
6. 피드백 — 관측 가능성 및 향후 학습을 위해 결정 로그 기록

CTE 활성화 시기

시나리오	권장 사항
단순 Q&A, 캐주얼 채팅	CTE 비활성화 유지
다단계 도구 사용 워크플로	CTE 활성화
자율 에이전트 작업 (Xin / 자기 진화)	CTE 활성화
비용 민감 배포	CTE 활성화 및 extra_token_ratio_limit 엄격 설정

빠른 시작

PRX 설정 파일 (~/.openprx/config.toml)에 추가:

[causal_tree]
enabled = true

다른 모든 매개변수에는 합리적인 기본값이 있습니다. 전체 매개변수 목록은 설정 레퍼런스를 참조하세요.

서킷 브레이커

• circuit_breaker_threshold회 연속 실패 후 (기본값: 5회), CTE가 트립되고 모든 요청이 바이패스
• circuit_breaker_cooldown_secs (기본값: 60초) 후 서킷 브레이커가 재시도 허용
• 1회 성공으로 실패 카운터 리셋

메트릭

메트릭	설명
hit_at_1_ratio	1순위 분기가 정답이었던 비율
hit_at_3_ratio	정답 분기가 상위 3개에 포함된 비율
wasted_speculation_ratio	실행되었지만 사용되지 않은 리허설 비율
commit_success_rate	커밋 성공률
avg_extra_latency_ms	실행당 평균 추가 지연 시간
circuit_breaker_trips	서킷 브레이커 트립 횟수

관련 페이지

• 설정 레퍼런스
• 에이전트 런타임
• LLM 라우터
• 관측 가능성