HuggingFace、AIエージェント用語集を公開、ハーネスなど13概念を整理

Hugging FaceがAIエージェント開発向けの用語集を公開し、「スキャフォールド」「ハーネス」など13の基本概念を体系的に定義した
Claude CodeやOpenAI Codexとは異なる定義を持つ用語も明示され、複数ツールを横断して開発する際の参照資料として活用できる
モデル本体から強化学習・評価に至るまで、エージェント構築の全体像を4つの観点から整理している

用語の定義が開発者間でバラバラだった

AIエージェントの開発が急速に普及する中、「スキャフォールド」「ハーネス」といった用語の意味がツールや組織によって異なる問題が表面化していた。ある開発者のいう「ハーネス」と別の開発者のいう「ハーネス」が同じ概念を指すとは限らず、チームをまたいだ設計議論や技術文書の読み解きに余分なコストが生じていた。

こうした状況を受けてHugging Faceは2025年6月、AIエージェント構築に必要な13の用語をまとめた用語集を公開した。各概念の定義を統一し、開発者が共通の言葉でエージェントの設計や議論を行えるようにすることが目的だ。

13の概念を4つの観点で整理

用語集では、AIエージェントを構成する要素を「基本構造」「動作実行」「コンテキスト管理」「学習・評価」の4つの観点から整理している。

基本構造を担う3概念はエージェントの骨格となる。Model（モデル）はLLM本体であり、テキスト入力に対してテキストを出力する中核部分を指す。Scaffolding（スキャフォールド）はシステムプロンプトやツール定義など、モデルの周辺でその動作を支援する仕組み全体を指す。Harness（ハーネス）はモデルの呼び出しやツールの実行、エラー処理を管理するレイヤーで、モデルとツールを橋渡しする役割を担う。

動作実行に関わる3概念も整理されている。Tool Use（ツール利用）はAPIや外部インタプリタなどのリソースを活用する能力を指す。Skills（スキル）はタスク実行用の事前構築済みパッケージ、Sub-agents（サブエージェント）は複雑なタスクを分割して処理させる補助エージェントをそれぞれ指す。

コンテキスト管理の領域では2概念を定義している。Context Engineering（コンテキストエンジニアリング）はモデルのコンテキストウィンドウに対して必要な情報を動的に組み立てる設計手法を指す。Memory（メモリ）はセッション内の短期記憶と、複数回の対話をまたぐ長期記憶を区別する概念であり、コンテキストエンジニアリングとは独立した項目として定義されている。エージェントが継続的なタスクを処理する場面での状態保持において、この区別は実装上の重要な判断基準となる。

学習・評価に関わる5概念として、Policy（ポリシー）は状況に応じた行動決定のルールを定め、エージェントの安全性を確保するアライメント研究とも密接に関連する。RL Environment（強化学習環境）はエージェントが行動を試みる仮想環境、Trainer（トレーナー）はモデルの重みを更新する仕組み、Rollout（ロールアウト）はタスク実行の軌跡を生成するプロセス、Reward（報酬）は行動の良し悪しを評価するスコアをそれぞれ指す。

他ツールとの定義の違いも明示

用語集では、Claude CodeやOpenAI Codexなど既存のコーディング補助ツールとの用語の差異も明記されている。これらのツールでは、モデル以外の全構成要素を「ハーネス」としてひとまとめに扱う傾向があり、Hugging Faceの定義とは範囲が大きく異なる。

たとえば「スキャフォールド」はHugging Faceの定義ではモデル周辺の支援機構のみを指すが、一部のツールでは「ハーネス」の中に含まれる一要素として扱われる。用語集がこうした対応関係を明記したことで、複数のツールや文献を横断して開発を行う際の参照コストが下がることが期待される。チームメンバーが異なるツールを使っている環境でも、同じ概念を指すことを確認しやすくなる。

エージェント開発の共通言語として

AIエージェントを巡る技術的な議論はここ1〜2年で急増しており、開発者コミュニティにおける共通言語の不在は設計レビューやドキュメント作成の効率を下げる要因となっていた。今回Hugging Faceが公開した用語集は、実装レベルの定義を13概念で体系化しており、開発現場での参照資料として活用しやすい構成になっている。

特に「Context Engineering」や「Memory」のように近年重要性が高まった概念を独立した項目として定義したことは、今後の技術文書やフレームワーク設計における基準点としての役割を果たす可能性がある。エージェント開発の実務において共通語彙が定着すれば、ツール間の比較や設計パターンの共有がより円滑になるだろう。