AIエージェント開発における用語統一の重要性

Hugging Face チームが公開した最新のAIエージェント用語集は、急速に進化する分野で混乱しがちな概念を整理し、実践的な開発指針を提供している。特に「ハーネス」と「スキャフォールディング」の区別は、エージェント開発者が直面する設計上の課題を解決する鍵となる。

ICLR 2026での議論を受けて作成されたこの用語集は、Claude Code、Codex、Hermes Agentなどの実際のプロダクトで使われている概念を統一的に説明している。開発者は今日からこれらの定義を使って、チーム内でのコミュニケーションを改善し、より効率的なエージェント設計を実現できる。

（出典: Harness, Scaffold, and the AI Agent Terms Worth Getting Right）

モデルとハーネスの技術的関係

モデル自体は単純にテキストを入力として受け取り、テキストを出力するLLM（Claude、Qwen、GPT、Kimi、DeepSeekなど）である。モデル単体では呼び出し間でのメモリ機能がなく、ループ処理も行わない。

ハーネスは、モデルがツール呼び出しの意図を表現した際に、それを実際に実行する役割を担う。Claude Codeの公式ドキュメントでは「Claude Code serves as the agentic harness around Claude」と明記されており、モデル以外のすべての要素をハーネスと呼んでいる。

この区別により、開発者はモデルの能力とインフラストラクチャの責任範囲を明確に分離できる。モデルは推論を担当し、ハーネスは実行環境とツール統合を管理するという役割分担が可能になる。

（出典: Harness, Scaffold, and the AI Agent Terms Worth Getting Right）

スキャフォールディングによる動作制御

スキャフォールディングは、モデルの周囲にある動作定義レイヤーとして機能する。具体的には、システムプロンプト、ツール記述、モデルレスポンスの解析方法、ステップ間で記憶する内容（コンテキスト管理）を含む。

この層は、訓練時と推論時の両方において、モデルが世界をどう認識し、どう行動するかを形作る。開発者は、スキャフォールディングの設定を調整することで、エージェントの振る舞いを細かく制御できる。

スキャフォールディングとハーネスの区別は、特に訓練パイプラインにおいて重要になる。それぞれを独立して推論する必要がある場合、この概念的分離が設計の明確性をもたらす。フック、リソース管理、その他のインフラストラクチャ要素も、広義のスキャフォールディングに含まれる場合がある。

（出典: Harness, Scaffold, and the AI Agent Terms Worth Getting Right）

まとめ

  • Hugging Face の用語集を参考にして、チーム内でのエージェント開発用語を統一すれば、設計議論の効率性と技術仕様の明確性を向上させることができる
  • モデルとハーネスの役割分離を意識した設計により、推論処理とツール実行環境を独立してスケールさせる柔軟なアーキテクチャを構築できる
  • スキャフォールディング層の設定パラメータを体系的に管理することで、同一モデルから異なる用途のエージェントを効率的に派生させる開発プロセスを確立できる