Agent SDKを使って独自のハーネスを構築する | OpenRouter

OpenRouterは、独自のエージェントハーネスを構築するための2つのスキルを発表しました。1つはcreate-agent-tuiで、ターミナルUIを備えたプロジェクトを生成します。もう1つはcreate-headless-agentで、CLIツールやAPIサーバー、キュー作業などのためのヘッドレスエージェントを生成します。

これらのスキルは、最近リリースされたAgent SDKを基盤としています。SDKはcallModel関数を提供し、モデル呼び出し、ツール実行、マルチターンサイクル、ストリーミング、コスト追跡を含むエージェントループ全体を処理します。開発者はループ管理コードを書く必要がなく、アプリ固有の部分に集中できます。

使用方法は簡単です。OpenRouter APIキーを取得し、コーディングエージェント（Claude Code、Codexなど）にスキルをインストールします。例えば、gh skill install OpenRouterTeam/skills create-agent-tuiを実行します。そして、エージェントに構築したいアシスタントの説明を伝えると、完全なTypeScriptプロジェクトが生成されます。生成されたプロジェクトは、TUI版の場合はpnpm install && pnpm startで起動できます。

カスタマイズに関して、create-agent-tuiはインタラクティブなチェックリストを提供します。ユーザーはサーバーツール（ウェブ検索、日時）、ローカルツール（ファイル読み書き、grep、シェルなど）、ハーネスモジュール（セッション永続化、コンテキスト圧縮、ツール承認ゲート）、スラッシュコマンドを選択できます。ターミナルUIのあらゆる部分（ツール表示スタイル、入力スタイル、ローダーアニメーション、ASCIIバナー）をカスタマイズ可能です。また、直接希望を説明すれば、スキルがカスタムスタイルを生成します。

生成されたプロジェクトはユーザーが自由に変更できます。ドメイン固有のツールを追加したり、異なるエントリポイント（HTTP APIサーバーのテンプレートも含まれています）を設定したり、コンテキスト圧縮を追加して長い会話に対応したり、必要最小限に削減したりできます。

ヘッドレスエージェントスキルは同じアーキテクチャを採用していますが、TUI層が完全に取り除かれています。生成されたCLIは、--prompt引数またはパイプ経由で入力を受け付け、プレーンテキスト、NDJSONイベントストリーム、または終了コードのみを出力します。プロダクション利用に特に適した2つの機能があります。1つは安全なリトライで、ツール呼び出しがまだ実行されていない場合、429や5xxエラーに対して指数バックオフでリトライします。ミューテーションツールが実行された後はリトライをスキップし、副作用を防ぎます。もう1つは構造化出力で、JSON Schemaファイルを渡すとCLIがエージェントの最終応答を検証し、検証失敗時はコード2で終了します。

OpenRouterによると、これらのスキルのデザインはpi-mono、Claude Code、Codex CLIなどのプロダクション環境でのエージェントアーキテクチャからインスピレーションを得ています。詳細なAPIリファレンスやガイドは公式ドキュメントで確認できます。