Function calling
Function calling (که tool use هم نامیده میشود) حالتی است که در آن مدل زبانی بهجای متن، نام یک ابزار و آرگومانهای JSON برمیگرداند. مدل خودش چیزی اجرا نمیکند: کد شما درخواست را میفرستد، نتیجه به مدل برمیگردد و مدل از روی آن داده پاسخ میدهد.
فراخوانی چگونه انجام میشود
- برنامه توضیح ابزارها را برای مدل میفرستد: نام، هدف و JSON Schema آرگومانها.
- مدل به داده نیاز دارد و مثلاً
funding_ratesرا با آرگومانهای{"coin": "TON"}برمیگرداند. - کد شما آرگومانها را اعتبارسنجی میکند، API را صدا میزند و پاسخ را به مدل برمیگرداند.
- مدل پاسخش را از روی آن داده مینویسد یا ابزار بعدی را صدا میزند.
نام فیلدها به 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 # بهعنوان نتیجه ابزار به مدل برمیگردد
ایمنی
- کلید فقط روی سروری میماند که فراخوانیها را اجرا میکند؛ هرگز در توضیح ابزار یا پرامپت قرار نمیگیرد.
- آرگومانهای مدل با فهرست مجازِ ابزارها، مسیرها و پارامترها بررسی میشوند.
- پاسخهای API را بهعنوان داده به مدل بدهید: نام توکنها و بازارها میتواند متن دلخواه داشته باشد، از جمله متنی شبیه دستور.
- معاملات به تأیید انسان نیاز دارند. Genesis API فقط داده میخواند و سفارشی ثبت نمیکند؛ اگر APIهای معاملاتی صرافی را به یک ایجنت وصل کنید، با مسئولیت خودتان است و هر معامله را دستی تأیید کنید.
همچنین ببینید: OpenAPI، JSON، کلید API، خطاهای Genesis API، Genesis API برای ایجنتهای هوش مصنوعی، دادههای بازار ارز دیجیتال برای ایجنتهای هوش مصنوعی.
پرسش و پاسخ
آیا مدل با function calling میتواند کوین بخرد؟
فقط اگر چنین ابزاری به او بدهید. نه از طریق Genesis API: این API داده برمیگرداند و سفارش ثبت نمیکند. تصمیم به معامله و خود معامله با انسان میماند.