CLI-Anything OpenRefine은(는) 무엇을 하나요?
에이전트 워크플로우에서 OpenRefine 데이터 정제, 변환, 재사용 가능한 작업 내역, 또는 CSV/TSV 내보내기가 필요한 작업에 이 스킬을 사용하세요.
전제 조건
하네스 설치:
cd openrefine/agent-harness
python -m pip install -e .
백엔드 명령어를 실행하기 전에 OpenRefine을 시작합니다:
openrefine -i 127.0.0.1 -p 3333
OPENREFINE_URL=http://127.0.0.1:3333 환경 변수를 설정하거나 --base-url 플래그로 사용자 정의 서버를 지정하세요.
에이전트 명령어 규칙
- 단발성 명령에는 항상
--json을 선호하세요. - 격리된 작업 상태를 위해
--session <경로>를 사용하세요. - 행 조회, 적용, 내보내기, 실행 취소, 재실행 명령어보다 먼저 프로젝트를 가져오거나 여세요.
- 기존 OpenRefine 작업 내역 JSON 파일을
data apply명령어에 직접 전달할 수 있습니다. - 생성된 파일은 일반 OpenRefine 작업 JSON 및 내보내기 CSV/TSV 데이터입니다.
일반 명령어
cli-anything-openrefine --json server ping
cli-anything-openrefine --json project list
cli-anything-openrefine --json --session run/session.json project import messy.csv --name cleanup
cli-anything-openrefine --json --session run/session.json data rows --limit 10
cli-anything-openrefine --json ops text-transform run/trim.json --column Name --expression 'value.trim()'
cli-anything-openrefine --json --session run/session.json data apply run/trim.json
cli-anything-openrefine --json --session run/session.json data export run/clean.csv --format csv
cli-anything-openrefine --json --session run/session.json session undo
cli-anything-openrefine --json --session run/session.json session redo
REPL
서브커맨드 없이 cli-anything-openrefine을 실행하면 REPL이 시작됩니다.
자동화된 사용자 과정의 경우, 개행 문자로 구분된 REPL 명령어를 stdin을 통해 파이프로 전달하세요. 리다이렉트된 스트림은 자동으로 ASCII 전용 입출력 경로를 사용하며, 대화형 터미널은 유니코드 배너, 명령어 히스토리, 스타일링을 유지합니다:
printf 'help\nexit\n' | cli-anything-openrefine
REPL이 리다이렉트되면 유니코드 페이로드는 가역적인 ASCII 백슬래시 이스케이프로 변환되어, 레거시 Windows 출력 인코딩이 성공적인 명령어를 실패로 바꾸는 것을 방지합니다.
파이프 워크플로우는 exit 또는 EOF 시점에 명령어 중 하나라도 실패하면 0이 아닌 종료 상태를 반환하여 CI가 실패한 사용자 과정을 감지할 수 있도록 합니다.
오류 처리
--json이 설정된 경우, 명령어 실패 시 ok: false를 포함하는 JSON 객체가 stderr로 출력됩니다.