استدعاء الدوال (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 يقرأ البيانات فقط ولا يضع أوامر؛ وإن ربطت واجهات تداول المنصات بوكيل فذلك على مسؤوليتك، وأكّد كل صفقة يدوياً.
انظر أيضاً: OpenAPI، JSON، مفتاح API، أخطاء Genesis API، Genesis API لوكلاء الذكاء الاصطناعي، بيانات سوق العملات الرقمية لوكلاء الذكاء الاصطناعي.
أسئلة وأجوبة
هل يستطيع النموذج شراء عملة عبر استدعاء الدوال؟
فقط إن منحته أداة لذلك. وليس عبر Genesis API: فهو يعيد بيانات ولا يضع أوامر. قرار التداول والتداول نفسه يبقيان بيد الإنسان.