کبھی آپ نے یہ خواہش کی ہے کہ آپ کا AI ایجنٹ درحقیقت کچھ کام کر سکے—آپ کا کیلنڈر چیک کر سکے، ٹکٹ فائل کر سکے، شپمنٹ کی صورتحال معلوم کر سکے—بجائے اس کے کہ صرف اس بارے میں مخلصانہ پیراگراف لکھے کہ وہ یہ کام کیسے کرے گا؟ میں نے بھی کی ہے۔ یہ وہ لمحہ ہوتا ہے جب آپ خیالی پلاؤ پکانا چھوڑ دیتے ہیں اور APIs کو جوڑنا شروع کر دیتے ہیں۔ اور یہیں سے مزہ شروع ہوتا ہے… اور کبھی کبھار رونا دھونا بھی۔
اس عملی گائیڈ میں، ہم یہ دیکھیں گے کہ APIs کو آپ کے AI ایجنٹ بلڈر پروجیکٹ میں کیسے ضم کیا جائے تاکہ ریٹ لمٹ سے تجاوز نہ ہو، راز افشا نہ ہوں، یا ہزاروں ڈپلیکیٹ آرڈرز کے ساتھ جاگنا نہ پڑے کیونکہ آپ کی دوبارہ کوشش کرنے کی منطق کچھ زیادہ ہی پرجوش ہو گئی تھی۔ میں آپ کو بتاؤں گا کہ کیا منصوبہ بندی کرنی ہے، کیا بنانا ہے، اور کس چیز پر عقاب کی طرح نظر رکھنی ہے۔ ہم محفوظ ٹول انٹیگریشن پر موجودہ سوچ پر ایک نظر ڈالیں گے، OAuth اور اسکوپڈ ٹوکنز آپ کے دوست کیوں ہیں، بلٹ پروف ٹول اسکیمز کیسے ڈیزائن کریں، اور یہ کیسے ٹریس کریں کہ آپ کے ایجنٹ نے 17 ہیومیڈیفائرز آرڈر کرتے وقت کیا سوچا تھا۔
اس دوران، میں جدید ایجنٹ بلڈر ایکو سسٹمز سے اخذ کردہ عملی ورک فلوز (ہاں، بشمول OpenAI کے) کے ساتھ ساتھ کچھ ٹیمپلیٹس اور احتیاطیں بھی شیئر کروں گا جو بعد میں آپ کی مشکل وقت میں مدد کریں گی۔ ہم اسے حقیقی رکھیں گے، ہم اسے محفوظ رکھیں گے، اور ہم آپ کے صارفین کو اتفاقی طور پر پوری کسٹمر لسٹ کو ای میل کرنے سے بچائیں گے—دوبارہ۔
ہم کیا کور کریں گے:
- ایجنٹس کے لیے "APIs کیوں" کی مختصر کہانی—اور خطرات۔
- جنگ آزمودہ انٹیگریشن بلیو پرنٹ: تصدیق، اسکیمز، حفاظتی تدابیر، دوبارہ کوششیں، مشاہدہ۔
- مرحلہ وار: ایک ٹول شامل کرنا، ان پُٹس کی توثیق کرنا، غلطیوں کو ہینڈل کرنا، اور نتائج واپس کرنا۔
- سیکورٹی اور تعمیل: کم سے کم استحقاق، رازوں کا انتظام، اور استعمال کی حدود۔
- خرابیوں کا سراغ لگانا: جب ایجنٹ اسکرپٹ سے ہٹ جاتا ہے، اینڈ پوائنٹس کا تصور کرتا ہے، یا لوپ میں پھنس جاتا ہے۔
- عملی مثالیں اور جانچ کی ترکیبیں جنہیں آپ اپنے پروجیکٹ میں کاپی پیسٹ کر سکتے ہیں۔
AI ایجنٹ میں APIs کو کیوں جوڑیں؟
کیونکہ جس لمحے آپ کا ایجنٹ APIs کو کال کر سکتا ہے، وہ ایک باصلاحیت بات کرنے والا بننا چھوڑ دیتا ہے اور ایک مددگار کام کرنے والا بن جاتا ہے۔ اس کا مطلب ہے کہ وہ یہ کر سکتا ہے:
- لائیو ڈیٹا حاصل کریں: "تازہ ترین شپمنٹ ETA کیا ہے؟"
- اقدامات کریں: "ایک Jira ٹکٹ فائل کریں اور اسے للی کو تفویض کریں۔"
- ورک فلوز ترتیب دیں: "ان کے CRM نوٹس چیک کرنے کے بعد سب سے اوپر کے پانچ دیر سے ادائیگی کرنے والوں کو ای میل کریں۔"
یہ طاقت خطرے کے ساتھ آتی ہے۔ ایجنٹس فطرت کے لحاظ سے تخلیقی ہوتے ہیں۔ بغیر نگرانی کے چھوڑ دیا جائے تو، وہ API اینڈ پوائنٹس ایجاد کریں گے، غلط پیرامیٹرز پاس کریں گے، آپ کے وینڈر کے آپ کو بلاک کرنے تک دوبارہ کوشش کریں گے، اور یہ فرض کریں گے کہ تمام غلطیاں "عارضی" ہیں، جیسا کہ آپ کا یہ ماننا ہے کہ آپ کو 3 بجے کے بعد کافی کی ضرورت نہیں ہے۔ اچھے ایجنٹوں کو حفاظتی تدابیر کی ضرورت ہوتی ہے۔
محفوظ، قابل اعتماد API انٹیگریشن کے لیے ایک بلیو پرنٹ
یہ وہ نسخہ ہے جو میں آپ کے AI ایجنٹ بلڈر پروجیکٹ میں APIs کو ضم کرنے کے لیے تجویز کرتا ہوں:
- اسکوپڈ، قلیل مدتی ٹوکنز استعمال کریں۔ اگر آپ کے ایجنٹ کو صرف آرڈرز تک ریڈ رسائی کی ضرورت ہے، تو اسے ایڈمن کیز نہ دیں۔ اگر آپ کو طویل مدتی رازوں کو ذخیرہ کرنا ہی ہے، تو انہیں ایک محفوظ والٹ میں رکھیں، نہ کہ پرامپٹس میں۔
- تھرڈ پارٹی APIs کے لیے کم سے کم استحقاق کے اسکوپس کے ساتھ OAuth یا سروس اکاؤنٹس کو ترجیح دیں۔ اس طرح، ٹوکن اپنی مرضی سے زیادہ کچھ نہیں کر سکتا—اور اس کی میعاد ختم ہو جاتی ہے۔
- فی ماحول الگ اسناد (dev/staging/prod)۔ آپ نہیں چاہتے کہ آپ کا اسٹیجنگ ایجنٹ پروڈکشن ریکارڈز کو اپ ڈیٹ کرے کیونکہ ایک .env فائل بے قابو ہو گئی۔
- ٹول اسکیمز جو ماڈل کی دیکھ بھال کرتی ہیں (خوش اسلوبی سے)
- ہر ٹول کے لیے سخت، ٹائپڈ پیرامیٹرز کی وضاحت کریں: enums، نمبر رینجز، مطلوبہ فیلڈز، اور ان پُٹ مثالیں۔ آپ کی اسکیم سیٹ بیلٹ ہے۔
- کسی بھی نیٹ ورک کال سے پہلے ان پُٹس کی توثیق کریں۔ اگر ماڈل آپ کو آدھا پکا ہوا شہر کا نام دیتا ہے، تو اسے ایک مددگار ایرر کے ساتھ مسترد کر دیں اور واضح رکاوٹوں کے ساتھ دوبارہ کوشش کرنے کے لیے کہیں۔
- ٹولز کو چھوٹا اور بامقصد رکھیں۔ "get_weather(city, country_code)" "do_weather_things" سے بہتر ہے۔ چھوٹے ٹولز بہتر چین بناتے ہیں اور کم ناکام ہوتے ہیں۔
- ہر ٹول کو جہاں ممکن ہو idempotent رکھیں۔ اگر ایجنٹ کسی درخواست کو دہراتا ہے، تو آپ ڈپلیکیٹ آرڈرز نہیں چاہتے۔ رائٹ آپریشنز پر idempotency کیز استعمال کریں۔
- ٹول کے جواب کو قابل پیش گوئی بنائیں۔ اسٹیٹس، ڈیٹا، اور ایرر فیلڈز کے ساتھ ساختہ JSON واپس کریں، نہ کہ حیرت انگیز نثر۔
- ایکسپونینشل بیک آف کے ساتھ محدود دوبارہ کوششیں نافذ کریں—اور صرف دوبارہ کوشش کرنے کے لیے محفوظ ایررز (ٹائم آؤٹس، 5xx) کے لیے۔ توثیق یا 4xx ایررز کی دوبارہ کوشش نہ کریں۔
- ماڈل کو قابل عمل ایرر میسجز پیش کریں۔ "ریٹ لمٹ سے تجاوز کر گیا؛ 10 سیکنڈ میں دوبارہ کوشش کریں" "Error: 429" سے کہیں زیادہ مددگار ہے۔
- سرکٹ بریکرز شامل کریں۔ اگر کوئی API خراب ہو رہی ہے، تو اسے مارنا بند کریں۔ خوش اسلوبی سے ناکام ہوں۔
- ریٹ لمٹنگ، کوٹاز، اور لاگت کنٹرول
- فی صارف/سیشن کال بجٹ نافذ کریں۔ ایک بدمعاش لوپ کو آپ کے ماہانہ کوٹے کو تباہ نہیں کرنا چاہیے۔
- جب سمجھ میں آئے تو نتائج کو کیش کریں (مثال کے طور پر، مختصر تازگی ونڈوز کے ساتھ ریڈ درخواستیں)۔ آپ کے صارفین کو پانچ سیکنڈ میں پانچ ایک جیسی لائیو چیکس کی ضرورت نہیں ہے۔
- ہر ٹول کال کو لاگ کریں: ان پُٹس، آؤٹ پُٹس، تاخیر، اسٹیٹس کوڈز، اور ایجنٹ کی استدلال کی سنیپ شاٹ پہلے/بعد میں۔
- صارف، سیشن، اور ٹول کے نام سے لاگز کو ٹیگ کریں تاکہ آپ دوبارہ تعمیر کر سکیں کہ جنگل میں کیا ہوا۔
- ایک ریڈ بٹن رکھیں: پروڈکشن میں غلط سلوک کرنے والے ٹول کو غیر فعال کرنے کا ایک فوری طریقہ۔
- خطرناک کارروائیوں کے لیے ہیومن-ان-دی-لوپ
- حساس آپریشنز (پیسے کی منتقلی، بہت سے لوگوں کو ای میلز، سسٹم میں تبدیلیاں) کو تصدیقی پرامپٹس یا منظوریوں کے پیچھے رکھیں۔
- ہائی رسک ٹولز کے لیے، ماڈل کو ایک سمری تیار کرنے، اسے صارف کو دکھانے، اور صرف واضح رضامندی پر آگے بڑھنے کی ضرورت ہوتی ہے۔ آپ بہتر سوئیں گے۔
اپنا پہلا ٹول ترتیب دینا: ایک واک تھرو
آئیے ایک سادہ "get_weather" ٹول بنائیں۔ یہ ایک ریڈ اونلی API ہے—کمپنی کے بلنگ سسٹم میں جوڑنے سے پہلے بنیادی باتوں کی مشق کرنے کے لیے بہترین ہے۔
مرحلہ 1: ٹول کنٹریکٹ لکھیں
- تفصیل: "شہر اور ملک کے کوڈ کے ذریعے موجودہ موسم حاصل کریں۔"
- پیرامیٹرز (JSON schema-ish): city (string, minLength 1), country_code (string, length 2), units (enum . آپ کو مطابقت پذیر ٹول اسٹیکس—کنیکٹرز، RPA برجز، ویکٹر اسٹورز—کے راؤنڈ اپس بھی ملیں گے جو ایجنٹ بلڈرز کے ساتھ اچھی طرح جوڑتے ہیں اور اگر آپ ایک واحد وینڈر اپروچ سے آگے بڑھ جاتے ہیں تو آپ کو آپشنز دیتے ہیں۔ اگر آپ فریم ورکس کا موازنہ کر رہے ہیں، تو مضبوط ٹول گورننس، اسکیما انفورسمنٹ، اور ایک سمجھدار ڈیبگنگ کہانی تلاش کریں تاکہ آپ درحقیقت دیکھ سکیں کہ ایجنٹ نے کیا کیا اور کیوں کیا۔
سیکورٹی چیک لسٹس جو آپ درحقیقت استعمال کریں گے۔
- کم سے کم استحقاق: ہر ٹوکن کو صرف اس چیز تک محدود رکھیں جس کی اس ٹول کو ضرورت ہے۔
- ٹوکن حفظان صحت: باقاعدگی سے گھمائیں؛ قلیل مدتی ٹوکنز کو ترجیح دیں؛ کبھی بھی راز لاگ نہ کریں۔
- ڈیٹا منیمائزیشن: صرف وہی فیلڈز بھیجیں جو کام کے لیے درکار ہیں۔
- مانیٹر اور الرٹ: غیر معمولی اسپائکس، آف آورز کالز، اور برستی ریٹرائیز کے لیے حدیں مقرر کریں۔
- رسائی کی حدود: حساس اینڈ پوائنٹس کے لیے IP الاؤ لسٹس یا پرائیویٹ گیٹ ویز۔
- سیکرٹ اسٹوریج: آڈٹ لاگز اور انویلپ انکرپشن کے ساتھ وقف شدہ والٹ سروس۔
کیا آپ کو سیکورٹی کے گہرے مسئلے کی ضرورت ہے؟ یہاں عملی گائیڈز موجود ہیں جو ایجنٹ ٹول سیکورٹی پیٹرنز—تصدیق، ان پُٹ سینیٹائزیشن، اور مانیٹرنگ—پر توجہ مرکوز کرتی ہیں، جو اس وقت مددگار ہوتی ہیں جب آپ کے بوٹس اصلی سسٹمز کو چھونا شروع کر دیتے ہیں۔ انڈسٹری گروپس نے AI سیاق و سباق میں API-مخصوص خطرات کو بھی بتانا شروع کر دیا ہے، جیسے ایجنٹ سے چلنے والے اسپائکس اور رویے پر مبنی انوملی ڈیٹیکشن۔ اور اگر آپ کے منظر نامے کو ایجنٹ ٹو ایجنٹ تصدیق کی ضرورت ہے—ہاں، یہ ایک چیز ہے—تو یہاں جدید پیٹرنز موجود ہیں جو محفوظ ہینڈ شیک کے لیے سیاق و سباق پروٹوکولز اور OAuth کو ایک ساتھ جوڑتے ہیں۔
ایک پیٹرن لائبریری جسے آپ چرا سکتے ہیں
ٹول ریپر پیٹرن
- اسکیما کے خلاف ان پُٹس کی توثیق کریں؛ اگر غلط ہو تو ایک مددگار ایرر واپس کریں۔
- ٹائم آؤٹس، بیک آف پالیسی، اور idempotency کی (رائٹس کے لیے) کے ساتھ درخواست بنائیں۔
- ڈیٹا سینیٹائز کریں: اگر غیر ضروری ہو تو PII کو ریڈیکٹ کریں۔
- جوابی لفافے کو معیاری بنائیں۔
- ٹریس IDs کے ساتھ ساختہ لاگز جاری کریں۔
ماڈل کے لیے فیصلہ سازی کا پیٹرن
- شرائط: "میرے پاس شہر اور ملک کا کوڈ ہے۔"
- غیر استعمال کی مثالیں: "اگر صارف عام طور پر آب و ہوا کے بارے میں پوچھتا ہے، تو کال نہ کریں۔"
- ایرر فالو اپس: "اگر توثیق ناکام ہو جاتی ہے، تو ان پُٹ کو ٹھیک کرنے کے لیے ایک جامع سوال پوچھیں۔"
- تصدیق: "رائٹس کے لیے، پلان کا خلاصہ کریں اور منظوری طلب کریں۔"
اسکیلشن پیٹرن
- اگر 429: اشارہ کردہ وقت کا انتظار کریں؛ پھر jitter کے ساتھ دوبارہ کوشش کریں؛ کل کوششوں کو محدود کریں۔
- اگر 5xx: ایکسپونینشل بیک آف؛ کوششوں کو محدود کریں؛ اگر دستیاب ہو تو متبادل راستے پر غور کریں۔
- اگر توثیق کی خرابی: دوبارہ کوشش نہ کریں؛ اصلاح طلب کریں۔
- اگر بار بار ناکامیاں: اس کام کے لیے ٹول کو غیر فعال کریں؛ معافی مانگیں؛ فال بیک تجویز کریں۔
مثال: دو ٹولز کو محفوظ طریقے سے جوڑنا
صارف: "مجھے تین دن سے زیادہ تاخیر والے سب سے اوپر کے تین آرڈرز ای میل کریں۔"
- مرحلہ 1: get_delayed_orders(days=3, limit=3) — ریڈ اونلی، کیش ایبل۔
- مرحلہ 2: compose_email(to=user_email, body=summary) — پہلے پریویو موڈ۔
- مرحلہ 3: صارف کو پریویو پیش کریں؛ "Send" تصدیق کی ضرورت ہے۔
- مرحلہ 4: send_email(idempotency_key=hash(orders + recipient + timestamp_window))
خرابیوں کا سراغ لگانا: جب چیزیں غلط ہو جائیں
- ماڈل ایک اینڈ پوائنٹ کا تصور کرتا ہے۔ فکس: اجازت یافتہ ٹول کے ناموں کی فہرست بنائیں اور ان کی واضح طور پر وضاحت کریں؛ نامعلوم ٹولز کو مسترد کریں؛ مثالیں شامل کریں۔
- ٹول کو بے معنی پیرامیٹرز کے ساتھ کال کیا جاتا ہے۔ فکس: اسکیما اور توثیق کو سخت کریں؛ سسٹم پرامپٹ میں شرط ریمائنڈرز شامل کریں۔
- لامحدود لوپس۔ فکس: فی ٹرن/ٹاسک ٹول کالز کو محدود کریں؛ بار بار ہونے والی خرابیوں کو ٹریک کریں اور فال بیک کو مجبور کریں۔
- ریٹ لمٹ طوفان۔ فکس: فی سیشن بجٹ؛ jitter؛ کیشنگ؛ سرکٹ بریکرز؛ ماڈل کو ایک "کوول ڈاؤن" پیغام۔
- خاموش ناکامیاں۔ فکس: ساختہ لاگز؛ ایرر اسپائکس پر الرٹس؛ ایجنٹ کو صارف کو ناکامیوں کا خلاصہ کرنے پر مجبور کریں۔
Sider.AI کہاں فٹ بیٹھتا ہے
اگر آپ براؤزر پر مبنی ورک فلو میں AI ایجنٹس کے ساتھ تجربہ کر رہے ہیں یا ایک دوستانہ پرت چاہتے ہیں جو آپ کو پرامپٹس، لنکس اور ٹول آؤٹ پُٹس کو قابل اشتراک چیز میں جمع کرنے میں مدد کرے، تو Sider.AI ایک نظر ڈالنے کے قابل ہے۔ یہ کوئی چاندی کی گولی نہیں ہے، لیکن یہ تحقیق کو اکٹھا کرنے، فوری توثیق، اور ہلکے وزن والے ایجنٹ ٹاسکس کو وہیں سے انجام دینے کے لیے آسان ہے جہاں آپ کام کرتے ہیں—ان لوگوں کے لیے اچھا ہے جو سارا دن دستاویزات، ڈیش بورڈز اور ٹیبز میں رہتے ہیں۔ یہ اس وقت بہترین ہوتا ہے جب آپ اسے عملی، محدود نوکریوں کی طرف دھکیلتے ہیں اور کسی بھی ہائی رسک چیز کو منظوریوں کے پیچھے رکھتے ہیں۔ اپنا ایجنٹ بلڈر منتخب کرنا (ایک Pogue-ish حوصلہ افزائی کے ساتھ)
اس اسٹیک کو چنیں جو آپ کو اعتماد دے، نہ کہ صرف سزل ریلز۔ آپ چاہتے ہیں:
- ایماندار ٹول گورننس: اسکیمز، پالیسیز، اور کالز میں مرئیت۔
- میموری جو آپ کے بجٹ کو نہ کھا جائے۔
- ایک ڈیبگنگ کہانی جس کے ساتھ آپ رہ سکیں۔
- فرار کے راستے: بعد میں ٹولز یا وینڈرز کو تبدیل کرنے کی آزادی۔
کچھ ایکو سسٹمز فعال طور پر منظم ٹول گورننس، ٹیمپلیٹس، اور اسٹیک راؤنڈ اپس کی تلاش کر رہے ہیں تاکہ آپ تیزی سے شروع کر سکیں اور کنٹرول کے ساتھ اسکیل کر سکیں۔ آپ کو APIs کو صاف ستھرا پلگ کرنے، میموری/سیاق و سباق کا انتظام کرنے، اور ایجنٹ کو پٹے پر رکھنے کے ارد گرد بہت ساری توانائی نظر آئے گی—بالکل وہی جو آپ چاہتے ہیں جب آپ "کھلونے" سے "ٹیم کے لیے اہم" کی طرف بڑھتے ہیں۔
ایک آخری چیز: ایجنٹ کو خود کو سمجھانے کو کہیں
اپنے ایجنٹ سے بیان کرنے کو کہیں… تھوڑا سا۔ کوئی ناول نہیں—بس ایک فوری "میں تاخیر سے آنے والی شپمنٹس کو حاصل کرنے کے لیے آرڈرز API کو کال کر رہا ہوں" اس سے پہلے کہ وہ کام کرے۔ وہ بیان، کال کے ساتھ لاگ کیا گیا، آپ کے ڈیبگنگ کرتے وقت سونا ہوتا ہے۔
ریپ اپ (اور آپ کا ایکشن پلان)
- ایک ریڈ اونلی API کے ساتھ چھوٹے پیمانے پر شروع کریں؛ اپنے اسکیمز اور توثیق کو مکمل کریں۔
- کسی بھی رائٹس کو فعال کرنے سے پہلے idempotency اور تصدیقی فلو شامل کریں۔
- ٹائم آؤٹس، ریٹرائیز، اور ساختہ جوابات کے ساتھ ایک معیاری ٹول ریپر بنائیں۔
- ریٹ لمٹس، کوٹاز، اور فی سیشن بجٹ نافذ کریں۔
- ہر اس چیز کو لاگ کریں جو اہم ہے؛ اسپائکس اور خرابیوں کے لیے الرٹس شامل کریں۔
- ہائی رسک ایکشنز کے لیے انسانوں کو لوپ میں رکھیں۔
ایسا کریں، اور آپ کا AI ایجنٹ کارآمد ہونے کا بہانہ کرنا چھوڑ دے گا اور کارآمد ہونا شروع ہو جائے گا۔ یہ ایک پیشہ ور کی طرح حاصل کرے گا، فائل کرے گا، اور فالو اپ کرے گا—بغیر آپ کے انفراسٹرکچر کو ایک آسیب زدہ گھر میں تبدیل کیے ہوئے۔
مزید پڑھنے اور مددگار نقطہ نظر:
- منظم ٹول انٹیگریشن اور ایجنٹ بلڈر ٹریڈ آفز پر۔
- ٹول اسٹیکس اور انٹیگریشنز جو ایجنٹ بلڈرز کی تکمیل کرتے ہیں۔
- ایجنٹ فریم ورکس کا موازنہ کرنا—عملی طور پر کیا فراہم کرتا ہے۔
- ایجنٹک سسٹمز میں ٹول انٹیگریشن کے لیے سیکورٹی کے بہترین طریقے۔
- AI دور میں API سیکورٹی: ریٹ لمٹنگ، انوملی ڈیٹیکشن، اور بہت کچھ۔
- ایجنٹ ٹو ایجنٹ OAuth پیٹرنز جن کی آپ کو بالآخر ضرورت ہوگی۔
اکثر پوچھے جانے والے سوالات
Q1:اپنے AI ایجنٹ بلڈر میں APIs کو ضم کرنے کا سب سے آسان طریقہ کیا ہے؟
ایک ریڈ اونلی API اور ایک سخت ٹول اسکیما کے ساتھ شروع کریں۔ ان پُٹس کی توثیق کریں، ایک ساختہ جواب واپس کریں، اور صرف ٹائم آؤٹس یا 5xx خرابیوں کے لیے ریٹرائیز شامل کریں—پھر idempotency کیز اور کنفرمیشنز کے ساتھ رائٹ آپریشنز میں گریجویٹ کریں۔
Q2:میں اپنے AI ایجنٹ کو غلط API کو کال کرنے یا غلط پیرامیٹرز استعمال کرنے سے کیسے روک سکتا ہوں؟
enums، مطلوبہ فیلڈز، اور مثالوں کے ساتھ سخت ٹول اسکیما استعمال کریں، اور ہر کال کی توثیق کریں۔ اپنے سسٹم پرامپٹ میں، شرائط کو واضح کریں ("جب تک… کال نہ کریں") اور عمل کے ساتھ ساتھ پرہیزگاری سکھانے کے لیے چند غیر استعمال کی مثالیں فراہم کریں۔
Q3:AI ایجنٹ API انٹیگریشنز کے لیے کون سے سیکورٹی کے بہترین طریقے سب سے زیادہ اہم ہیں؟
کم سے کم استحقاق والے ٹوکنز، قلیل مدتی اسناد، اور ایک محفوظ والٹ میں راز بنیادی باتیں ہیں۔ ریٹ لمٹس، انوملی الرٹس، اور ڈیٹا منیمائزیشن شامل کریں تاکہ ایجنٹ کو کبھی بھی اس سے زیادہ نہ بھیجنا پڑے جو اسے درکار ہے۔
Q4:مجھے اپنے ایجنٹ میں رائٹ آپریشنز کے لیے ریٹرائیز کو کیسے ہینڈل کرنا چاہیے؟
idempotency کیز استعمال کریں تاکہ ڈپلیکیٹ کالز ڈبل چارج یا ڈبل کریٹ نہ کر سکیں۔ صرف اس وقت ریٹرائی کریں جب بیک اینڈ واضح طور پر اس کی حمایت کرتا ہو اور کبھی بھی توثیق یا 4xx خرابیوں کے لیے نہیں۔
Q5:جب ایک API کال چین غلط ہو جائے تو میں اپنے ایجنٹ کو کیسے ڈیبگ کروں؟
ہر ٹول کال کو اس کے ان پُٹس، آؤٹ پُٹس، اور ٹریس ID سے منسلک ایک مختصر استدلال اسنیپ شاٹ کے ساتھ لاگ کریں۔ ایرر اسپائکس کے لیے الرٹس شامل کریں، فی ٹاسک ٹول کالز کو محدود کریں، اور تحقیقات کرتے وقت ایک فلاکی ٹول کو غیر فعال کرنے کے لیے ایک کل سوئچ رکھیں۔
