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
- Uygulama modele araç açıklamalarını gönderir: bir ad, bir amaç ve argümanlar için bir JSON Schema.
- Modelin veriye ihtiyacı olur ve örneğin
{"coin": "TON"}argümanlarıylafunding_ratesdöndürür. - Kodunuz argümanları doğrular, API'yi çağırır ve yanıtı modele geri gönderir.
- 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
- Anahtar yalnızca çağrıları çalıştıran sunucuda durur; asla bir araç açıklamasına veya prompt'a girmez.
- Modelin argümanları araçlar, yollar ve parametrelerden oluşan bir izin listesine karşı kontrol edilir.
- API yanıtlarını modele veri olarak verin: token ve piyasa adları, talimat gibi görünen metin dahil her türlü metni içerebilir.
- İşlemler bir insanın onayını gerektirir. Genesis API yalnızca veri okur ve emir vermez; bir ajana borsa işlem API'lerini bağlarsanız bunu kendi riskinizle yaparsınız ve her işlemi elle onaylarsınız.
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.