BuildShip

ادمج CometAPI مع سير عمل BuildShip باستخدام عقدة CometAPI Text Generator، ومشغلات REST API، والتكامل المعتمد على المفاتيح لتوليد النصوص.

BuildShip هو أداة مرئية منخفضة التعليمات البرمجية لبناء الواجهة الخلفية. استخدم عقدة المجتمع CometAPI Text Generator لإضافة توليد نصوص مدعوم بالذكاء الاصطناعي إلى أي سير عمل.

​

المتطلبات الأساسية

• حساب CometAPI مع مفتاح API نشط — احصل على مفتاحك من هنا
• حساب BuildShip — سجّل الدخول من هنا

1. احصل على مفتاح CometAPI API الخاص بك

   سجّل الدخول إلى وحدة تحكم CometAPI. انقر على Add API Key ثم انسخ مفتاح sk-xxxxx الخاص بك.

   

   
2. أنشئ workflow باستخدام مشغّل REST API

   1. في لوحة تحكم BuildShip، انقر على Create a new workflow → From Scratch.
   2. على لوحة العمل، انقر على Add Trigger ثم اختر REST API. سيؤدي ذلك إلى إنشاء endpoint قابل للاستدعاء لهذا الـ workflow.
3. أضف عقدة CometAPI Text Generator

   1. أسفل مشغّل REST API، انقر على + Add a new step.
   2. في مربع البحث بمكتبة العقد، اكتب cometapi.
   3. من قائمة Community، اختر CometAPI Text Generator.

   

   
4. اربط تكامل CometAPI

   تحدد هذه الخطوة للنقطة أي نظام لإدارة المفاتيح يجب استخدامه.

   1. انقر على العقدة لفتح Node Editor على اليمين.
   2. انتقل إلى تبويب Settings.
   3. في Key-based Integration، افتح القائمة المنسدلة واختر CometAPI.
   4. انقر على زر Save الأزرق في الزاوية العلوية اليمنى.

   
5. أضف مفتاح API الخاص بك إلى العقدة

   1. في Node Editor، انتقل إلى تبويب Inputs (أو انقر مباشرة على العقدة).
   2. انقر على أيقونة المفتاح 🔑 في الزاوية العلوية اليمنى من العقدة لفتح القائمة المنسدلة للمفاتيح.
   3. اختر + Bring your own Key.
   4. أدخل Key ID (مثلًا cometapi-key-1) والصق مفتاح sk-xxxxx الخاص بك في Value.
   5. انقر على Save.

   

   
6. اضبط معلمات الإدخال

   في تبويب Inputs الخاص بالعقدة:

   • Instructions (اختياري): عيّن دور system، مثل You are a productivity assistant.
   • Prompt: انقر على أيقونة </>، ثم اختر Trigger → Body → prompt لربط body الخاص بالطلب الوارد.
   • Advanced → Model: أدخل معرّف model الحالي الذي تريد استخدامه.

   
7. أضف عقدة Return Response واختبر

   1. أسفل عقدة CometAPI، انقر على + Add a new step ثم اختر Return Response.
   2. في حقل Body، انقر على </> واختر المتغير response من عقدة CometAPI Text Generator.
   3. انقر على Test في الزاوية العلوية اليمنى، واختر تنسيق الإدخال JSON، ثم أرسل:

   {
     "prompt": "hi"
   }
   

   4. تؤكد الاستجابة الناجحة في لوحة Result أن الـ workflow يعمل بشكل صحيح.

   

   إذا فشل الاستدعاء، فتحقق من مفتاح API الخاص بك ومن ضبط Key-based Integration على CometAPI، أو تواصل مع دعم CometAPI.

خطوة Key-based Integration (ربط العقدة بـ CometAPI) أساسية — سيؤدي تخطيها إلى حدوث أخطاء في المصادقة حتى إذا كان مفتاح API صحيحًا.