Function calling
Function calling (também chamado de tool use) é um modo em que um modelo de linguagem devolve o nome de uma ferramenta e argumentos JSON em vez de texto. O modelo não executa nada por conta própria: o seu código faz a requisição, o resultado volta ao modelo e ele responde com base nesses dados.
Como uma chamada funciona
- A aplicação envia ao modelo as descrições das tools: um nome, uma finalidade e um JSON Schema dos argumentos.
- O modelo precisa de dados e devolve, por exemplo,
funding_ratescom os argumentos{"coin": "TON"}. - O seu código valida os argumentos, chama a API e devolve a resposta ao modelo.
- O modelo escreve a resposta a partir desses dados ou chama a próxima tool.
Os nomes dos campos dependem da API do modelo. Na API do Claude, o schema vai em input_schema, o modelo responde com um bloco tool_use e você devolve o resultado num bloco tool_result; no MCP, o schema se chama inputSchema.
Uma tool para a Genesis API
A definição de uma tool para as taxas de funding no formato da API do 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"]
}
}
Um executor com lista de permissões: o modelo só pode escolher tools e parâmetros conhecidos, e a chave vem do ambiente do 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:
"""Executa uma chamada do modelo: só caminhos e parâmetros conhecidos."""
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 # volta ao modelo como resultado da tool
Segurança
- A chave fica só no servidor que executa as chamadas; ela nunca vai na descrição de uma tool nem num prompt.
- Os argumentos do modelo são checados contra uma lista de permissões de tools, caminhos e parâmetros.
- Passe as respostas da API ao modelo como dados: nomes de tokens e de mercados podem conter texto arbitrário, inclusive texto que parece instruções.
- Negociações exigem a confirmação de uma pessoa. A Genesis API só lê dados e não envia ordens; se você conectar APIs de trading de exchanges a um agente, faz isso por sua conta e risco e confirma cada operação manualmente.
Veja também: OpenAPI, JSON, chave de API, erros da Genesis API, Genesis API para agentes de IA, dados de mercado cripto para agentes de IA.
Perguntas e respostas
Um modelo pode comprar uma moeda via function calling?
Só se você lhe der uma tool para isso. Não pela Genesis API: ela devolve dados e não envia ordens. A decisão de operar e a operação em si continuam com uma pessoa.