Skip to main content
Nora 의 인과 그래프가 폴더별: 문서 폴더에 그래프 붙임, 그 문서에서 인과 트리플을 staged 영역으로 추출, 그 다음 live 로 승인. causal CLI 가 staged/live 워크플로우 표면. 그래프가 문서에서 부트스트랩; 좋은 트리플 승인; 승인된 (라이브) 것만 검증과 추론에 사용.

명령

폴더 식별자가 문서 폴더 태그 (예: billing, product-docs).

causal get

전체 그래프 인쇄:
  • live_nodeslive_edges — 검증과 추론에 사용.
  • staged_nodesstaged_edges — 리뷰 대기.
구조화 출력에 --json 추가. 흔한 빠른 체크:

causal settings show / set

설정 + 스테이지 카운트 표시.
넘긴 플래그만 변경.
  • --connection <kind:id> — 그래프를 특정 데이터 소스에 연결 (예: documents_folder:billing).
  • --retrieval-preset <preset-id> — 추출이 컨텍스트 끌어오는데 쓰는 프리셋.
  • --dedup-policy <policy> — 중복 처리 방식 (merge, keep_newer, keep_older, keep_all).
  • --auto-restage true|false — 연결된 소스 변경 시 자동 재-부트스트랩.

causal bootstrap

폴더의 모든 문서에서 인과 트리플을 STAGED 로 추출. approve 할 때까지 LIVE 로 아무것도 안 감.
  • --model <m> — 추출에 쓰는 모델. 워크스페이스 기본이 기본.
부트스트랩이 멱등 — 이미 채워진 폴더에 재실행이 LIVE 데이터 잃지 않음. 재추출이 새 STAGED 로우 생성; 기존 LIVE 는 그대로. 새 폴더: bootstrap → 앱에서 STAGED 영역 리뷰 → 좋은 것 승인. 기존 폴더: refresh 가 보통 원하는 것.

causal refresh

델타만 재계산 — 마지막 부트스트랩 이후 추가된 새 문서, 변경된 기존 문서. 전체 부트스트랩보다 저렴. Refresh 출력이 STAGED 에 착지. 기존 LIVE 그대로. --auto-restage 가 안 맞으면 스케줄로 (또는 문서 변경으로 트리거) 실행.

causal approve / reject

  • --ids <id,…> — 특정 스테이지 로우 ID. 모든 STAGED 액션은 생략.
approve 후:
  • 로우가 LIVE 로 이동.
  • 검증이 즉시 그것들 사용 시작.
  • STAGED 는 이 명령이 만지지 않은 것 여전히 담음.
reject 가 프로모트 없이 로우 드롭. 다음 부트스트랩이나 refresh 로 재생성 가능.

레시피

CLI 로 폴더 엔드투엔드 부트스트랩

CI: STAGED 너무 크면 실패

무제한 백로그 방지:

사람 리뷰 후 선택 승인

리뷰 워크플로우가 외부 시스템에서 로우 ID 로 승인 표시한다 가정. 벌크 승인:

감사용 LIVE 그래프 스냅샷

STAGED / LIVE 모델

인과 추출이 최선 노력이라 두 스테이지 모델 존재 — 모델이 제안, 여러분이 처리. LIVE 직접 편집이 CLI 에서 허용 안 됨 (그건 앱의 그래프 캔버스 사용). 하지만 벌크 승인/거부가 CLI 가 위한 것. 라이브 그래프 손 편집 원하면 — 특정 엣지 추가, 잘못된 노드 제거 — 앱에서. CLI 의 역할은 벌크 부트스트랩/refresh/승인.

관련