エージェント対応
固定されたコマンド文法と安定したJSONインターフェースにより、エージェントが内容を把握し、確実に利用できる一貫した操作体系を提供します。
一貫性
10以上のHarnessプロダクトで共通の文法を使用します。パイプラインで覚えたフラグを、コネクタ、シークレット、ポリシーでも同じように使えます。
スクリプト可能
すべてのコマンドに--format jsonを指定可能。グルーコードなしでjqに渡したり、ノートブックに取り込んだり、CIスクリプトに直接組み込めます。
パイプラインの実行、アーティファクトレジストリへの追加、Worker Agentsの実行など、どの操作でも同じ文法を使用できます。
一貫して予測可能。 新しいモジュールは名詞を追加するだけで、新しい動詞は追加されません。一度学べばどこでも使えます。
コマンド自身が使い方を説明。 list noun --matrixで動詞×名詞の全グリッドを表示。ドキュメントは不要です。
一貫したスコープ。 --level account | org | projectはすべての名詞で同じように動作します。
ランタイムで拡張可能。 CLIは各モジュールの仕様をランタイムで読み込みます。モジュール固有のコードパスは不要です。
構造化された予測可能な出力で、LLMのツール呼び出しに対応。トークン消費と必要なコンテキスト量を抑え、コストを削減します。
6つのコア動詞(list、get、create、update、delete、execute)ですべてのHarnessリソースを操作できます。一度覚えれば、どこでも同じように使えます。
Platform、Pipeline、CD、HAR、IACM、Code、Governance、Audit、GitOpsを1つの更新経路で管理できます。
list noun --matrixで動詞×名詞の全グリッドを表示。get noun <noun>でフィールド、フラグ、サンプルを取得できます。
すべてのコマンドで--format jsonが使用可能。フィールド名はリリース間で変わりません。jq、LLM、ノートブックに直接パイプできます。
bash、zsh、fish用のシェル補完が、実際のHarness APIを呼び出し、実際のパイプラインやサービス名を表示します。
harness install cliでバイナリをインプレースでアップグレード。パッケージマネージャーは不要です。すべてのモジュールで単一のバージョントレイン。
フラグ → 環境変数 → CIランナー環境 → 設定ファイルの順で資格情報を解決するため、同じバイナリが開発環境とCIの両方で変更なしに動作します。
エージェントも人と同じ文法を使います。コマンド体系を確認し、動詞を選び、コマンドを実行。出力はすべて構造化され、フラグの意味も一貫しています。
list noun --matrixはエージェントのコンテキスト用に構造化データとして全機能グリッドを返します
文法が固定されているため曖昧なコマンド体系がなく、エージェントが存在しないフラグを生成するリスクを抑えます
予測可能な終了コードとJSONインターフェースにより、LLMを問わずツール呼び出しの結果を安定して解析できます
はじめる
macOS(arm64/amd64)とLinux(amd64/arm64)に、1つのインストーラーで対応。
Homebrewサポートは近日公開予定です