اهلا بيكم على مدونة حسام الدين حسن واللي هنتعلم فيها كل ما هو جديد في مجال الذكاء الاصطناعي، والنهاردة معانا شرح عملي لبناء وكيل ذكي بدون اي كود للمساعدة في ادارة العمل والمهام!

كيف تبني وكيل ذكاء اصطناعي (AI Agent) بـ n8n يدير عملك من تيليجرام؟ (شرح تفصيلي خطوة بخطوة)

كثير منكم طلب شرحًا لخاصية الـ AI Agent، وفي الحقيقة، أنا أستخدم وكيلاً خاصًا بي بالفعل يساعدني في إدارة مهامي اليومية. أسأله عن أي شيء له علاقة بالعمل، فيجيبني، ينشئ لي المهام، يحصل على معلومات من مشاريعي، بل ويرسل إيميلات بالنيابة عني.

في هذا المقال، سأشاركك الطريقة خطوة بخطوة لبناء وكيل ذكاء اصطناعي مشابه باستخدام منصة n8n، لتدير عملك مباشرة من تطبيق تيليجرام.

الهدف: بناء مساعد شخصي ذكي يستقبل أوامرك النصية أو الصوتية عبر تيليجرام، ويفهمها، وينفذ مهامًا محددة باستخدام أدوات مختلفة مثل ClickUp و Gmail.

---

المرحلة الأولى: التخطيط والأدوات المطلوبة

قبل أن نبدأ، دعنا نجهز الأدوات والبيئة المناسبة.

الأدوات التي سنحتاجها:

• حساب n8n: الشرح يستخدم النسخة السحابية (Cloud) المدفوعة، ولكن يمكنك تطبيق نفس الخطوات على النسخة المجانية التي تثبتها على جهازك (Localhost)، مع اختلافات بسيطة في خطوات الربط (Credentials).
• حساب تيليجرام: لإنشاء البوت الذي سيكون واجهة التواصل مع وكيلنا الذكي.
• حسابات في الأدوات التي تريد ربطها: مثل ClickUp لإدارة المهام، أو Gmail لإرسال الإيميلات.

n8n cloud: https://epreneurs.link/N8NAutomation “affiliate link”

Clickup: https://epreneurs.link/ClickUP “affiliate link”

---

المرحلة الثانية: إعداد الاتصال بين n8n وتيليجرام

هذه هي نقطة البداية، حيث سنجعل n8n يستمع للرسائل القادمة من تيليجرام.

1. إنشاء Workflow جديد وإضافة التريجر (Trigger)

1. اذهب إلى لوحة تحكم n8n واضغط على Create Workflow.
2. اضغط على علامة + لإضافة أول عقدة (Node)، والتي ستكون التريجر.
3. ابحث عن Telegram واختر Telegram Trigger.
4. في خانة Event، اختر On Message. هذا يعني أن الـ Workflow سيعمل عند وصول أي رسالة جديدة.

2. إنشاء بوت تيليجرام باستخدام BotFather

لكي يتمكن n8n من الوصول إلى رسائلك، تحتاج لإنشاء “بوت” وسيط.

1. في تيليجرام، ابحث عن @BotFather وافتح المحادثة معه.
2. اكتب الأمر /newbot.
3. سيطلب منك اسمًا للبوت، اختر أي اسم (مثال: My Assistant).
4. بعد ذلك، سيطلب اسم مستخدم (username) للبوت، ويجب أن ينتهي بكلمة bot (مثال: HossamAgentTestBot).
5. بمجرد النجاح، سيمنحك BotFather رسالة تحتوي على Token خاص بالبوت. هذا التوكن هو مفتاح الوصول السري.

3. ربط البوت بـ n8n واختبار الاتصال

1. ارجع إلى عقدة Telegram Trigger في n8n.
2. في خانة Credential، اضغط على Create New.
3. الصق الـ Token الذي حصلت عليه من BotFather في حقل Access Token.
4. احفظ الإعدادات.
5. خطوة مهمة: يجب أن تبدأ محادثة مع البوت الذي أنشأته للتو على تيليجرام وترسل له أي رسالة (مثل “مرحباً”). هذا لتفعيل الاتصال.
6. في n8n، اضغط على Test step. من المفترض أن يستقبل n8n الرسالة التي أرسلتها ويعرض لك بياناتها بصيغة JSON.

