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
- La aplicación envía al modelo las descripciones de las tools: un nombre, una finalidad y un JSON Schema de los argumentos.
- El modelo necesita datos y devuelve, por ejemplo,
funding_ratescon los argumentos{"coin": "TON"}. - Tu código valida los argumentos, llama a la API y devuelve la respuesta al modelo.
- 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
- La clave vive solo en el servidor que ejecuta las llamadas; nunca va en la descripción de una tool ni en un prompt.
- Los argumentos del modelo se comprueban contra una lista de permitidos de tools, rutas y parámetros.
- Pasa las respuestas de la API al modelo como datos: los nombres de tokens y mercados pueden contener texto arbitrario, incluido texto que parece instrucciones.
- Las operaciones requieren la confirmación de una persona. Genesis API solo lee datos y no coloca órdenes; si conectas APIs de trading de exchanges a un agente, lo haces bajo tu propio riesgo y confirmas cada operación a mano.
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.