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 <path>を使用します。 - 行操作、適用、エクスポート、アンドゥ、リドゥのコマンドの前にプロジェクトをインポートまたは開きます。
- 既存の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のみの入出力パスを使用し、インタラクティブターミナルではUnicodeバナー、プロンプト履歴、スタイルが保持されます:
printf 'help\nexit\n' | cli-anything-openrefine
REPLがリダイレクトされた場合、Unicodeペイロードは可逆的なASCIIバックスラッシュエスケープとしてレンダリングされ、レガシーなWindows出力エンコーディングによって成功したコマンドが失敗に変わらないようにします。
パイプ処理されたワークフローは、exit またはEOF時にいずれかのコマンドが失敗した場合、ゼロ以外の終了ステータスを返すため、CIが失敗したユーザージャーニーを検出できます。
エラーハンドリング
--json が設定されている場合、コマンド失敗時に ok: false を含むJSONオブジェクトがstderrに書き込まれます。