Genesis Arbitrage

Genesis Arbitrage · · 3 dk okuma

Function calling

Function calling (tool use, araç kullanımı da denir), bir dil modelinin metin yerine bir araç adı ve JSON argümanları döndürdüğü moddur. Model hiçbir şeyi kendisi çalıştırmaz: isteği kodunuz yapar, sonuç modele geri gider ve model yanıtını bu veriye dayanarak yazar.

Bir çağrı nasıl işler

  1. Uygulama modele araç açıklamalarını gönderir: bir ad, bir amaç ve argümanlar için bir JSON Schema.
  2. Modelin veriye ihtiyacı olur ve örneğin {"coin": "TON"} argümanlarıyla funding_rates döndürür.
  3. Kodunuz argümanları doğrular, API'yi çağırır ve yanıtı modele geri gönderir.
  4. Model yanıtını bu veriye göre yazar ya da bir sonraki aracı çağırır.

Alan adları modelin API'sine bağlıdır. Claude API'de şema input_schema içine konur, model tool_use bloğuyla yanıt verir ve sonucu tool_result bloğunda döndürürsünüz; MCP'de şemaya inputSchema denir.

Genesis API için bir araç

Claude API formatında fonlama oranları için bir araç tanımı:

{
  "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"]
  }
}

İzin listeli bir yürütücü: model yalnızca bilinen araçları ve parametreleri seçebilir, anahtar ise sunucunun ortamından gelir.

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:
    """Modelin çağrısını çalıştırır: yalnızca bilinen yollar ve parametreler."""
    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  # araç sonucu olarak modele geri gider

Güvenlik

Ayrıca bakın: OpenAPI, JSON, API anahtarı, Genesis API hataları, yapay zekâ ajanları için Genesis API, yapay zekâ ajanları için kripto piyasa verisi.

Sorular ve cevaplar

Bir model function calling ile coin satın alabilir mi?

Ancak ona böyle bir araç verirseniz. Genesis API üzerinden olmaz: o veri döndürür ve emir vermez. İşlem kararı ve işlemin kendisi bir insanda kalır.