ThunderPhone v3 اب لائیو ہے۔سیلف سرو، قیمت 2¢ فی منٹ سے شروع۔اعلان پڑھیں

Connect tools & data

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 کی صورت میں یہی تعریف۔

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

پینل یہ بھی دکھاتا ہے کہ جواب حروف اور تخمینی ٹوکنز کے لحاظ سے کتنا بڑا ہے۔ آپ کا ایجنٹ کال کے ہر مرحلے پر ٹول کا نتیجہ دوبارہ پڑھتا ہے، اس لیے 20,000 سے زیادہ حروف والے جواب کے لیے اسے مختصر کرنے کے طریقوں کے ساتھ وارننگ دی جاتی ہے، اور 100,000 سے زیادہ حروف والے جواب کو نشان زد کیا جاتا ہے کیونکہ ایجنٹ صرف اس کا آغاز دیکھتا ہے۔ ملاحظہ کریں ٹول بہت زیادہ ڈیٹا واپس کرتا ہے۔

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

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

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

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

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

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

فنکشن کے نام صرف ایک ایجنٹ پر منفرد ہونے چاہییں۔ دو کنکشن ایک ہی نام استعمال کر سکتے ہیں، مثلاً مختلف جگہوں پر محفوظ کرنے والے دو ایجنٹس میں سے ہر ایک کے لیے save_information، لیکن ایک ایجنٹ میں دونوں نہیں ہو سکتے: ایک ہی نام کے دو ٹولز کے ساتھ ایجنٹ کو محفوظ کرنا مسترد کر دیا جاتا ہے، اور کسی کنکشن کا نام تبدیل کر کے ایسا نام رکھنا بھی مسترد کر دیا جاتا ہے جو اس کے کسی ایجنٹ پر موجود کوئی دوسرا ٹول پہلے سے استعمال کر رہا ہو۔

اگلے مراحل