Function calling
Function calling (जिसे tool use भी कहते हैं) ऐसा मोड है जिसमें language model टेक्स्ट के बजाय tool का नाम और JSON arguments लौटाता है। Model खुद कुछ नहीं चलाता: request आपका कोड करता है, नतीजा model को लौटता है, और वह उसी डेटा से जवाब लिखता है।
Call कैसे होता है
- एप्लिकेशन model को tools के विवरण भेजता है: नाम, उद्देश्य और arguments का JSON Schema।
- Model को डेटा चाहिए, इसलिए वह, उदाहरण के लिए,
funding_ratesको arguments{"coin": "TON"}के साथ लौटाता है। - आपका कोड arguments validate करता है, API call करता है और response model को लौटा देता है।
- Model उस डेटा से जवाब लिखता है या अगला tool call करता है।
Field के नाम model के API पर निर्भर करते हैं। Claude API में schema input_schema में जाता है, model tool_use block से जवाब देता है और आप नतीजा tool_result block में लौटाते हैं; MCP में schema को inputSchema कहते हैं।
Genesis API के लिए tool
funding rates के लिए Claude API फ़ॉर्मेट में tool की परिभाषा:
{
"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"]
}
}
Allowlist वाला executor: model केवल जाने-पहचाने tools और parameters चुन सकता है, और key सर्वर के environment से आती है।
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 # tool के नतीजे के रूप में model को लौटता है
सुरक्षा
- Key केवल उसी सर्वर पर रहती है जो calls चलाता है; वह कभी tool के विवरण या prompt में नहीं जाती।
- Model के arguments की जाँच tools, paths और parameters की allowlist से होती है।
- API के responses model को डेटा के रूप में दें: token और market के नामों में कोई भी टेक्स्ट हो सकता है, निर्देश जैसा दिखने वाला टेक्स्ट भी।
- Trades के लिए इंसान की पुष्टि चाहिए। Genesis API केवल डेटा पढ़ता है और कोई order नहीं लगाता; अगर आप किसी agent से exchange trading APIs जोड़ते हैं, तो यह आपकी अपनी ज़िम्मेदारी है, और हर trade की पुष्टि हाथ से करें।
यह भी देखें: OpenAPI, JSON, API key, Genesis API की errors, AI agents के लिए Genesis API, AI agents के लिए crypto market data।
सवाल और जवाब
क्या model function calling से coin खरीद सकता है?
केवल तब, जब आप उसे ऐसा tool दें। Genesis API के ज़रिए नहीं: वह डेटा लौटाता है और कोई order नहीं लगाता। Trade का फ़ैसला और trade खुद इंसान के पास रहते हैं।