Les Spaces en tant qu'outils d'agent

Chaque Gradio Space expose un agents.md en texte brut que les agents de codage (Claude Code, Codex, OpenCode, Pi, etc.) peuvent appeler directement. Trouvez-en un via la recherche sémantique sur huggingface.co/spaces (par exemple « audio transcription »), testez-le éventuellement d’abord dans l’interface, puis orientez votre agent vers son agents.md. La réponse fournit tout ce qui est nécessaire pour appeler le Space en une seule fois : l’URL du schéma, les modèles d’appel et de suivi, les instructions de téléversement de fichiers et un indice d’authentification.

Cela devient encore plus puissant lors de l'enchaînement de Spaces. Un agent peut transformer un prompt en actif 3D en appelant black-forest-labs/flux-klein-9b-kv pour générer une image, puis en transmettant cette image à microsoft/TRELLIS.2 pour le modèle 3D. Aucune bibliothèque client, aucune intégration codée en dur.

Il vous suffit de définir HF_TOKEN dans votre environnement pour commencer.

Depuis l'interface utilisateur

Chaque page de Space compatible possède un bouton Agents dans l’en-tête. Cliquez dessus pour copier la commande curl du fichier agents.md de ce Space, puis collez-la dans votre agent.

Le point de terminaison agents.md

https://huggingface.co/spaces/<namespace>/<repo>/agents.md

Exemple :

curl https://huggingface.co/spaces/microsoft/TRELLIS.2/agents.md

Retourne :

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)

Entrées de fichiers

Lorsqu’un point de terminaison accepte un fichier (image, audio, vidéo, etc.), téléchargez-le d’abord puis référencez le chemin retourné dans votre appel. Téléchargez vers /gradio_api/upload et réutilisez le chemin qu’il renvoie :

# 1. Upload the file
curl -H "Authorization: Bearer $HF_TOKEN" \
  https://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://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"}}'

Les entrées qui acceptent une URL publique (plutôt qu'un fichier téléversé) peuvent être transmises directement, sans l'étape de téléversement.

Authentification et ZeroGPU

La plupart des Spaces populaires fonctionnent sur ZeroGPU, qui utilise le quota quotidien de l’appelant. Les agents doivent toujours transmettre un $HF_TOKEN afin que les appels soient facturés à votre compte plutôt qu’à un pool anonyme soumis à des limitations. Le même jeton est également requis pour les Spaces privés. Créez-en un sur huggingface.co/settings/tokens (la ligne d’authentification de agents.md pointe directement vers cette page).

curl -H "Authorization: Bearer $HF_TOKEN" \
  https://microsoft-trellis-2.hf.space/gradio_api/call/v2/predict \
  -d '{"image": {"path": "https://example.com/chair.png"}}'

Comment les agents utiliseront ceci

1. L’agent curle /agents.md pour l’espace.
2. Il récupère /gradio_api/info pour connaître les noms des points de terminaison et des entrées.
3. Pour les entrées de fichiers, il envoie le fichier par requête POST à /gradio_api/upload et conserve le chemin renvoyé.
4. Il envoie une requête POST à /gradio_api/call/v2/<endpoint>, puis récupère l’URL de sondage par GET pour diffuser le résultat.