ملاحظة: البيانات المستلمة (JSON) تحتوي على معلومات هامة مثل chat.id (معرّف المحادثة) و text (نص الرسالة)، والتي سنستخدمها لاحقًا.

---

المرحلة الثالثة: بناء عقل الوكيل (AI Agent)

الآن بعد أن أصبح لدينا اتصال، حان الوقت لبناء “العقل” الذي سيفكر ويتخذ القرارات.

1. إضافة عقدة (Node) الـ AI Agent

1. اضغط على + بعد عقدة تيليجرام وابحث عن AI Agent.
2. في عقدة الـ AI Agent، انتقل إلى حقل Input وقم بتغيير الوضع من Chat Trigger إلى Define Below.
3. امسح المحتوى الموجود وقم بسحب المتغير الذي يحتوي على نص الرسالة من العقدة السابقة (عادة ما يكون {{$json[“message”][“text”]}}).

2. ربط نموذج اللغة (LLM): قلب الوكيل النابض

الوكيل يحتاج إلى نموذج لغوي كبير (LLM) ليفهم اللغة وينفذ المهام.

1. في عقدة الـ AI Agent، اذهب إلى قسم Chat Model واضغط +.
2. اختر نموذج اللغة الذي تفضله. لديك خيارات متعددة:
   • OpenAI: ممتاز ويدعم أحدث الموديلات مثل gpt-4o (موصى به لهذا المشروع).
   • Google Gemini: خيار قوي ومجاني في حدوده المعقولة.
   • OpenRouter: يمنحك الوصول إلى موديلات متنوعة مجانًا في البداية.
3. قم بربط حسابك عن طريق إضافة الـ API Key الخاص بالخدمة التي اخترتها.

3. منح الوكيل قدراته الخارقة (Tools)

هنا تكمن القوة الحقيقية للوكيل. الأدوات (Tools) هي الإجراءات التي يمكن للوكيل تنفيذها في العالم الحقيقي.

أ. التخطيط أولاً: ما الذي نريد أتمتته؟

قبل إضافة الأدوات، فكر في المهام اليدوية التي تقوم بها. في حالتي، كنت أقوم بفتح ClickUp، البحث عن قائمة المهام الخاصة بقناة اليوتيوب، ثم تصفية المهام الجاهزة للتصوير. هذه العملية تستغرق وقتًا. الهدف هو أن يقوم الوكيل بكل هذا بمجرد أن أطلب منه “ما هي الفيديوهات التي يجب تصويرها اليوم؟”.

ب. إضافة الأدوات (ClickUp, Gmail, Google Sheets)

1. في عقدة AI Agent، اذهب إلى قسم Tools واضغط +.
2. ابحث عن الأداة التي تريد إضافتها (مثال: ClickUp).
3. قم بربط حسابك.
4. حدد المورد (Resource) والعملية (Operation).
   • لـ ClickUp: قد يكون المورد هو Task والعملية هي Get Many (للحصول على مهام) أو Create (لإنشاء مهمة).
   • لـ Gmail: المورد Mail والعملية Send.

ج. الاستخدام الديناميكي للأدوات: سر الوكيل الذكي

بدلاً من جعل الأداة تبحث دائمًا في نفس القائمة أو ترسل إيميلًا لنفس الشخص، يمكننا جعلها ديناميكية.

الفكرة هي ترك بعض الحقول فارغة ليملأها الذكاء الاصطناعي بنفسه بناءً على سياق طلبك.

نستخدم صيغة خاصة تسمى from:ai. مثال:

• في أداة ClickUp: بدلاً من اختيار قائمة مهام ثابتة، يمكننا تحويل حقل List ID إلى تعبير (Expression) ونضع فيه كودًا يطلب من الذكاء الاصطناعي تحديد الـ ID المناسب.
• في أداة Gmail: في حقل To (إلى)، بدلاً من كتابة إيميل، نضع تعبيرًا يطلب من الذكاء الاصطناعي تحديد إيميل المستلم من طلبك (مثال: “أرسل إيميلًا لأحمد”).

لتحقيق ذلك، يمكننا تزويد الوكيل بقاعدة بيانات بسيطة (مثل ملف Google Sheets) تحتوي على المعلومات التي يحتاجها، مثل:

• جدول يحتوي على أسماء المشاريع والـ ID الخاص بها في ClickUp.
• جدول يحتوي على أسماء أعضاء الفريق وإيميلاتهم.

