دليل نشر وكيل Hermes على خوادم Google وربطه بتطبيق Telegram

يتيح نشر وكيل Hermes عبر تطبيق Telegram للمطورين بناء مساعد ذكي يتذكر المحادثات وينفذ الأوامر بشكل مستقل. على عكس روبوتات الدردشة التقليدية، يعمل وكيل Hermes Agent مفتوح المصدر من شركة NousResearch كنظام تشغيل متكامل. يمكنه كتابة نصوص Python، وإدارة ذاكرة طويلة المدى، والبقاء على اتصال دائم من خلال منصة Google Compute Engine.

لتحقيق هذا التشغيل المستمر، يعد نشر الوكيل على جهاز ظاهري سحابي مخصص أمراً ضرورياً. يوضح هذا الدليل العملية الدقيقة لتجهيز الخادم، وتكوين أحدث إصدار من نموذج Gemini 2.5 Flash، وأتمتة العملية الخلفية (Background Process).

قبل البدء، تأكد من امتلاك معرف مشروع Google Cloud ومفتاح واجهة برمجة التطبيقات من منصة Google AI Studio. يتطلب الوكيل قدرة حوسبة متوسطة للتعامل مع استخدام الأدوات بفعالية.

1. قم بإنشاء مثيل (Instance) على منصة Google Compute Engine باستخدام الأمر التالي:

gcloud compute instances create hermes-agent-vm \n    --project=YOUR_PROJECT_ID \n    --zone=us-central1-a \n    --machine-type=e2-medium \n    --image-family=ubuntu-2204-lts \n    --image-project=ubuntu-os-cloud \n    --boot-disk-size=30GB \n    --metadata=startup-script='#!/bin/bash\n        apt-get update\n        apt-get install -y git curl python3-pip python3-venv nodejs npm\n    '

2. اتصل بالجهاز الظاهري عبر بروتوكول SSH ونفذ البرنامج النصي الرسمي للتثبيت:

gcloud compute ssh hermes-agent-vm --zone=us-central1-a\ncurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash\nsource ~/.bashrc

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

3. قم بتعديل ملف التكوين لتحديد النموذج الدقيق بدون استخدام بادئة Google:

model:\n  provider: gemini\n  default: "gemini-2.5-flash"\nterminal:\n  backend: local\ngateway:\n  provider: telegram\nauxiliary:\n  title_generation: { provider: gemini, model: "gemini-2.5-flash" }\n  summarization: { provider: gemini, model: "gemini-2.5-flash" }

4. أضف مفتاح واجهة برمجة التطبيقات وصلاحيات البوابة إلى ملف البيئة:

echo "GOOGLE_API_KEY=YOUR_API_KEY" >> ~/.hermes/.env\necho "GATEWAY_ALLOW_ALL_USERS=true" >> ~/.hermes/.env

لضمان بقاء الوكيل نشطاً بعد قطع اتصال SSH، يجب تكوين خدمة نظام (System Service). يضمن ذلك إعادة تشغيل البوابة تلقائياً في حال تعطلها.

5. قم بإنشاء ملف خدمة Systemd:

[Unit]\nDescription=Hermes Agent Gateway\nAfter=network.target\n\n[Service]\nType=simple\nUser=root\nEnvironment=HOME=/root\nEnvironment=PYTHONUNBUFFERED=1\nExecStartPre=/usr/bin/pkill -9 -f hermes || true\nExecStart=/usr/local/lib/hermes-agent/venv/bin/hermes gateway run\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target

6. قم بتمكين وبدء تشغيل العملية الخلفية (Background Process):

sudo systemctl daemon-reload\nsudo systemctl enable hermes\nsudo systemctl restart hermes

• خطأ عدم العثور على النموذج 404: يقوم وكيل Hermes بترميز نماذج المعاينة القديمة للمهام المساعدة. يجب عليك تجاوز نماذج إنشاء العناوين والتلخيص يدوياً إلى نموذج Gemini 2.5 Flash في ملف YAML.
• ارتباك البادئة: تجنب استخدام بادئة "google/" في معرف النموذج. يمنع استخدام الاسم المختصر فشل توجيه واجهة برمجة التطبيقات.
• تعارض العمليات: إذا كانت البوابة قيد التشغيل بالفعل، فستفشل خدمة Systemd. يضمن إضافة أمر إنهاء مسبق بيئة إقلاع (Boot) نظيفة.

يمثل الانتقال من روبوتات الدردشة البسيطة إلى وكلاء بمستوى نظام التشغيل OS مثل Hermes قفزة نوعية في فائدة الذكاء الاصطناعي. من خلال منح الوكيل القدرة على تنفيذ أوامر Shell وإدارة ذاكرة طويلة المدى، يبتكر المطورون توائم رقمية بدلاً من مجرد واجهات حوارية.

ومع ذلك، يسلط هذا النشر الضوء على عنق زجاجة حرج في تطوير الذكاء الاصطناعي الحديث، وهو جمود أطر العمل. مع التحديث السريع لنماذج مثل Gemini 2.5 Flash، غالباً ما تتعطل التبعيات المبرمجة مسبقاً في الأدوات مفتوحة المصدر. أصبح الاعتماد على تجاوزات التكوين الصريحة ممارسة إلزامية للحفاظ على استقرار عمليات النشر السحابية.