Connect tools & data

اتصالات API

حوّل أي واجهة API عبر HTTP إلى دالة يمكن لوكيلك استدعاؤها أثناء المحادثة: الصق أمر cURL، وسينشئ المعالج تعريف الأداة والمعلمات والمصادقة.

اتصالات API هي دوال HTTP مخصصة يمكن لوكلائك استدعاؤها أثناء محادثة — للبحث عن طلب، أو إنشاء تذكرة، أو جلب حالة الحساب من الواجهة الخلفية الخاصة بك. عرّف نقطة النهاية مرة واحدة ضمن الاتصالات ← واجهات API (/dashboard/api-connections)؛ ويمكن للوكلاء الذين أُرفق بهم الاتصال استدعاؤه متى تطلبت المحادثة ذلك.

هناك طريقتان لإنشاء اتصال: الصق شيئًا يمكن للمعالج تحليله، أو أعدد الاتصال يدويًا.

المسار السريع: الصق وحلّل#

1. انقر على اتصال API جديد

   يُفتح مربع الحوار في المعالج. الصق نموذجًا من أمر cURL، أو مواصفة OpenAPI/Swagger، أو تصدير Postman، أو واجهة TypeScript، أو مخطط Zod في المربع.

2. انقر على تحليل

   يستنتج ThunderPhone الاتصال بالكامل من المحتوى الذي لصقته — عنوان URL، والطريقة، والرؤوس، ومخطط المعلمات المستمد من معلمات الاستعلام ونص الطلب الذي وجده. تُنقل الرؤوس التي لصقتها، بما فيها رؤوس المصادقة، إلى إعدادات نقطة النهاية.

3. أكّد الحقول المميزة

   تُفتح الإعدادات المستنتجة مع تمييز الحقول المتوقعة لمراجعتها. عدّل الأسماء والأوصاف وأنواع المعلمات لكي يفهم الوكيل متى وكيف يستدعي الدالة — فالوصف هو ما يقرأه النموذج.

4. تحقق واحفظ

   يؤدي الحفظ أولًا إلى تشغيل طلب اختبار مباشر على نقطة النهاية الخاصة بك. إذا فشل الطلب، فلن يُحفظ الاتصال — أصلح عنوان URL أو رؤوس المصادقة أو النص ثم حاول مجددًا. عند النجاح، يُخزَّن الاتصال بشارة تم التحقق.

إذا لم يتمكن المعالج من العثور على عنوان URL للطلب في المحتوى الذي لصقته، فسيخبرك بذلك — ضمّن نقطة نهاية كاملة بصيغة http(s) وحاول مجددًا.

الإعداد اليدوي#

انقر على إعداد يدوي ← في المعالج (أو هل تريد أن يستنتج الذكاء الاصطناعي هذا؟ جرّب المعالج ← للعودة). يحتوي المنشئ اليدوي على محررين:

• مرئي — حقول نموذج لاسم العرض واسم الدالة وطلب URL والطريقة (POST، GET، PUT، PATCH، DELETE) والرؤوس المخصصة ومخطط المعلمات (إضافة خاصية لكل وسيطة يمكن للوكيل توفيرها).
• JSON — التعريف نفسه بصيغة JSON خام، للصق مواصفة أداة أو ضبطها مباشرة.

تتيح لك لوحة طلب اختبار الاختيارية إرسال الطلب المُعد قبل الحفظ، وتعرض الحالة ووقت الاستجابة ومعاينة للرد. يشغّل تحقق واحفظ هذا الاختبار دائمًا ولا يحفظ إلا عند النجاح.

إدارة اتصالاتك#

يعرض كل صف اتصال حالة التحقق الخاصة به — تم التحقق، غير مختبر، أو خطأ — واسم دالته، والوكلاء الذين يستخدمونه. من قائمة إجراءات الصف، يمكنك:

• تعديل — إعادة فتح الإعدادات.
• استنساخ — تكراره كنقطة بداية (تبدأ النسخة غير مختبرة).
• سجل المراجعات — عرض الإصدارات السابقة واستعادة أحدها إلى المحرر.
• نقل — نسخ الاتصال أو نقله إلى مؤسسة أخرى تنتمي إليها. يؤدي نقله إلى إزالته من هنا؛ وقد يحتاج الوكلاء الذين استخدموه إلى إعادة الإعداد.
• حذف — إجراء دائم؛ سيحتاج الوكلاء الذين يستخدمون الاتصال إلى إعادة الإعداد.

إرفاقه بوكيل#

أضف الاتصال إلى وكيل في قسم اتصالات API في المنشئ (إنشاء وكيل). تعرض القائمة الوكلاء الذين يستخدمون كل اتصال، لكي تعرف بنظرة سريعة ما الذي يؤثر فيه أي تغيير.

الخطوات التالية#