エージェントハーネス構築 は何をしますか？
このスキルは、エージェントの計画立案、ツール呼び出し、エラーからの回復、および完了への収束を改善する際に使用します。
コアモデル
エージェントの出力品質は、以下によって制約されます。
- アクションスペースの品質
- 観測結果の品質
- 回復の品質
- コンテキスト予算の品質
アクションスペース設計
- 安定した明確なツール名を使用します。
- 入力はスキーマファーストで狭く保ちます。
- 決定論的な出力形状を返します。
- 分離が不可能でない限り、汎用的なツールは避けます。
粒度ルール
- 高リスク操作（デプロイ、マイグレーション、権限）にはマイクロツールを使用します。
- 一般的な編集/読み取り/検索ループにはミディアムツールを使用します。
- ラウンドトリップオーバーヘッドが支配的なコストとなる場合にのみ、マクロツールを使用します。
観測結果設計
すべてのツール応答には以下を含める必要があります。
status: success|warning|errorsummary: 一行の結果next_actions: 実行可能なフォローアップartifacts: ファイルパス / ID
エラー回復契約
すべてのエラーパスに対して、以下を含めます。
- 根本原因のヒント
- 安全なリトライ手順
- 明示的な停止条件
コンテキスト予算管理
- システムプロンプトは最小限で不変に保ちます。
- 大きなガイダンスはオンデマンドで読み込まれるスキルに移動します。
- 長いドキュメントをインライン化するよりも、ファイルへの参照を優先します。
- 任意のトークンしきい値ではなく、フェーズ境界で圧縮します。
アーキテクチャパターンガイダンス
- ReAct: 経路が不確かな探索的タスクに最適です。
- Function-calling: 構造化された決定論的フローに最適です。
- ハイブリッド（推奨）: ReAct計画 + 型付きツール実行。
ベンチマーク
以下を追跡します。
- 完了率
- タスクあたりのリトライ回数
- pass@1 と pass@3
- 成功タスクあたりのコスト
アンチパターン
- 意味が重複するツールが多すぎる。
- 回復ヒントのない不透明なツール出力。
- 次のステップのないエラーのみの出力。
- 無関係な参照によるコンテキストの過負荷。