Genesis Arbitrage

Genesis Arbitrage · · 3 menit baca

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

  1. Aplikasi mengirim deskripsi tool ke model: nama, tujuan, dan JSON Schema untuk argumennya.
  2. Model membutuhkan data dan mengembalikan, misalnya, funding_rates dengan argumen {"coin": "TON"}.
  3. Kode Anda memvalidasi argumen, memanggil API, lalu mengirim responsnya kembali ke model.
  4. 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

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.