البريد الإلكتروني — الذكاء الاصطناعي يرسل ويستقبل الرسائل
Email — AI Sends and Receives Mail — easy-to-understand guide based on official docs
البريد الإلكتروني — الذكاء الاصطناعي يرسل ويستقبل الرسائل
تخيّل هذا: ترسل بريدًا إلكترونيًا إلى وكيل الذكاء الاصطناعي الخاص بك، فيرد عليك — في نفس سلسلة المحادثة. لا تطبيق دردشة فاخر، ولا واجهة برمجية للبوتات، ولا برامج إضافية. فقط بريد إلكتروني عادي. هذا بالضبط ما يفعله محوّل بوابة البريد الإلكتروني (Email gateway adapter) لـ Hermes.
في هذا المقال، سنستعرض كيفية إعداده، وكيف يعمل تحت الغطاء، وكيف تحافظ على أمان صندوق الوارد الخاص بك.
لماذا البريد الإلكتروني؟
البريد الإلكتروني عالمي. الجميع لديه عنوان. من خلال ربط Hermes بصندوق بريدك عبر IMAP القياسي (لاستقبال الرسائل) وSMTP (لإرسالها)، تحصل على ذكاء اصطناعي محادثي يعمل مع Gmail وOutlook وYahoo وFastmail أو أي مزوّد يدعم هذه البروتوكولات.
والأفضل من ذلك: صفر اعتماديات خارجية. يستخدم المحوّل وحدات Python المدمجة imaplib وsmtplib وemail. لا حزم إضافية، ولا خدمات طرف ثالث.
ملاحظة: هذا يختلف عن مهارة البريد الإلكتروني المدمجة Himalaya، التي تتيح للوكيل إدارة صندوق بريدك عبر أوامر الطرفية. تلك تتطلب أداة
himalayaالخارجية. محوّل البوابة هذا هو المسار الأبسط والمكتفي بذاته.
قبل أن تبدأ
ستحتاج إلى ثلاثة أشياء:
- حساب بريد إلكتروني مخصص لوكيلك (من فضلك لا تستخدم بريدك الشخصي)
- تفعيل IMAP على ذلك الحساب
- كلمة مرور تطبيق إذا كنت تستخدم Gmail أو أي مزوّد يستخدم المصادقة الثنائية
لـ Gmail: فعّل المصادقة الثنائية (2FA)، ثم أنشئ كلمة مرور تطبيق على myaccount.google.com/apppasswords. ستحصل على كلمة مرور من 16 حرفًا — استخدمها بدلاً من كلمة المرور العادية.
لـ Outlook/Microsoft 365: فعّل المصادقة الثنائية، وأنشئ كلمة مرور تطبيق تحت “خيارات الأمان الإضافية”، واستخدم outlook.office365.com لـ IMAP وsmtp.office365.com لـ SMTP.
لمزوّدين آخرين، راجع وثائقهم لمعرفة خوادم IMAP/SMTP والمنافذ (عادةً 993 لـ IMAP SSL و587 لـ SMTP STARTTLS).
الخطوة 1: إعداد Hermes
أسهل طريقة هي معالج الإعداد:
hermes gateway setup
اختر Email من القائمة واتبع التعليمات. سيطلب منك عنوان بريدك، وكلمة مرور التطبيق، وخوادم IMAP/SMTP، والمرسلين المسموحين.
تفضّل الإعداد اليدوي؟ أضف هذا إلى ~/.hermes/.env:
# مطلوب
EMAIL_ADDRESS=hermes@gmail.com
EMAIL_PASSWORD=abcd efgh ijkl mnop # كلمة مرور التطبيق، وليس كلمة مرورك العادية
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com
# الأمان (موصى به)
EMAIL_ALLOWED_USERS=your@email.com,colleague@work.com
# اختياري
EMAIL_IMAP_PORT=993 # الافتراضي: 993
EMAIL_SMTP_PORT=587 # الافتراضي: 587
EMAIL_POLL_INTERVAL=15 # الثواني بين فحوصات صندوق الوارد
EMAIL_HOME_ADDRESS=your@email.com # وجهة التسليم الافتراضية لمهام cron
الخطوة 2: تشغيل البوابة
hermes gateway # تشغيل في المقدمة
hermes gateway install # تثبيت كخدمة مستخدم
sudo hermes gateway install --system # لينكس: خدمة نظام عند الإقلاع
عند بدء التشغيل، يختبر المحوّل اتصالات IMAP وSMTP، ويعلّم جميع رسائل صندوق الوارد الموجودة كـ“مقروءة” (حتى يعالج الرسائل الجديدة فقط)، ويبدأ الفحص الدوري.
كيف يعمل
استقبال الرسائل. يتحقق المحوّل من الرسائل غير المقروءة كل 15 ثانية افتراضيًا. لكل رسالة جديدة:
- سطر الموضوع يُضمَّن كسياق (مثل:
[Subject: Deploy to production]) - الردود (المواضيع التي تبدأ بـ
Re:) تتخطى بادئة الموضوع — سياق السلسلة موجود بالفعل - المرفقات تُخزَّن محليًا: الصور تصبح متاحة لأداة الرؤية، والمستندات مثل PDF وZIP للوصول إلى الملفات
- رسائل HTML فقط تُزال وسومها لاستخراج النص العادي
- الرسائل الذاتية تُصفّى لمنع حلقات الرد
- المرسلون الآليون يُتجاهلون بصمت —
noreply@وmailer-daemon@وbounce@والرسائل التي تحتوي على ترويساتAuto-SubmittedأوPrecedence: bulkأوList-Unsubscribe
إرسال الردود. تُرسل الردود عبر SMTP مع ترابط صحيح: ترويسات In-Reply-To وReferences تحافظ على تماسك المحادثة، والموضوع يحتفظ ببادئة Re: (بدون Re: Re: مكررة)، وتُرسل الردود كنص UTF-8 عادي.
مرفقات الملفات. تريد أن يرسل الوكيل ملفًا؟ فقط أدرج MEDIA:/path/to/file في رده وسيُرفق تلقائيًا.
تخطي المرفقات. قلق من البرمجيات الخبيثة أو استهلاك النطاق؟ أضف هذا إلى config.yaml:
platforms:
email:
skip_attachments: true
نص البريد الإلكتروني لا يزال يُعالج بشكل طبيعي — فقط المرفقات تُتجاهل.
التحكم في الوصول: كن صارمًا افتراضيًا
البريد الإلكتروني أكثر تقييدًا من منصات الدردشة بحكم التصميم:
EMAIL_ALLOWED_USERSمضبوط → فقط الرسائل من تلك العناوين تُعالج- لا قائمة مسموح بها → المرسلون غير المعروفين يُتجاهلون بصمت
EMAIL_ALLOW_ALL_USERS=true→ أي مرسل مقبول (استخدم بحذر!)platforms.email.unauthorized_dm_behavior: pair→ المرسلون غير المعروفين يتلقون رمز اقتران
القاعدة الذهبية: استخدم صندوق وارد مخصص وضبط EMAIL_ALLOWED_USERS دائمًا. اقتران البريد الإلكتروني اختياري لأن صناديق الوارد المشتركة غالبًا تحتوي على رسائل غير مقروءة غير ذات صلة — لا يجب أن يرد Hermes على تلك جهات الاتصال افتراضيًا.
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| “IMAP connection failed” عند بدء التشغيل | تحقق من EMAIL_IMAP_HOST وEMAIL_IMAP_PORT. تأكد من تفعيل IMAP على الحساب (Gmail: الإعدادات ← إعادة التوجيه و POP/IMAP) |
الخلاصة
محوّل بوابة البريد الإلكتروني يحوّل أي صندوق بريد قياسي إلى قناة تواصل لوكيل الذكاء الاصطناعي الخاص بك. لا اعتماديات خارجية، ولا عملاء خاصون — فقط IMAP وSMTP وقليل من الإعداد. أنشئ حسابًا مخصصًا، وقيّد المرسلين المسموحين، ودع الرسائل تتدفق.
بريدًا سعيدًا! 📧
📖 التوثيق الرسمي
この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › user-guide/messaging/email