بهذه الطريقة، عندما تقول له “أعطني مهام مشروع القناة الأجنبية”، سيذهب إلى Google Sheets، يجد الـ ID المطابق، ثم يستخدمه في أداة ClickUp لجلب المهام الصحيحة.

---

المرحلة الرابعة: تلقين الوكيل (Prompt Engineering)

البرومبت (Prompt) هو مجموعة التعليمات التي تحدد شخصية الوكيل، أهدافه، وكيفية استخدامه للأدوات. هذا أهم جزء في بناء وكيل فعال.

اذهب إلى عقدة AI Agent، واختر Add Option -> System Message.

مكونات البرومبت الفعال:

1. الشخصية والهدف (Persona & Goal): عرّف الوكيل بنفسه.
   • أنت مساعد شخصي افتراضي لحسام الدين حسن. هدفك هو مساعدتي في إدارة المهام والوصول للمعلومات بسرعة.
2. تعليمات عامة (Instructions): كيف يجب أن يتصرف.
   • عندما تستلم طلبًا، قم أولاً بالتخطيط للخطوات، ثم حدد الأدوات المناسبة، ثم نفذها. قم بالرد بنفس لغة الطلب.
3. شرح للأدوات (Tools Context): عرّفه بالأدوات المتاحة ومتى يستخدمها.
   • لديك أداة ClickUp لإدارة المهام. المهام هي “فيديوهات” أو “مقالات”.
   • استخدم أداة Gmail لإرسال الإيميلات. تأكد من استخدام قاعدة بيانات جهات الاتصال للحصول على الإيميل الصحيح.
4. معلومات سياقية (Relevant Information): زوده بمعلومات ثابتة تساعده على فهم عالمك.
   • في ClickUp، حالة “Recording” تعني أن الفيديو جاهز للتصوير. حالة “Editing” تعني أنه مع محرر الفيديو.

إليك جزء من البرومبت الفعلي الذي أستخدمه:Generated code

You are a virtual assistant for Hossam Hassan. Your main goal is to help manage tasks and retrieve information efficiently.

When you receive a request, follow these steps:
1. Plan the necessary actions.
2. Select the right tools.
3. Execute the plan.
4. Respond in the same language as the request.

**Tools Guide:**
- **ClickUp (get_all):** Use this to retrieve tasks from a specific project (list). A "task" can be a "video".
- **Google Sheets (get_data):** Use this to get project IDs for ClickUp or contact emails for Gmail.
- **Gmail (send):** Use this to send emails. Make sure to format them in HTML.

**Important Context for ClickUp:**
- Status "Ideation": The content is just an idea.
- Status "Recording": The content is ready to be filmed.
- Status "Editing": The content is with the video editor.

content_copydownloadUse code with caution.

---

المرحلة الخامسة: استكمال الدائرة وإرسال الرد

أخيرًا، بعد أن يفكر الوكيل وينفذ المهمة، نحتاج منه أن يرسل لنا الرد.

1. أضف عقدة جديدة بعد الـ AI Agent وابحث عن Telegram.
2. اختر العملية Send Message.
3. في حقل Chat ID، قم بربطه بالمتغير chat.id الذي حصلنا عليه من التريجر في أول خطوة.
4. في حقل Text، قم بربطه بنتيجة المخرجات (output) من عقدة الـ AI Agent.

لمسة متقدمة: التعامل مع الرسائل الصوتية

إذا أردت أن يفهم الوكيل رسائلك الصوتية:

1. أضف عقدة IF بعد التريجر للتحقق مما إذا كانت الرسالة تحتوي على حقل voice أم حقل text.
2. إذا كانت صوتية، استخدم عقدة OpenAI بعملية Audio -> Create Transcription (Whisper) لتحويل الصوت إلى نص.
3. قم بتوجيه النص الناتج إلى عقدة الـ AI Agent.

---

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

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

لا تتردد في تجربة أدوات مختلفة، تعديل البرومبت، ومراقبة سجلات التنفيذ (Execution Logs) في n8n لفهم “طريقة تفكير” وكيلك وتصحيح أخطائه.

هل أعجبك هذا الشرح؟

• للحصول على قالب هذا الـ Workflow جاهزًا، يمكنك الانضمام إلى سيرفر الديسكورد الخاص بنا “نادي الذكاء الاصطناعي والأتمتة العربية”.
• شاركنا في التعليقات أفكارك أو التحديات التي واجهتها