Function calling
Function calling (disebut juga tool use) adalah mode di mana model bahasa mengembalikan nama tool dan argumen JSON, bukan teks. Model tidak menjalankan apa pun sendiri: kode Anda yang membuat permintaan, hasilnya dikirim kembali ke model, dan model menjawab berdasarkan data itu.
Cara kerja sebuah panggilan
- Aplikasi mengirim deskripsi tool ke model: nama, tujuan, dan JSON Schema untuk argumennya.
- Model membutuhkan data dan mengembalikan, misalnya,
funding_ratesdengan argumen{"coin": "TON"}. - Kode Anda memvalidasi argumen, memanggil API, lalu mengirim responsnya kembali ke model.
- Model menulis jawabannya dari data itu atau memanggil tool berikutnya.
Nama field bergantung pada API model. Di Claude API, skema ditaruh di input_schema, model membalas dengan blok tool_use, dan Anda mengembalikan hasilnya dalam blok tool_result; di MCP skema itu disebut inputSchema.
Tool untuk Genesis API
Definisi tool untuk funding rate dalam format Claude API:
{
"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"]
}
}
Eksekutor dengan allowlist: model hanya bisa memilih tool dan parameter yang dikenal, dan key diambil dari environment server.
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:
"""Menjalankan panggilan model: hanya path dan parameter yang dikenal."""
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 # dikirim kembali ke model sebagai hasil tool
Keamanan
- Key hanya ada di server yang menjalankan panggilan; jangan pernah memasukkannya ke deskripsi tool atau prompt.
- Argumen dari model diperiksa terhadap allowlist tool, path, dan parameter.
- Berikan respons API ke model sebagai data: nama token dan pasar bisa berisi teks apa pun, termasuk teks yang menyerupai instruksi.
- Trade membutuhkan konfirmasi manusia. Genesis API hanya membaca data dan tidak menempatkan order; jika Anda menghubungkan API trading exchange ke agen, itu risiko Anda sendiri dan setiap trade harus dikonfirmasi secara manual.
Lihat juga: OpenAPI, JSON, API key, error Genesis API, Genesis API untuk agen AI, data pasar kripto untuk agen AI.
Tanya jawab
Bisakah model membeli koin lewat function calling?
Hanya jika Anda memberinya tool semacam itu. Tidak lewat Genesis API: API ini mengembalikan data dan tidak menempatkan order. Keputusan trading dan eksekusinya tetap di tangan manusia.