ٹول کالنگ وہ طریقہ ہے جس سے لینگویج ماڈل دنیا میں کچھ کرتا ہے: وہ آپ کے کوڈ سے کچھ تلاش کرنے، کوئی کوئری چلانے یا کوئی فائل بدلنے کو کہتا ہے، اور پھر نتیجہ استعمال کرتا ہے۔
یہ کیسے کام کرتی ہے
OpenAI کی گائیڈ آپ کی ایپ اور ماڈل کے درمیان ایک لوپ بیان کرتی ہے:
- ٹولز بھیجیں۔ درخواست میں فنکشنز کی فہرست ہوتی ہے، ہر ایک کا نام، تفصیل اور آرگیومنٹس کے لیے JSON Schema۔
- ٹول کال حاصل کریں۔ اگر ماڈل کو کوئی ٹول چاہیے تو وہ حتمی جواب کے بجائے فنکشن کا نام اور JSON آرگیومنٹس لوٹاتا ہے۔
- اسے چلائیں۔ آپ کا کوڈ فنکشن چلاتا ہے۔ OpenAI کی گائیڈ یہ مرحلہ “the application side” (ترجمہ: ایپلیکیشن کی طرف) رکھتی ہے؛ ماڈل خود کبھی کوڈ نہیں چلاتا۔
- نتیجہ لوٹائیں، مطابقت رکھنے والے call ID کے ساتھ۔
- جواب حاصل کریں، یا ایک اور ٹول کال۔ ضرورت کے مطابق دہرائیں۔
Chat Completions فارمیٹ میں ٹول کی تعریف کچھ یوں ہوتی ہے:
{
"type": "function",
"function": {
"name": "get_order_status",
"description": "Look up an order by ID",
"parameters": {
"type": "object",
"properties": { "order_id": { "type": "string" } },
"required": ["order_id"]
}
}
}
جواب میں finish_reason: "tool_calls" اور ایک tool_calls لسٹ ہوتی ہے۔ ہر اندراج میں ایک id، فنکشن کا نام اور JSON اسٹرنگ کے طور پر arguments ہوتے ہیں۔ آپ role: "tool"، وہی tool_call_id اور نتیجے والا ایک پیغام شامل کرتے ہیں، پھر API کو دوبارہ کال کرتے ہیں۔
یہ کیوں اہم ہے
- ایجنٹس۔ کوڈنگ ایجنٹس، سپورٹ بوٹس اور ڈیٹا اسسٹنٹس زیادہ تر ٹول کالز کے لوپ ہی ہیں۔
- لاگت۔ ہر چکر ایک نئی درخواست ہے جو گفتگو، ٹولز کی تعریفیں اور ٹولز کے نتائج دوبارہ ان پٹ ٹوکنز کے طور پر بھیجتی ہے۔ لمبے ٹول لوپس میں کیش شدہ ان پٹ اور ٹولز کی مستحکم ترتیب اہم ہو جاتی ہے۔
- تحفظ۔ آرگیومنٹس ماڈل سے آتے ہیں۔ ڈیٹا بدلنے یا پیسے خرچ کرنے والی کوئی بھی چیز چلانے سے پہلے انہیں جانچیں۔
اگر جواب کو کسی schema سے ملنا ہے لیکن کسی فنکشن کی ضرورت نہیں تو اسٹرکچرڈ آؤٹ پٹ آسان راستہ ہے۔
BroadNet Inference پر
BroadNet کی دستاویزات GLM 5.3 اور Qwen3.8 27B کے لیے ٹول کالنگ درج کرتی ہیں، دونوں میں اسٹرکچرڈ آؤٹ پٹ اور ریزننگ بھی ہے۔ DeepSeek V4.1 Flash یا BroadNet Gemma 4 VL 26B کے لیے دستاویزات ٹول سپورٹ نہیں بتاتیں۔ جس ماڈل کو آپ پروڈکشن میں لے جانا چاہتے ہیں اس پر اپنا ٹول لوپ ٹیسٹ کریں۔
درج شدہ دونوں ماڈلز جواب سے پہلے ریزننگ کرتے ہیں، اور ریزننگ max_tokens میں گنی جاتی ہے، اس لیے جگہ چھوڑیں، ورنہ ٹول کال بیچ میں کٹ سکتی ہے۔ ریزننگ ٹوکنز دیکھیں۔ اپنا ٹول فارمیٹ ساتھ لانے والے ایجنٹ ٹولز کے لیے Cline گائیڈ اور Vercel AI SDK گائیڈ دیکھیں۔
عام غلطیاں
argumentsکو آبجیکٹ سمجھ کر پارس کرنا۔ یہ JSON اسٹرنگ کے طور پر آتا ہے؛ اسے ڈی کوڈ کریں اور ایررز سنبھالیں۔tool_call_idبھول جانا۔ اس کے بغیر ماڈل نتائج کو کالز سے نہیں ملا سکتا۔