Minds لـ n8n: دليل التثبيت وسير العمل
استخدم n8n-nodes-minds لإعداد وفحص الدراسات في n8n المستضاف ذاتياً. الإصدار 0.1.1 منشور على npm؛ والتحقق من n8n قيد المراجعة. يبدأ البحث فقط بعد تأكيد منفصل في Minds.
Minds هي منصة متكاملة للبحوث الاصطناعية التجارية. تربط عقدة مجتمع Minds سير عمل n8n الخاص بك بـ Study API: أنشئ دراسة، وأعد خطة قابلة للمراجعة، واجمع النتائج الحالية لسير عمل لاحق. يمكنك أيضاً عرض عملية Minds كأداة لوكيل ذكاء اصطناعي في n8n.
التوفر والمتطلبات
تم نشر الحزمة التي تديرها Minds n8n-nodes-minds على npm. يغطي هذا الدليل الإصدار 0.1.1، وهو الإصدار الحالي على npm. تمت الموافقة على مراجعة n8n الآلية؛ والتحقق اليدوي قيد المراجعة. هذه ليست قائمة تم التحقق منها بعد، والعقدة غير متاحة للتثبيت على n8n Cloud.
استخدم مثيل n8n مستضاف ذاتياً يسمح بحزم المجتمع، ومالك أو مسؤول يمكنه تثبيتها، وحساب Minds مع وصول إلى API. لا تزال أذونات API وحدود الاستخدام الحالية سارية. يمكنك تكوين العقدة داخل n8n؛ ولا يوجد اتصال OAuth يجب إنشاؤه في Minds.
التثبيت والاتصال
- في n8n، افتح Settings → Community Nodes → Install.
- أدخل
[email protected]، وراجع إشعار كود المجتمع الخاص بـ n8n، وقم بالتثبيت. راجع دليل تثبيت n8n إذا كان مثيلك يستخدم طريقة تثبيت مختلفة. - في Minds، افتح Settings → API Keys وأنشئ مفتاحاً لهذا التكامل.
- أضف عقدة Minds إلى سير عمل n8n. أنشئ بيانات اعتماد Minds API، والصق المفتاح في API Key، واحفظه، وقم بتشغيل اختبار الاتصال.
- حدد Study → Get Many وقم بتنفيذها لتأكيد الوصول. قد تعني القائمة الفارغة أن الحساب لا يحتوي على دراسات بعد.
يخزن n8n المفتاح في نظام بيانات الاعتماد المشفر الخاص به. احتفظ بالمفتاح في بيانات الاعتماد تلك، بدلاً من تعبيرات العقدة، أو JSON الخاص بسير العمل، أو المطالبات، أو الملفات المصدرة. تذهب الطلبات إلى https://getminds.ai/api/v1. يتحقق اختبار الاتصال من حساب Minds الموثق؛ راجع API authentication للحصول على تفاصيل الوصول.
العمليات المدعومة
تستخدم جميع العمليات الخمس مورد Study. يكشف n8n عن حمولة data الخاصة بـ API مباشرة، لذا فإن معرف الدراسة (Study ID) الذي تم إنشاؤه متاح كـ {{ $json.id }} في العقدة التالية.
| العملية | المدخلات والسلوك |
|---|---|
| Get Many | يسرد الدراسات التي يمكن الوصول إليها. اضبط Limit من 1 إلى 100، أو قم بتمكين Return All للترقيم. |
| Create | يتطلب Name. تقبل Audience IDs معرفات الجمهور الموجودة مفصولة بفواصل. تم إيقاف Enable Link Sharing افتراضياً؛ يؤدي تشغيله إلى نشر الوصول إلى الدراسة والجماهير المرفقة بها. |
| Get | يتطلب Study ID؛ يسترجع الدراسة، وجماهيرها، وMinds، والرسائل. |
| Preview Research Plan | يتطلب Study ID وResearch Request. اختر Study Locale وقدم المواد المرئية للمستجيب بشكل منفصل من خلال Source Kind، وSource Label، وSource Content أو Source URL. يحفظ مسودة خطة دون بدء البحث. |
| Get Summary | يتطلب Study ID؛ يقرأ ملخص الدراسة المحفوظ وكتل المخرجات الدلالية. لا يقوم بإنشاء أو تحديث ملخص مفقود. |
استخدم Research Request لتعليمات المخطط مثل الأسئلة التي يجب طرحها. ضع النسخة الفعلية التي يجب على المستجيبين تقييمها في Source Content. يتوفر Source Content لنوع المصدر Prompt. بالنسبة للأنواع الأخرى، مثل موقع ويب أو صورة أو فيديو، استخدم Source URL مع رابط HTTPS عام. لا يؤدي اختيار نوع المصدر إلى تحميل ملف محلي.
إعداد خطة بحث
- ابدأ بـ Manual Trigger وعقدة Minds مضبوطة على Study → Create. أدخل اسماً وصفياً ومعرفات الجمهور (Audience IDs) الموجودة التي تريد استخدامها. اترك مشاركة الرابط معطلة ما لم تكن تنوي نشر الوصول.
- قم بتوصيل عقدة Minds أخرى مضبوطة على Preview Research Plan. استخدم
{{ $json.id }}لـ Study ID. - اضبط Research Request على: "صغ ثلاثة أسئلة حول الوضوح والملاءمة والمصداقية. لا تقم بتشغيل الدراسة." حدد لغة المخرجات، واختر Source Kind كـ Prompt، وضع الرسالة أو المفهوم الدقيق في Source Content.
- قم بتشغيل سير العمل مرة واحدة. راجع المسودة المحفوظة، والجماهير، والأسئلة، والمصدر في Minds، ثم قم بالتأكيد صراحةً وبدء البحث هناك.
- في تنفيذ لاحق لسير العمل، استخدم Get مع Study ID المحفوظ لفحص الدراسة وGet Summary لجمع ملخص موجود. مرر البيانات الناتجة إلى عقد التقارير أو الإشعارات الخاصة بك حسب الاقتضاء.
احتفظ بـ Study ID بين عمليات تنفيذ سير العمل. إعادة تشغيل Create تنشئ دراسة أخرى؛ ولا تستأنف الدراسة السابقة. تجنب إعادة محاولة الإنشاء تلقائياً بعد مهلة غامضة حتى تتحقق مما إذا كانت قد نجحت.
استخدام Minds كأداة لوكيل ذكاء اصطناعي
أضف AI Agent في n8n ونموذج دردشة متوافق، ثم أرفق Minds بموصل أدوات الوكيل. حدد بيانات اعتماد Minds API، ومورد Study، والعملية المحددة التي تريد عرضها. ابدأ بـ Get Many أو Create وأعطِ الأداة وصفاً واضحاً.
على سبيل المثال: "أنشئ دراسة مسودة واحدة باسم Commuter bottle review باستخدام أداة Minds المكونة. أرجع معرفها. لا تبدأ البحث." اضبط Name في تكوين الأداة، أو استخدم التحكم في المعلمات المحدد بواسطة نموذج n8n للحقول التي تسمح للوكيل باختيارها عمداً. احتفظ ببيانات الاعتماد خارج مطالبة النموذج واترك مشاركة الرابط معطلة. تحتوي الأداة على نفس العمليات الخمس مثل العقدة العادية؛ إضافة الأداة إلى وكيل لا تمكن تنفيذ البحث.
أمثلة واستكشاف الأخطاء وإصلاحها
استورد أمثلة سير العمل من خلال Import from File في n8n: سرد الدراسات، أو إعداد خطة بحث، أو قراءة ملخص دراسة. حدد بيانات الاعتماد الخاصة بك بعد الاستيراد واملأ معرفات الجمهور أو الدراسة المطلوبة.
- العقدة مفقودة: تأكد من اسم الحزمة الدقيق، وحالة التثبيت، وأن مثيلك المستضاف ذاتياً يسمح بعقد المجتمع. لا يمكن لـ n8n Cloud تثبيت هذه الحزمة غير الموثقة.
- اختبار الاتصال أو خطأ 401: تحقق من أن بيانات الاعتماد تحتوي على مفتاح Minds API حالي وأعد الاختبار بعد استبدال مفتاح تم إلغاؤه.
- استجابة 403 أو محدودة بالخطة: تحقق من وصول API للحساب، وأذونات مساحة العمل، وبدل الاستخدام الحالي.
- الدراسة غير موجودة: استخدم معرفاً تم إرجاعه بواسطة Get Many لنفس الحساب؛ اسم الدراسة ليس معرفها.
- لا يوجد ملخص: افتح الدراسة في Minds وتحقق من اكتمال البحث ووجود ملخص. يقرأ Get Summary المخرجات المحفوظة فقط.
- 429 أو خطأ مؤقت في الخدمة: أعد محاولة القراءة مع التراجع واتبع API errors and limits. تحقق من وجود دراسة تم إنشاؤها بالفعل قبل إعادة محاولة الكتابة.
الإصدار 0.1.1 لا ينشئ جماهير، أو يحمل ملفات، أو يبدأ بحثاً، أو يحذف بيانات، أو يوفر مشغل أحداث Minds. لمزيد من العمليات، راجع Study API وتوثيق MCP. توفر النتائج الاصطناعية أدلة توجيهية؛ ولا تنشئ تقديرات تمثيلية للسكان البشريين.
تصفح جميع عمليات التكامل أو شاهد سير عمل فحص الجمهور في n8n.
