مرجع API

ابنِ تكاملات مخصصة وأتمتة سير العمل وأدر المساعدين برمجيًا.

ملاحظة: تعمل واجهة تطبيق CollowAI على Railway. تتوفر نقاط REST لمحادثة الأداة المصغرة وWebhooks والوصول البرمجي. راجع الأقسام أدناه للتفاصيل.

نقاط نهاية HTTP

نقاط نهاية HTTP هذه متاحة لدمج الأداة المصغرة والتعامل مع Webhooks:

POST/api/chat

أرسل رسالة إلى مساعد واستلم ردًا مولّدًا بالذكاء الاصطناعي. تستخدمها الأداة المصغرة القابلة للدمج. تقبل معرف المساعد ورسالة المستخدم وسياق المحادثة الاختياري.

POST/api/webhooks/polar

مستقبل Webhook لأحداث الدفع الخاصة بـ Polar.sh (الاشتراكات، الفواتير، إلخ). قم بتكوين هذا في إعدادات مؤسسة Polar.sh.

API الخلفي

تعمل واجهة تطبيق CollowAI على Railway. تتوفر جميع نقاط النهاية عبر REST API. تشمل مجموعات الموارد الشائعة:

المساعدين

إنشاء وتحديث وحذف واستعلام المساعدين. إدارة تكويناتها ونماذجها وحالتها.

المحادثات

سرد المحادثات وإرسال الرسائل واسترجاع سجل الرسائل لأي مساعد.

مصادر المعرفة

رفع المستندات وإدارة اتصالات قواعد البيانات وتكوين قواعد المعرفة لكل مساعد.

التكاملات

ربط وإدارة التكاملات مع الأطراف الثالثة، وعرض حالة المزامنة، وتشغيل المزامنة اليدوية.

تكوين الأداة المصغرة

تكوين واسترجاع إعدادات الأداة المصغرة بما في ذلك العلامة التجارية والموضع والCSS المخصص للدردشة المدمجة.

الدماغ الثاني

استعلام المعرفة المنظمة: الكيانات والحقائق والمواضيع والعلاقات والتعارضات المستخرجة من مستنداتك.

الفوترة والاشتراكات

استعلام حالة الاشتراك، وسرد الفواتير، وإدارة معلومات الفوترة.

استخدام SDK العميل

للتكاملات المخصصة، استخدم REST API مباشرة:

# List assistants
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants

# Create an assistant
curl -X POST \
  -H "Authorization: Bearer assai_*" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Assistant"}' \
  https://api.collowai.com/api/v1/assistants

# Get Second Brain stats
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/stats

# List brain entities
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/entities

# List brain facts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/facts

# List brain topics
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/topics

# List brain relationships
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/relationships

# List brain conflicts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/conflicts

# Get brain extractions history
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/extractions

المصادقة

تم مصادقة طلبات API باستخدام مفاتيح API المولّدة من لوحة التحكم (الإعدادات، مفاتيح API). أدرج مفتاحك في رأس Authorization:

Authorization: Bearer YOUR_API_KEY