API کنکشنز
API کنکشنز حسب ضرورت HTTP فنکشنز ہیں جنہیں آپ کے ایجنٹس گفتگو کے دوران کال کر سکتے ہیں — آرڈر تلاش کریں، ٹکٹ بنائیں، اپنے بیک اینڈ سے اکاؤنٹ کی حالت حاصل کریں۔ آپ اینڈ پوائنٹ کو ایک بار کنکشنز → APIs (/dashboard/api-connections) کے تحت متعین کرتے ہیں؛ جن ایجنٹس کے ساتھ کنکشن منسلک ہو، وہ گفتگو کی ضرورت کے مطابق اسے کال کر سکتے ہیں۔
اسے بنانے کے دو طریقے ہیں: ایسی چیز پیسٹ کریں جس کا وزرڈ تجزیہ کر سکے، یا کنکشن کو دستی طور پر ترتیب دیں۔
فوری طریقہ: پیسٹ کریں اور تجزیہ کریں
- نیا API کنکشن پر کلک کریں
ڈائیلاگ وزرڈ میں کھلتا ہے۔ باکس میں ایک نمونہ cURL کمانڈ، OpenAPI/Swagger وضاحت, Postman ایکسپورٹ, TypeScript انٹرفیس، یا Zod اسکیما پیسٹ کریں۔
- تجزیہ کریں پر کلک کریں
ThunderPhone آپ کے پیسٹ کردہ مواد سے پورا کنکشن اخذ کرتا ہے — URL، طریقہ، ہیڈرز، اور اس میں پائے گئے کوئری پیرامیٹرز اور ریکویسٹ باڈی سے اخذ کردہ پیرامیٹر اسکیما۔ آپ کے پیسٹ کردہ ہیڈرز (بشمول تصدیقی ہیڈرز) اینڈ پوائنٹ کنفیگریشن میں شامل کر دیے جاتے ہیں۔
- نمایاں کردہ فیلڈز کی تصدیق کریں
اخذ کردہ کنفیگریشن اندازہ لگائے گئے فیلڈز کو جائزے کے لیے نمایاں کر کے کھلتی ہے۔ ناموں، وضاحتوں، اور پیرامیٹر کی اقسام کو ایڈجسٹ کریں تاکہ ایجنٹ سمجھ سکے کہ فنکشن کو کب اور کیسے کال کرنا ہے — ماڈل وضاحت ہی پڑھتا ہے۔
- توثیق کریں اور محفوظ کریں
محفوظ کرنے سے پہلے آپ کے اینڈ پوائنٹ کے خلاف ایک لائیو ٹیسٹ ریکویسٹ چلائی جاتی ہے۔ اگر ریکویسٹ ناکام ہو جائے تو کنکشن محفوظ نہیں ہوتا — URL، تصدیقی ہیڈرز، یا باڈی درست کریں اور دوبارہ کوشش کریں۔ کامیابی پر کنکشن توثیق شدہ بیج کے ساتھ محفوظ ہو جاتا ہے۔
اگر وزرڈ آپ کے پیسٹ کردہ مواد میں ریکویسٹ URL تلاش نہ کر سکے تو یہ آپ کو بتائے گا —
ایک مکمل http(s) اینڈ پوائنٹ شامل کریں اور دوبارہ کوشش کریں۔
دستی ترتیب
وزرڈ میں دستی طور پر ترتیب دیں → پر کلک کریں (یا واپس جانے کے لیے کیا آپ چاہتے ہیں کہ AI اسے اخذ کرے؟ وزرڈ آزمائیں → پر کلک کریں)۔ دستی بلڈر میں دو ایڈیٹرز ہوتے ہیں:
- بصری — ڈسپلے نام، فنکشن نام، ریکویسٹ
URL، طریقہ (
POST,GET,PUT,PATCH,DELETE)، حسب ضرورت ہیڈرز، اور پیرامیٹر اسکیما کے لیے فارم فیلڈز (ایجنٹ کی فراہم کردہ ہر آرگومنٹ کے لیے پراپرٹی شامل کریں)۔ - JSON — براہ راست ٹول وضاحت پیسٹ کرنے یا باریک ایڈجسٹمنٹ کے لیے، خام JSON میں یہی تعریف۔
ایک ٹیسٹ ریکویسٹ پینل (اختیاری) آپ کو محفوظ کرنے سے پہلے ترتیب شدہ ریکویسٹ چلانے دیتا ہے اور حالت، تاخیر، اور جواب کا پیش منظر دکھاتا ہے۔ توثیق کریں اور محفوظ کریں ہمیشہ یہ ٹیسٹ چلاتا ہے اور صرف کامیابی پر محفوظ کرتا ہے۔
اپنے کنکشنز کا انتظام کریں
ہر کنکشن قطار اپنی توثیق کی حالت — توثیق شدہ، غیر آزمودہ، یا خرابی — اپنا فنکشن نام، اور اسے استعمال کرنے والے ایجنٹس دکھاتی ہے۔ قطار کے ایکشن مینو سے آپ یہ کر سکتے ہیں:
- ترمیم کریں — کنفیگریشن دوبارہ کھولیں۔
- کلون کریں — اسے نقطۂ آغاز کے طور پر نقل بنائیں (کاپی غیر آزمودہ حالت میں شروع ہوتی ہے)۔
- نظرثانی کی ہسٹری — پچھلے ورژنز دیکھیں اور کسی ایک کو ایڈیٹر میں بحال کریں۔
- منتقل کریں — کنکشن کو کسی دوسری تنظیم میں کاپی یا منتقل کریں جس سے آپ وابستہ ہیں۔ منتقل کرنے سے یہ یہاں سے ہٹ جاتا ہے؛ اسے استعمال کرنے والے ایجنٹس کو دوبارہ ترتیب دینے کی ضرورت پڑ سکتی ہے۔
- حذف کریں — مستقل؛ کنکشن استعمال کرنے والے ایجنٹس کو دوبارہ ترتیب دینا ہوگا۔
اسے ایک ایجنٹ کے ساتھ منسلک کریں
بلڈر کے API کنکشنز سیکشن میں کنکشن کو کسی ایجنٹ کے ساتھ شامل کریں (ایک ایجنٹ بنائیں)۔ فہرست دکھاتی ہے کہ ہر کنکشن کو کون سے ایجنٹس استعمال کرتے ہیں، تاکہ آپ ایک نظر میں جان سکیں کہ کسی تبدیلی کا اثر کہاں پڑے گا۔