AIエージェントによるHub通信を識別し、開発ツール別の構成比として追えるようになった。環境変数から付けた識別情報を基に、リクエスト比率と認証済み利用者比率を月別・日別で公開する。
環境変数からHub通信へエージェント名を付ける
Hugging Faceは、Hub操作用CLIのhfと、その基盤となるPythonライブラリのhuggingface_hubへエージェント検出を組み込んだ。実行環境に設定された識別用の環境変数を読み、AIエージェントが操作しているかを判定する。
共通の識別にはAI_AGENTとagentを使い、登録済みのハーネスではツール固有の環境変数も照合する。検出に成功すると、huggingface_hubがHubへ送るリクエストのUser-agentにagent/
非公開集計から公開用の相対比率を作る
公開データの生成処理は、非公開ソースにある月次・日次のParquetファイルを読み込む。そこからmonth、day、agent、pct_requests、pct_usersだけを残し、生のリクエスト件数や利用者数を含まない派生データを作る。
エージェント名は外部から送られる値であるため、公開処理は登録済みハーネスの名前だけを個別項目として許可する。登録にない名前はunknownへ置き換えて集約され、公開データセットにはエージェント由来と識別されたhuggingface_hub通信の相対比率だけが収録される。
二つの比率で利用規模と操作量の違いを読む
月次・日次データのpct_requestsは、計測対象となったエージェント由来リクエストのうち、各ハーネスが占める割合を示す。pct_usersは認証済み利用者に占める割合であり、操作量の構成と利用者の構成を別々に比較できる。
2026年7月の月次データでは、Claude Codeのリクエスト比率が44.3589％、Codexが20.8175％だった。ただし、比率は期間ごとに合計100％となる相対値なので、比率の低下だけから個別ツールの通信件数が減ったとは判断できない。
計測範囲はPythonライブラリのhuggingface_hubと、それを使うhf CLIの通信に限られ、Hub APIへの直接HTTP通信は含まれない。このため、数値が示すのは計測対象となったHub通信内の構成であり、AIエージェント市場全体の利用率ではない。
agent/トークンの展開は2026年4月3日に始まり、各ハーネスが検出へ対応した時期にも差がある。4月値は導入過程を反映するため、公開データセットは月次の増減を2026年5月以降で比較するよう案内している。
機械向け出力と再試行設計で多段階操作をつなぐ
識別対象となるhf CLIは、エージェントを検出すると同じコマンドの表示方法を切り替える。エージェント向けにはANSI装飾を外し、IDや日時、タグを切り詰めないTSVを返すほか、human、agent、json、quietの各形式を明示的に選択できる。
多くのコマンドは、実行結果の識別子を埋め込んだ次のコマンドをヒントとして示す。操作データは標準出力へ、ヒント、警告、エラーは標準エラー出力へ送るため、後続処理が読むデータへ案内文を混ぜずに多段階操作を進められる。
確認を要する破壊的操作は、エージェントモードでは入力待ちにならず、失敗メッセージで–yesの指定を案内する。既存リポジトリへの作成を無操作で終える–exist-ok、再実行を受け付けるアップロード、転送対象を事前表示する–dry-runも、タイムアウト後のやり直しや非対話処理を支える。
Hugging Faceが複雑な多段階作業を比較したベンチマークでは、curlまたはPython SDKで処理を個別に組み立てるCLI不使用方式が、hf CLIの最大6倍のトークンを使用した。これはHugging Face自身の測定結果であり、完全な出力、次操作の提示、再試行を前提にしたCLI経路を一体として評価した値である。