nora documents 는 라이브러리 CRUD 전체를 감쌉니다. 업로드(단일 파일·큰 파일·폴더 배치), 외부 URL 등록, 메타데이터 패치(시점 인지 검색용 규정 날짜), 청크 조회, 태그, supersede, 삭제까지.
명령 그룹
- 읽기:
list,get,chunks,chunk-text,extracted-text - 인제스트:
upload,upload-large,upload-folder,create-external - 수정:
tag,update,supersede,delete - KG 접목:
extract-structure
읽기
list
--tag 는 한 라이브러리 폴더로 좁힙니다. 스크립트용은 --json.
get
chunks
--preview 는 ~200자로 자르고(또는 --preview-len <N>), --q 는 청크 텍스트 안에서 자유 검색을 겁니다.
chunk-text
extracted-text
null 입니다.
인제스트
upload: 인라인
--mime 선택(기본 application/octet-stream), --name 선택(기본은 파일 basename), --tags 로 폴더 태그를 붙입니다.
upload-large: S3 presigned
NORA_S3_BUCKET 이 설정되어 있어야 하고, 없으면 명확한 에러가 납니다. ~45MB 이상에 씁니다.
upload-folder: 폴더 배치
--presigned 는 S3 경로를 강제합니다(테넌트가 인라인 페이로드를 제한하거나 네트워크가 직접 S3 PUT 을 선호할 때). 파일마다 진행 라인, 마지막에 요약을 출력합니다. 파일 단위로 idempotent합니다. 배치 도중 실패해도 다시 돌리면 남은 것만 올립니다.
create-external: URL 참조
storage_kind='external'). Nora 가 URL 을 참조만 하고, 바이트를 복사하지 않습니다.
수정
tag
--add · --remove 둘 다 선택(적어도 하나는 필수).
update: 메타데이터 패치
--set-<field> 로 세팅, --clear-<field> 로 null, 안 넘기면 그대로입니다.
필드:
--set-name / --clear-...--set-published-at <YYYY-MM-DD>발행일.--set-effective-at <YYYY-MM-DD>효력 시작일 (G1as_of검색용).--set-effective-until <YYYY-MM-DD>효력 종료일(배타적). 이 값이 지나면 새 버전이 우선이지만 이전 계약은 이전as_of값에 여전히 매칭됩니다. NULL / 클리어 = 현재도 유효.--set-issuer <text>발행처.--set-revision <text>버전 라벨.
effective_at · effective_until 짝이 시점 인지 리트리벌 을 굴리는 열쇠입니다. 규정·날짜가 있는 문서에 세팅해 두면 as_of 쿼리가 알맞은 버전에 떨어집니다.
supersede
version_misrank 리트리벌 수정(loop-spec §F.2). --restore 가 되돌립니다.
삭제보다 supersede 를 권합니다. 되돌릴 수 있고 감사 트레일이 남습니다.
delete
KG 접목
extract-structure
--kg-instance 를 비우면 문서 이름으로 새 KG 를 만듭니다.
레시피
Dropbox 익스포트 통째로 인제스트
문서 묶음을 한 폴더에서 다른 폴더로 옮기기
이미 인제스트된 약관에 규정 날짜 백필
policy-dates.tsv 는 한 줄에 doc_id<TAB>YYYY-MM-DD.
문서 메타데이터를 git 에 스냅샷
태그 커버리지 감사
폴더 안 모든 문서의 첫 청크 미리 보기
문서 ID 가 오는 곳
- 앱 라이브러리의 문서마다 세부 패널에 ID
- Foundry 로그
pipelines logs get이 실행이 만든 문서 ID 를 표시 documents list스크립트용