Function calling
Function calling (aussi appelé tool use) est un mode dans lequel un modèle de langage renvoie le nom d'un outil et des arguments JSON au lieu de texte. Le modèle n'exécute rien lui-même : votre code fait la requête, le résultat retourne au modèle, et celui-ci répond à partir de ces données.
Comment se déroule un appel
- L'application envoie au modèle les descriptions des tools : un nom, un rôle et un JSON Schema des arguments.
- Le modèle a besoin de données et renvoie, par exemple,
funding_ratesavec les arguments{"coin": "TON"}. - Votre code valide les arguments, appelle l'API et renvoie la réponse au modèle.
- Le modèle rédige sa réponse à partir de ces données ou appelle le tool suivant.
Les noms des champs dépendent de l'API du modèle. Dans l'API Claude, le schéma va dans input_schema, le modèle répond par un bloc tool_use et vous renvoyez le résultat dans un bloc tool_result ; dans MCP, le schéma s'appelle inputSchema.
Un tool pour Genesis API
La définition d'un tool pour les taux de funding au format de l'API Claude :
{
"name": "funding_rates",
"description": "A coin's funding rates by exchange (Genesis API)",
"input_schema": {
"type": "object",
"properties": {
"coin": {"type": "string", "description": "Ticker, e.g. TON"},
"exchange": {"type": "string",
"description": "Exchanges, comma-separated"}
},
"required": ["coin"]
}
}
Un exécuteur avec liste blanche : le modèle ne peut choisir que des tools et des paramètres connus, et la clé vient de l'environnement du serveur.
import os
import requests
API = "https://api.genesisarbitrage.com/v1"
TOOLS = {"funding_rates": ("/funding/rates", {"coin", "exchange"})}
def run_tool(name: str, args: dict) -> str:
"""Exécute un appel du modèle : chemins et paramètres connus uniquement."""
if name not in TOOLS:
return '{"error": "unknown tool"}'
path, allowed = TOOLS[name]
params = {k: v for k, v in args.items() if k in allowed}
r = requests.get(
API + path,
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params=params,
timeout=10,
)
return r.text # retourne au modèle comme résultat du tool
Sécurité
- La clé ne vit que sur le serveur qui exécute les appels ; elle ne figure jamais dans la description d'un tool ni dans un prompt.
- Les arguments du modèle sont vérifiés par rapport à une liste blanche de tools, de chemins et de paramètres.
- Transmettez les réponses de l'API au modèle comme des données : les noms de tokens et de marchés peuvent contenir du texte arbitraire, y compris du texte qui ressemble à des instructions.
- Les trades exigent la confirmation d'un humain. Genesis API ne fait que lire des données et ne passe aucun ordre ; si vous connectez des API de trading d'exchanges à un agent, c'est à vos risques et vous confirmez chaque trade à la main.
Voir aussi : OpenAPI, JSON, clé d'API, erreurs de Genesis API, Genesis API pour les agents d'IA, données de marché crypto pour agents d'IA.
Questions et réponses
Un modèle peut-il acheter un coin via le function calling ?
Seulement si vous lui donnez un tool pour cela. Pas via Genesis API : elle renvoie des données et ne passe aucun ordre. La décision de trader et le trade lui-même restent du ressort d'une personne.