يتطور الذكاء الاصطناعي بسرعة: تُسهّل النماذج متعددة الوسائط الجديدة وواجهات برمجة التطبيقات المُحسّنة في الوقت الفعلي دمج الذكاء الاصطناعي القوي في منصات الأتمتة، بينما تُعيد النقاشات المُتوازية حول السلامة وإمكانية المُراقبة تشكيل كيفية إدارة الفرق لأنظمة الإنتاج. بالنسبة لمن يُطوّرون أنظمة أتمتة محلية، بدأ نمط عملي بالظهور: استخدام بوابة نموذج مُوحّدة (مثل كوميت ايه بي اي) للوصول إلى العديد من النماذج، وربط مكالمات النماذج هذه في مشغل أتمتة مستضاف ذاتيًا (مثل n8n) لتتمكن من التحكم في البيانات ووقت الاستجابة والتكاليف. يوضح لك هذا الدليل، خطوة بخطوة، كيفية البدء CometAPI + n8n (محلي)، ما الذي يجب الانتباه إليه، وكيفية استكشاف الأخطاء وإصلاحها عندما تسوء الأمور.

ما هو n8n ولماذا هو مهم لأتمتة الذكاء الاصطناعي؟

n8n هي أداة أتمتة سير عمل مفتوحة المصدر، مزودة بمحرر مرئي ومنظومة متكاملة من العقد (الموصلات). صُممت لتتيح لك ربط المشغلات والتحويلات واستدعاءات واجهة برمجة التطبيقات الخارجية في سير عمل متكرر (مثل خطافات الويب، والمهام المجدولة، ومعالجة الملفات، وروبوتات الدردشة، وغيرها). تتيح لك استضافة n8n ذاتيًا محليًا تحكمًا كاملاً في موقع البيانات وتنفيذها، وهو أمر بالغ الأهمية عند استدعاء نماذج الذكاء الاصطناعي الخارجية التي تتعامل مع مدخلات حساسة.

كيف يعمل n8n عمليًا؟

• لوحة مرئية تحتوي على مشغلات (Webhook وCron) وعقد الإجراءات (طلب HTTP وعقد قاعدة البيانات والبريد الإلكتروني).
• توسع عقد المجتمع إمكانياتها — يمكنك تثبيت حزم المجتمع ومعاملتها مثل العقد الأصلية.

تتيح لك الاستضافة الذاتية n8n ما يلي:

• التحكم الكامل في البيانات - تظل سير العمل وتشغيل البيانات على البنية الأساسية التي تديرها.
• التخصيص - إضافة عقد خاصة أو تكاملات محلية دون انتظار ميزات السحابة.
• القدرة على التنبؤ بالتكلفة - لا توجد مفاجآت في الفواتير السحابية لكل مهمة للأتمتة الداخلية المكثفة.
• الأمن والامتثال - سهولة تلبية احتياجات السياسة الداخلية والتنظيمية.

---

ما هو CometAPI ولماذا استخدامه كبوابة نموذجية الخاص بك؟

كوميت ايه بي اي بوابة واجهة برمجة تطبيقات موحدة تعرض مئات نماذج الذكاء الاصطناعي من جهات خارجية (نصوص، تضمينات، توليد صور، إلخ) خلف واجهة ونموذج فوترة واحدين متوافقين مع OpenAI. هذا يعني أنه بدلاً من إضافة تكاملات مخصصة لكل محرك LLM أو محرك صور ترغب في تجربته، يمكنك استدعاء واجهة برمجة تطبيقات واحدة واختيار النموذج المطلوب في الطلب. هذا يُبسط عملية التجريب، والتحكم في التكاليف، والتكامل التشغيلي.

فوائد:

• اختيار النموذج: حاول تجربة العديد من البائعين/النماذج باستخدام نفس مسار الكود.
• تجميع الرموز / الحصص المجانية: توفر العديد من البوابات الموحدة اعتمادات/مستويات للتجربة.
• البنية التحتية الأبسط: نظام مصادقة واحد وعنوان URL أساسي واحد للإدارة.

كيف يمكنني الحصول على مفاتيح ووصول CometAPI؟

