Genesis Arbitrage

Genesis Arbitrage · · 3 min de lecture

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

  1. L'application envoie au modèle les descriptions des tools : un nom, un rôle et un JSON Schema des arguments.
  2. Le modèle a besoin de données et renvoie, par exemple, funding_rates avec les arguments {"coin": "TON"}.
  3. Votre code valide les arguments, appelle l'API et renvoie la réponse au modèle.
  4. 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é

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.