API کنکشنز

کسی بھی HTTP API کو ایک ایسے فنکشن میں تبدیل کریں جسے آپ کا ایجنٹ گفتگو کے دوران کال کر سکے: ایک cURL کمانڈ پیسٹ کریں، اور وزرڈ ٹول کی تعریف، پیرامیٹرز، اور تصدیق تیار کر دے گا۔

API کنکشنز حسب ضرورت HTTP فنکشنز ہیں جنہیں آپ کے ایجنٹس گفتگو کے دوران کال کر سکتے ہیں — آرڈر تلاش کریں، ٹکٹ بنائیں، یا اپنے بیک اینڈ سے اکاؤنٹ کی حیثیت حاصل کریں۔ آپ اینڈ پوائنٹ کو ایک بار کنکشنز → APIs (/dashboard/api-connections) کے تحت متعین کرتے ہیں؛ جن ایجنٹس کے ساتھ کنکشن منسلک ہو، وہ گفتگو کی ضرورت کے مطابق اسے کال کر سکتے ہیں۔

اسے بنانے کے دو طریقے ہیں: کوئی ایسی چیز پیسٹ کریں جس کا وزرڈ تجزیہ کر سکے، یا کنکشن دستی طور پر ترتیب دیں۔

تیز طریقہ: پیسٹ کریں اور تجزیہ کریں#

1. نیا API کنکشن پر کلک کریں

   ڈائیلاگ وزرڈ پر کھلتا ہے۔ باکس میں نمونہ cURL کمانڈ، OpenAPI/Swagger اسپیک، Postman ایکسپورٹ، TypeScript انٹرفیس، یا Zod اسکیما پیسٹ کریں۔

2. تجزیہ کریں پر کلک کریں

   ThunderPhone آپ کے پیسٹ کردہ مواد سے مکمل کنکشن اخذ کرتا ہے — URL، طریقہ، ہیڈرز، اور اسے ملنے والے کوئری پیرامیٹرز اور ریکویسٹ باڈی سے اخذ کردہ پیرامیٹر اسکیما۔ آپ کے پیسٹ کردہ ہیڈرز (بشمول تصدیقی ہیڈرز) اینڈ پوائنٹ کنفیگریشن میں شامل کر دیے جاتے ہیں۔

3. نمایاں کردہ فیلڈز کی تصدیق کریں

   اخذ کردہ کنفیگریشن جائزے کے لیے اندازہ لگائے گئے فیلڈز کو نمایاں کر کے کھلتی ہے۔ نام، وضاحتیں، اور پیرامیٹر کی اقسام ایڈجسٹ کریں تاکہ ایجنٹ سمجھے کہ فنکشن کو کب اور کیسے کال کرنا ہے — ماڈل وضاحت ہی پڑھتا ہے۔

4. تصدیق کریں اور محفوظ کریں

   محفوظ کرنے سے پہلے آپ کے اینڈ پوائنٹ کے خلاف ایک براہ راست ٹیسٹ ریکویسٹ چلتی ہے۔ اگر ریکویسٹ ناکام ہو جائے تو کنکشن محفوظ نہیں ہوتا — URL، تصدیقی ہیڈرز، یا باڈی درست کریں اور دوبارہ کوشش کریں۔ کامیابی پر کنکشن تصدیق شدہ بیج کے ساتھ محفوظ ہو جاتا ہے۔

اگر وزرڈ آپ کے پیسٹ کردہ مواد میں ریکویسٹ URL نہ ڈھونڈ سکے تو وہ بتائے گا — ایک مکمل http(s) اینڈ پوائنٹ شامل کریں اور دوبارہ کوشش کریں۔

دستی ترتیب#

وزرڈ میں دستی طور پر ترتیب دیں → پر کلک کریں (یا واپس جانے کے لیے AI سے یہ اخذ کروانا چاہتے ہیں؟ وزرڈ آزمائیں → پر کلک کریں)۔ دستی بلڈر میں دو ایڈیٹرز ہیں:

• بصری — ڈسپلے نام، فنکشن نام، ریکویسٹ URL، طریقہ (POST, GET, PUT, PATCH, DELETE)، حسب ضرورت ہیڈرز، اور پیرامیٹر اسکیما کے لیے فارم فیلڈز (پراپرٹی شامل کریں ہر اس آرگومنٹ کے لیے جو ایجنٹ فراہم کر سکتا ہے)۔
• JSON — براہ راست ٹول اسپیک پیسٹ کرنے یا باریک ایڈجسٹمنٹ کے لیے خام JSON کی صورت میں یہی تعریف۔

ایک ٹیسٹ ریکویسٹ پینل (اختیاری) آپ کو محفوظ کرنے سے پہلے کنفیگر کردہ ریکویسٹ چلانے دیتا ہے اور حیثیت، تاخیر، اور جواب کا پیش منظر دکھاتا ہے۔ تصدیق کریں اور محفوظ کریں ہمیشہ یہ ٹیسٹ چلاتا ہے اور صرف کامیابی پر محفوظ کرتا ہے۔

اپنے کنکشنز کا انتظام کریں#

ہر کنکشن قطار اپنی تصدیقی حیثیت — تصدیق شدہ، غیر آزمودہ، یا خرابی — اپنا فنکشن نام، اور اسے استعمال کرنے والے ایجنٹس دکھاتی ہے۔ قطار کے ایکشن مینو سے آپ یہ کر سکتے ہیں:

• ترمیم کریں — کنفیگریشن دوبارہ کھولیں۔
• نقل بنائیں — اسے ابتدائی نقطے کے طور پر نقل کریں (نقل غیر آزمودہ حالت میں شروع ہوتی ہے)۔
• نظرثانی ہسٹری — پچھلے ورژن دیکھیں اور کسی ایک کو ایڈیٹر میں بحال کریں۔
• منتقل کریں — کنکشن کو کسی دوسری تنظیم میں کاپی یا منتقل کریں جس سے آپ وابستہ ہوں۔ منتقل کرنے سے یہ یہاں سے ہٹ جاتا ہے؛ اسے استعمال کرنے والے ایجنٹس کو دوبارہ کنفیگر کرنے کی ضرورت پڑ سکتی ہے۔
• حذف کریں — مستقل؛ کنکشن استعمال کرنے والے ایجنٹس کو دوبارہ کنفیگر کرنا ہوگا۔

اسے ایجنٹ کے ساتھ منسلک کریں#

بلڈر کے API کنکشنز سیکشن میں ایجنٹ کے ساتھ کنکشن شامل کریں (ایجنٹ بنائیں)۔ فہرست دکھاتی ہے کہ ہر کنکشن کو کون سے ایجنٹس استعمال کرتے ہیں، تاکہ آپ ایک نظر میں جان سکیں کہ تبدیلی کس چیز پر اثر انداز ہوگی۔

اگلے مراحل#