Genesis Arbitrage

Genesis Arbitrage · · 2 دقائق قراءة

استدعاء الدوال (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 لوكلاء الذكاء الاصطناعي، بيانات سوق العملات الرقمية لوكلاء الذكاء الاصطناعي.

أسئلة وأجوبة

هل يستطيع النموذج شراء عملة عبر استدعاء الدوال؟

فقط إن منحته أداة لذلك. وليس عبر Genesis API: فهو يعيد بيانات ولا يضع أوامر. قرار التداول والتداول نفسه يبقيان بيد الإنسان.