Genesis Arbitrage

Genesis Arbitrage · · 3 دقیقه مطالعه

Function calling

Function calling (که tool use هم نامیده می‌شود) حالتی است که در آن مدل زبانی به‌جای متن، نام یک ابزار و آرگومان‌های JSON برمی‌گرداند. مدل خودش چیزی اجرا نمی‌کند: کد شما درخواست را می‌فرستد، نتیجه به مدل برمی‌گردد و مدل از روی آن داده پاسخ می‌دهد.

فراخوانی چگونه انجام می‌شود

  1. برنامه توضیح ابزارها را برای مدل می‌فرستد: نام، هدف و JSON Schema آرگومان‌ها.
  2. مدل به داده نیاز دارد و مثلاً funding_rates را با آرگومان‌های {"coin": "TON"} برمی‌گرداند.
  3. کد شما آرگومان‌ها را اعتبارسنجی می‌کند، API را صدا می‌زند و پاسخ را به مدل برمی‌گرداند.
  4. مدل پاسخش را از روی آن داده می‌نویسد یا ابزار بعدی را صدا می‌زند.

نام فیلدها به API مدل بستگی دارد. در Claude API اسکیما در input_schema می‌رود، مدل با بلوک tool_use پاسخ می‌دهد و شما نتیجه را در بلوک tool_result برمی‌گردانید؛ در MCP اسکیما inputSchema نام دارد.

ابزاری برای Genesis API

تعریف ابزار نرخ‌های فاندینگ با قالب 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"]
  }
}

اجراکننده‌ای با فهرست مجاز: مدل فقط می‌تواند ابزارها و پارامترهای شناخته‌شده را انتخاب کند و کلید از محیط سرور می‌آید.

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:
    """Runs a model's call: known paths and parameters only."""
    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  # به‌عنوان نتیجه ابزار به مدل برمی‌گردد

ایمنی

همچنین ببینید: OpenAPI، JSON، کلید API، خطاهای Genesis API، Genesis API برای ایجنت‌های هوش مصنوعی، داده‌های بازار ارز دیجیتال برای ایجنت‌های هوش مصنوعی.

پرسش و پاسخ

آیا مدل با function calling می‌تواند کوین بخرد؟

فقط اگر چنین ابزاری به او بدهید. نه از طریق Genesis API: این API داده برمی‌گرداند و سفارش ثبت نمی‌کند. تصمیم به معامله و خود معامله با انسان می‌ماند.