1. حساب جديد في موقع CometAPI (أو لوحة معلومات البائع). معظم البوابات توفر مستوى مجانيًا للاختبار.
2. احصل على مفتاح API من لوحة معلومات CometAPI الخاصة بك - سلسلة سرية طويلة. لاحظ مكان وضعها في الوثائق (يستخدم CometAPI تفويض Bearer ضد https://api.cometapi.com/v1).
3. اقرأ وثائق واجهة برمجة التطبيقات لنقطة النهاية التي تخطط لاستخدامها (إكمال الدردشة والصور والتضمينات). توثق CometAPI نقاط النهاية مثل /v1/chat/completions و /v1/images/generations.

---

لماذا يعد الترابط (التكامل) بين n8n و CometAPI مهمًا؟

يُقصد بـ "الترابط" هنا مسار تكامل موثوق وآمن بين مُشغّل الأتمتة (n8n) وبوابة النموذج. يُعدّ الترابط السليم مهمًا للأسباب التالية:

• إنه يحفظ سياق الكلام عبر المكالمات (سجل المحادثة، والتضمينات).
• إنه مركزي أوراق اعتماد والأسرار في مكان واحد للتداول الآمن.
• يقلل من زمن الوصول وسطح الخطأ من خلال استخدام نقاط نهاية يمكن التنبؤ بها وتنسيقات الطلب القياسية.
• فإنه يمكن قابلية الملاحظة واستكشاف الأخطاء وإصلاحها - معرفة النموذج والمطالبة والاستجابة التي أدت إلى نتيجة.

باختصار: الترابط الجيد يقلل من المخاطر التشغيلية ويسرع التكرار.

كيف أقوم بنشر n8n محليًا (دليل عملي سريع)؟

يمكنك تشغيل n8n محليًا باستخدام npm أو باستخدام Docker؛ يُعد Docker Compose النهج المُوصى به لمعظم سيناريوهات الاستضافة الذاتية (فهو قابل للتكرار ويعزل التبعيات). فيما يلي مثال مُبسط لـ Docker Compose وملاحظات أساسية.

كيف أستضيف n8n ذاتيًا باستخدام Docker؟

Docker (وDocker Compose) هي الطريقة الأكثر متانة وقابلية للتكرار لتشغيل n8n في بيئة الإنتاج. فهي تعزل التطبيق، وتُسهّل الترقيات، وتتوافق جيدًا مع وكلاء عكسيين ومنسقين (Docker Swarm وKubernetes). تتضمن وثائق n8n الرسمية مرجعًا لـ Docker Compose سأتبعه وأُعدّله هنا.

بالنسبة للإنتاج، ستقوم عادةً بتشغيل مجموعة مكونة من:

• خدمة n8n (الصورة الرسمية: docker.n8n.io/n8nio/n8n or n8nio/n8n (اعتمادًا على العلامة).
• PostgreSQL (أو قاعدة بيانات مدعومة أخرى).
• Redis (إذا كنت تخطط لاستخدام وضع قائمة الانتظار).
• وكيل عكسي (Traefik أو Caddy أو nginx) لـ TLS وتوجيه المضيف وقواعد حد المعدل.

تُفصل هذه البنية بوضوح بين المهام (استمرارية قاعدة البيانات، والطوابير، ووكيل الويب) وتُسهّل عملية التوسع والنسخ الاحتياطي. تُوفّر وثائق n8n الرسمية أنماط Docker Compose ومراجع لمتغيرات البيئة.

هذا هو الدليل خطوة بخطوة:

1. إنشاء مجلد و docker-compose.yml مع خدمة n8n الأساسية. فيما يلي مثال عملي لـ docker-compose يُغطي احتياجات الإنتاج النموذجية: Postgres خارجي، Redis (لوضع قائمة الانتظار/التنفيذ)، وحدات تخزين ثابتة، وبروتوكول Nginx العكسي لمعالجة TLS:

```yaml
version: "3.8"
services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=supersecretpassword
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=admin
- N8N_BASIC_AUTH_PASSWORD=anothersecret
- WEBHOOK_TUNNEL_URL=https://n8n.example.com
- EXECUTIONS_MODE=queue
- QUEUE_BULL_REDIS_HOST=redis
    ports:
- "5678:5678"
    volumes:
- n8n_data:/home/node/.n8n
    depends_on:
- postgres
- redis

  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: supersecretpassword
    volumes:
- pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7
    volumes:
- redisdata:/data

volumes:
  n8n_data:
  pgdata:
  redisdata:

2. بدء:

docker compose up -d

3. قم بزيارة : `http://localhost:5678` وأنشئ مستخدم المسؤول. بالنسبة للإنتاج، ستحتاج إلى Postgres وSSL ومتغيرات البيئة المناسبة - راجع وثائق Docker Compose الرسمية.

**ملاحظات وتصلب:**
- Do **لست** تخزين الأسرار في نص عادي في `docker-compose.yml`؛ استخدام ملفات البيئة، أو أسرار Docker، أو مديري الأسرار الخارجية في الإنتاج.
- استبدل `WEBHOOK_URL` باستخدام عنوان URL العام الحقيقي الخاص بك وتكوين الوكيل العكسي للتوجيه `n8n.example.com` إلى الحاوية n8n.
- استعمل `EXECUTIONS_MODE=queue` لمعالجة الخلفية القوية؛ فهي تتطلب عمال قائمة انتظار وRedis.

## كيف أستضيف n8n ذاتيًا باستخدام npm / Node.js؟

يؤدي التثبيت عبر npm (أو pnpm) إلى تشغيل n8n مباشرةً على المضيف. هذا أخف (بدون طبقة حاوية) وقد يكون مفيدًا لعمليات التثبيت منخفضة التعقيد لمستخدم واحد أو لأجهزة المطورين. ومع ذلك، فإنه يضع مسؤولية أكبر على عاتق المسؤول لإدارة التبعيات والعزل والإشراف على الخدمة. تتضمن وثائق n8n الرسمية دليل تثبيت npm وتحذيرات.

### حزم نظام التشغيل المطلوبة وإصدار Node:

- استخدم Node.js LTS مستقر (Node 18 أو Node 20+، يتوافق مع متطلبات إصدار n8n).
- تثبيت `build-essential`, `git`، ومدير العملية (يوصى باستخدام systemd).
- بالنسبة للإنتاج، لا يزال بإمكانك استخدام PostgreSQL وRedis كخدمات خارجية (نفس المنطق مثل Docker).

### كيف أقوم بتثبيت وتشغيل n8n عبر npm (خطوة بخطوة)؟

1. قم بتثبيت Node.js (الموصى به: nvm)

Install nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Reload your shell (adjust to your shell startup file if needed)

source ~/.bashrc # or ~/.zshrc

Install and use the latest LTS (usually 18 or 20)

nvm install --lts
nvm use --lts

Verify

node -v
npm -v

إذا رأيت "n8n: لم يتم العثور على الأمر" لاحقًا، فأعد تشغيل المحطة الطرفية أو تأكد من أن مسار bin العالمي npm المُدار بواسطة nvm موجود على PATH الخاص بك.

---

2. قم بتثبيت وتشغيل n8n (محليًا)

npm install -g n8n
n8n -v # verify version

3. ابدأ في المقدمة:

n8n start

عنوان URL الافتراضي: <http://localhost:5678/> إذا كان المنفذ قيد الاستخدام:

export N8N_PORT=5679
n8n start

اختياري: أبقه قيد التشغيل في الخلفية (لا يزال محليًا):

npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status

![img_v3_02pg_4ee26a34-6f3f-42e3-8488-16620a6915eg.jpg](https://apidoc.cometapi.com/raiz5jee8eiph0eeFooV/api/v1/projects/810968/resources/360463/image-preview?onlineShareType=apidoc&locale=en-US)

4.الدخول أولاً وتسجيل الدخول:
- افتح http://localhost:5678/ في متصفحك.
- في التشغيل الأول، اتبع المعالج لإنشاء حساب المالك (البريد الإلكتروني + كلمة المرور) وتسجيل الدخول.

![](https://resource.cometapi.com/blog/uploads/2025/09/N8N-LOGIN-1024x795.webp)

## كيف أقوم بتثبيت أو تكوين عقدة مجتمع CometAPI في n8n؟

يدعم n8n كلاً من عقد المجتمع المُتحقق منها (التثبيت عبر واجهة المستخدم الرسومية) والتثبيت اليدوي من npm عند الاستضافة الذاتية. هناك طريقتان لدمج CometAPI في n8n:

### الخيار أ — استخدام عقدة مجتمع CometAPI (إذا كانت متوفرة في لوحة العقد)

1. في n8n افتح لوحة العقد (اضغط `+` or `Tab`).
2. CometAPI عبارة عن عقدة مجتمع تم التحقق منها، وتظهر ضمن "المزيد من المجتمع". انقر عليها وقم بالتثبيت.
3. بعد التثبيت، أعد تشغيل n8n إذا طُلب منك ذلك. أنشئ حسابًا جديدًا **الاعتماد** في الإعدادات → بيانات الاعتماد (اختر نوع بيانات اعتماد CometAPI إذا كانت العقدة توفرها) ثم الصق رمز CometAPI الخاص بك.

### الخيار ب — التثبيت اليدوي (عندما لا يتوفر تثبيت واجهة المستخدم الرسومية)

1. قم بتسجيل الدخول إلى المضيف/الحاوية n8n الخاص بك عبر SSH.

2. قم بتثبيت الحزمة في n8n العالمي `node_modules` أو المجلد المخصص الخاص بك:
- انتقل إلى الإعدادات (أسفل اليسار) > عقد المجتمع انقر فوق "
- "تثبيت عقدة مجتمعية"
- في "اسم حزمة npm"، أدخل: `@cometapi-dev/n8n-nodes-cometapi`حدد مربع إقرار المخاطر وانقر فوق "
- "التثبيت"بعد التثبيت، يمكنك البحث عن "CometAPI" في لوحة العقدة.

![](https://resource.cometapi.com/blog/uploads/2025/09/N8N-NODE-1024x784.webp)

٣. أعد تشغيل n3n. إذا كان جهازك يعمل في وضع الانتظار، فيجب عليك اتباع مسار التثبيت اليدوي الموضح في الوثائق.

### كيفية التحقق من تثبيت العقدة

- بعد إعادة التشغيل، افتح لوحة العقد وابحث عن "CometAPI" أو "Comet". سيتم تمييز العقدة كحزمة مجتمع.
- إذا لم تتمكن من رؤية العقدة: تأكد من استخدام حساب مالك المثيل الخاص بك (يمكن لمالكي المثيل فقط التثبيت)، أو من تثبيت حزمة العقدة دون أخطاء في سجلات الحاوية/الصورة.

## كيفية إنشاء سير عمل وتكوين واجهة برمجة التطبيقات (API)

### 1. إنشاء سير عمل جديد

- قم بتسجيل الدخول إلى مثيل n8n الخاص بك (المستضافة ذاتيًا).
- انقر **"إضافة سير العمل"** لبدء لوحة أتمتة جديدة.

### 2. إضافة عقدة

- أضف عقدة تشغيل: ابحث عن "التشغيل اليدوي" أو "عند النقر فوق "تنفيذ سير العمل"".
- انقر فوق "+" على الجانب الأيمن من اللوحة وابحث عن "CometAPI" لإضافة العقدة.
- يمكنك أيضًا البحث عن "CometAPI" من قائمة العقدة اليسرى وسحبها إلى اللوحة القماشية.

### 3. تكوين بيانات الاعتماد (المرة الأولى فقط):

- في عقدة CometAPI، ضمن "بيانات الاعتماد التي يجب الاتصال بها"، اختر "إنشاء جديد".
- قم بلصق الرمز الذي قمت بإنشائه في وحدة التحكم CometAPI في "مفتاح CometAPI".
- احفظ. عنوان URL الأساسي هو https://www.cometapi.com/console/ افتراضيًا، ولا يتطلب عادةً أي تغيير.

![](https://resource.cometapi.com/blog/uploads/2025/09/n8n-cometAPI-3-1024x327.webp)

### 4. تكوين النموذج والرسائل:

النموذج: أدخل نموذجًا مدعومًا، على سبيل المثال، `gpt-4o` or `gpt-4o-mini`.

الرسائل: تحتاج إلى ملء الدور والسياق، ويمكنك اختيار المستخدم أو النظام للدور

تتضمن المعلمات الاختيارية (حسب الحاجة): الحد الأقصى لعدد الرموز (مثل 4096)؛ درجة حرارة أخذ العينات (مثل 0.7)؛ تدفق العقوبة (تفعيل/تعطيل البث). للاطلاع على وثائق وشروحات المعلمات المحددة، يُرجى الرجوع إلى [وثائق CometAPI](https://api.cometapi.com/doc).

![](https://resource.cometapi.com/blog/uploads/2025/09/n8n-cometAPI-4-1024x862.webp)

### 5. تنفيذ النص:

حدد عقدة CometAPI وانقر فوق "تنفيذ الخطوة"، أو انقر فوق "تنفيذ سير العمل" في الأسفل.  
يجب أن تعرض لوحة OUTPUT الموجودة على اليمين استجابة JSON (بما في ذلك الخيارات والاستخدام وما إلى ذلك).

لقد قمت الآن بتثبيت n8n(Recommend) محليًا على Linux عبر npm، وقمت بتثبيت وتكوين عقدة مجتمع CometAPI، ويمكنك تشغيل سير العمل التي تستدعي نماذج مثل gpt-4o لتلقي الاستجابات.

## ما هي المشاكل الشائعة وكيف يمكنني استكشافها وإصلاحها؟

### 1) "401 غير مصرح به" أو "مفتاح API غير صالح"

- تأكد من صحة سلسلة الرموز في لوحة معلومات CometAPI (قد توجد رموز بأسماء مشابهة). انسخ ← الصق في بيانات اعتماد n8n، وأعد تشغيل العقدة إذا لزم الأمر.
- تأكد من تنسيق رأس التفويض `Bearer sk-xxxxx`.

### 2) لن يتم تثبيت عقدة المجتمع / "وضع قائمة الانتظار"

- إذا كان جهاز n8n الخاص بك يعمل في **وضع قائمة الانتظار**يمكن تعطيل تثبيت واجهة المستخدم الرسومية؛ اتبع تعليمات التثبيت اليدوي لتثبيت عقد المجتمع عبر npm أو إنشاء صورة مخصصة تتضمن العقدة. أعد تشغيل n8n بعد التثبيت.

### 3) لم يتم العثور على العقدة في اللوحة بعد التثبيت

- أعد تشغيل n8n.
- تأكد من تثبيت الحزمة في السياق الصحيح (داخل صورة الحاوية أو في `.n8n/custom` المسار إذا كنت تستخدم هذا النمط).
- تحقق من سجلات الحاوية بحثًا عن أخطاء حل الوحدة النمطية.

### 4) حدود المعدلات أو قضايا الحصص

- تحقق من لوحة معلومات CometAPI لمعرفة الاستخدام والحصة.
- قم بتنفيذ التراجع الأسّي والعودة إلى النماذج الأرخص عند اكتشاف تحذيرات الحد أو أخطاء HTTP 429.

## هل هناك بدائل إذا لم تكن عقدة المجتمع متاحة أو كنت تريد المزيد من المرونة؟

نعم - يمكنك دائمًا استخدام **طلب HTTP** العقدة مباشرة (التحكم الكامل) أو [عقدة OpenAI مع عنوان URL الأساسي](https://apidoc.cometapi.com/n8n-965890m0) إعادة التوجيه (اختصار عملي). يُسهّل استخدام HTTP الخام أيضًا اعتماد نقاط نهاية CometAPI الجديدة فور إصدارها (مثل نقاط نهاية الصور/الفيديو). يُرجى مراجعة [دليل](https://apidoc.cometapi.com/n8n-965890m0).

**انظر أيضا** [كيفية استخدام n8n مع CometAPI](https://www.cometapi.com/ar/how-to-use-n8n-with-cometapi/?utm_source=chatgpt.com)

## الخلاصة:

يمنحك CometAPI اختيار النموذج وسهولة التشغيل؛ بينما يمنحك n8n تنسيقًا بصريًا وقابلية للتوسع. استخدم خدعة بيانات اعتماد OpenAI لتكامل سريع للدردشة/الإكمال، وعُقد المجتمع أينما وُجدت وموثوقة. جهّز كل سير عمل من حيث التكلفة وزمن الوصول والأمان؛ وفضّل البدائل البشرية في القرارات المهمة؛ وحافظ على ديناميكية اختيار النموذج لتتمكن من التكيف مع التغييرات السريعة في مشهد بائعي الذكاء الاصطناعي. يُعدّ الجمع بين n8n وCometAPI قويًا، ولكن كجميع الأدوات القوية، فإنه يحتاج إلى حواجز أمان - الملاحظة والاختبار والتكرار.