Hub documentation
Spacesをエージェントツールとして
Spacesをエージェントツールとして
すべての Gradio Space は、コーディングエージェント（Claude Code、Codex、OpenCode、Pi など）が直接呼び出せるプレーンテキストの agents.md を公開しています。huggingface.co/spaces でセマンティック検索（例: “audio transcription”）によって該当する Space を見つけ、必要に応じてまず UI で試してから、その agents.md をエージェントに指定してください。レスポンスには、Space を一度の呼び出しで実行するために必要な情報がすべて含まれています: スキーマの URL、呼び出しとポーリングのテンプレート、ファイルアップロードの手順、そして認証に関するヒントです。
Spaces のチェーンを使用すると、さらに強力になります。エージェントは、black-forest-labs/flux-klein-9b-kvを呼び出して画像を生成し、次にその生成された画像をmicrosoft/TRELLIS.2に渡して3Dモデルを作成することで、プロンプトを3Dアセットに変換できます。クライアントライブラリも、ハードコードされた統合も不要です。
始めるには、環境にHF_TOKENを設定するだけです。
UIから
互換性のあるすべての Space ページのヘッダーに、Agents ボタンがあります。これをクリックすると、その Space の agents.md 用の curl コマンドがコピーされるので、エージェントに貼り付けてください。
agents.md エンドポイント
https://huggingface.co/spaces/<namespace>/<repo>/agents.md例:
curl https://huggingface.co/spaces/microsoft/TRELLIS.2/agents.md
返り値:
To use this application (microsoft/TRELLIS.2: Create 3D model from a single image):
API schema: GET https://microsoft-trellis-2.hf.space/gradio_api/info
Call endpoint: POST https://microsoft-trellis-2.hf.space/gradio_api/call/v2/{endpoint} {"param_name": value, ...}
Poll result: GET https://microsoft-trellis-2.hf.space/gradio_api/call/{endpoint}/{event_id}
File inputs: POST https://microsoft-trellis-2.hf.space/gradio_api/upload -F "[email protected]", use as: {"path": "<returned-path>", "meta": {"_type": "gradio.FileData"}, "orig_name": "file.ext"}
Auth: Bearer $HF_TOKEN (https://huggingface.co/settings/tokens)ファイル入力
エンドポイントがファイル（画像、音声、動画など）を受け取る場合、まずアップロードし、返されたパスを呼び出し内で参照してください。/gradio_api/upload にアップロードし、返されたパスを再利用します：
# 1. Upload the file
curl -H "Authorization: Bearer $HF_TOKEN" \
https://huggingface.co/proxy/microsoft-trellis-2.hf.space/gradio_api/upload \
-F "[email protected]"
# → ["/tmp/gradio/.../chair.png"]
# 2. Reference the returned path as a FileData object in your call
curl -H "Authorization: Bearer $HF_TOKEN" \
https://huggingface.co/proxy/microsoft-trellis-2.hf.space/gradio_api/call/v2/predict \
-d '{"image": {"path": "/tmp/gradio/.../chair.png", "meta": {"_type": "gradio.FileData"}, "orig_name": "chair.png"}}'アップロードされたファイルではなくパブリックなURLを受け入れる入力については、アップロードの手順を省略して直接渡すことができます。
認証とZeroGPU
最も人気のある Spaces は、呼び出し元の1日あたりのクォータを使用する ZeroGPU で実行されます。エージェントは常に $HF_TOKEN を渡す必要があります。これにより、スロットリングされた匿名プールではなく、あなたのアカウントに請求が行われます。同じトークンはプライベートな Spaces にも必要です。huggingface.co/settings/tokens で作成してください（agents.md の認証行はこのページに直接リンクしています）。
curl -H "Authorization: Bearer $HF_TOKEN" \
https://huggingface.co/proxy/microsoft-trellis-2.hf.space/gradio_api/call/v2/predict \
-d '{"image": {"path": "https://example.com/chair.png"}}'エージェントはこの情報をどのように利用するか
- エージェントは、Space の
/agents.mdをcurlします。 /gradio_api/infoを取得して、エンドポイント名と入力を確認します。- ファイル入力の場合、
/gradio_api/uploadにファイルを POST して、返されたパスを保持します。 /gradio_api/call/v2/<endpoint>に POST リクエストを送信し、その後、ポーリング URL を GET して結果をストリーミングします。