Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

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

  1. A aplicação envia ao modelo as descrições das tools: um nome, uma finalidade e um JSON Schema dos argumentos.
  2. O modelo precisa de dados e devolve, por exemplo, funding_rates com os argumentos {"coin": "TON"}.
  3. O seu código valida os argumentos, chama a API e devolve a resposta ao modelo.
  4. 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

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.