Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

Function calling

Function calling (también llamado tool use) es un modo en el que un modelo de lenguaje devuelve el nombre de una herramienta y argumentos JSON en lugar de texto. El modelo no ejecuta nada por sí mismo: tu código hace la petición, el resultado vuelve al modelo y este responde a partir de esos datos.

Cómo funciona una llamada

  1. La aplicación envía al modelo las descripciones de las tools: un nombre, una finalidad y un JSON Schema de los argumentos.
  2. El modelo necesita datos y devuelve, por ejemplo, funding_rates con los argumentos {"coin": "TON"}.
  3. Tu código valida los argumentos, llama a la API y devuelve la respuesta al modelo.
  4. El modelo redacta su respuesta con esos datos o llama a la siguiente tool.

Los nombres de los campos dependen de la API del modelo. En la API de Claude el esquema va en input_schema, el modelo responde con un bloque tool_use y tú devuelves el resultado en un bloque tool_result; en MCP el esquema se llama inputSchema.

Una tool para Genesis API

La definición de una tool para las tasas de funding en el formato de la API de 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 ejecutor con lista de permitidos: el modelo solo puede elegir tools y parámetros conocidos, y la clave sale del entorno del servidor.

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:
    """Ejecuta una llamada del modelo: solo rutas y parámetros conocidos."""
    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  # vuelve al modelo como resultado de la tool

Seguridad

Véase también: OpenAPI, JSON, clave de API, errores de Genesis API, Genesis API para agentes de IA, datos de mercado cripto para agentes de IA.

Preguntas y respuestas

¿Puede un modelo comprar una moneda mediante function calling?

Solo si le das una tool para ello. No a través de Genesis API: devuelve datos y no coloca órdenes. La decisión de operar y la propia operación siguen en manos de una persona.