Tutorial 14: Profiles — Multiple Agents, One Machine
Tutorial 14: Profiles — Multiple Agents, One Machine — easy-to-understand guide based on official docs
الدرس 14: الملفات الشخصية — وكلاء متعددون، جهاز واحد
لقد استمتعت باستخدام Hermes Agent، لكنك الآن تفكر: “ماذا لو تمكنت من تشغيل مساعد برمجة وبوت أبحاث على نفس الجهاز، دون أن يتداخلا مع بعضهما البعض؟” هذا بالضبط ما صُممت من أجله الملفات الشخصية.
ما هي الملفات الشخصية؟
فكّر في الملف الشخصي على أنه منزل منفصل لكل وكيل Hermes. يحصل كل ملف شخصي على دليل خاص به يحتوي على config.yaml و.env وSOUL.md والذكريات والجلسات والمهارات والمهام المجدولة وقاعدة بيانات الحالة الخاصة به. هذا يعني أنه يمكنك تشغيل مساعد برمجة وبوت شخصي ووكيل أبحاث جنبًا إلى جنب — لكل منها مفاتيح API الخاصة به وشخصيته وذاكرته — دون أن يختلط أي منها بالآخر.
تحذير مهم: لا توجه عمليتي وكيل إلى نفس الملف الشخصي أبدًا. كلاهما يكتب الذاكرة تلقائيًا، ويقوم كل منهما بتحميل كتابات الآخر في سياق النظام الخاص به عند بدء الجلسة. كاتبان في منزل واحد سيعملان على مضاعفة حالة بعضهما البعض حتى تتوقف عن كونها شيئًا قمت بتهيئته. الملفات الشخصية موجودة بالضبط لمنع هذا. إذا احتاج الوكلاء إلى ذاكرة مشتركة، فاستخدم مزود ذاكرة خارجي بدلاً من ذلك.
بداية سريعة
البدء بسيط للغاية:
hermes profile create coder # creates profile + "coder" command alias
coder setup # configure API keys and model
coder chat # start chatting
هذا كل شيء! بمجرد إنشاء ملف شخصي، يصبح أمرًا خاصًا به. أنشئ واحدًا باسم coder وستحصل فورًا على coder chat وcoder setup وcoder gateway start وهكذا.
إنشاء ملف شخصي
لديك عدة خيارات عند إنشاء ملف شخصي:
ملف شخصي فارغ — يبدأ من الصفر مع تضمين المهارات المرفقة:
hermes profile create mybot
ثم شغّل mybot setup لتهيئة مفاتيح API والنموذج ورموز البوابة.
استنساخ الإعدادات فقط — ينسخ config.yaml و.env وSOUL.md والمهارات من ملفك الشخصي الحالي:
hermes profile create work --clone
نفس مفاتيح API والإمكانات، لكن بجلسات وذاكرة جديدة. عدّل ~/.hermes/profiles/work/.env لمفاتيح API مختلفة، أو ~/.hermes/profiles/work/SOUL.md لشخصية مختلفة.
استنساخ كل شيء — لقطة عمل كاملة:
hermes profile create backup --clone-all
هذا ينسخ الإعدادات ومفاتيح API والشخصية وجميع الذكريات والمهارات والمهام المجدولة والإضافات. يُستثنى السجل الخاص بكل ملف شخصي (سجل الجلسات وقواعد بيانات الحالة والنسخ الاحتياطية) لأنها قد تصل إلى عشرات الجيجابايت. للحصول على نسخة احتياطية كاملة تشمل السجل، استخدم hermes profile export أو hermes backup.
استنساخ من ملف شخصي محدد:
hermes profile create work --clone-from coder
يمكن دمجه مع --clone-all للحصول على نسخة كاملة من الملف الشخصي المصدر.
نصيحة احترافية: إذا كنت تخطط لاستخدام ملف شخصي كعامل في لوحة كانبان، مرر --description "<الدور>" عند الإنشاء حتى يعرف المنسق ما يجيده:
hermes profile create researcher --description "Reads source code and external docs, writes findings."
استخدام الملفات الشخصية يوميًا
أسماء الأوامر البديلة — يحصل كل ملف شخصي تلقائيًا على اسم أمر بديل:
coder chat # chat with the coder agent
coder setup # configure coder's settings
coder gateway start # start coder's gateway
coder doctor # check coder's health
coder skills list # list coder's skills
coder config set model.default anthropic/claude-sonnet-4
علامة -p — يمكنك أيضًا استهداف ملف شخصي صراحةً مع أي أمر:
hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "hello" # works in any position
الافتراضي الثابت — عيّن ملفًا شخصيًا افتراضيًا بحيث تستهدف أوامر hermes العادية ذلك الملف:
hermes profile use coder
hermes chat # now targets coder
hermes profile use default # switch back
إنها مثل kubectl config use-context — بسيطة وفعالة.
معرفة مكانك — تعرض واجهة الأوامر دائمًا الملف الشخصي النشط:
- الموجه:
coder ❯بدلاً من❯ - اللافتة: تعرض
Profile: coderعند بدء التشغيل hermes profile: تعرض اسم الملف الشخصي الحالي ومساره ونموذجه وحالة البوابة
الملفات الشخصية مقابل مساحات العمل مقابل الصناديق الرملية
غالبًا ما يتم الخلط بين هذه المفاهيم، لكنها أشياء مختلفة:
- الملف الشخصي يمنح Hermes دليل الحالة الخاص به: الإعدادات والذاكرة والجلسات والسجلات والمهام المجدولة وحالة البوابة.
- مساحة العمل أو دليل العمل هو المكان الذي تبدأ منه أوامر الطرفية — ويتم التحكم فيه بشكل منفصل بواسطة
terminal.cwd. - الصندوق الرملي يحد من الوصول إلى نظام الملفات. الملفات الشخصية لا تضع الوكيل في صندوق رملي.
في الخلفية الطرفية الافتراضية local، لا يزال الوكيل يتمتع بنفس الوصول إلى نظام الملفات الذي يتمتع به حساب المستخدم الخاص بك. الملف الشخصي لا يمنعه من الوصول إلى المجلدات خارج دليل الملف الشخصي.
الخلاصة
الملفات الشخصية هي أنظف طريقة لتشغيل عدة وكلاء Hermes مستقلين على جهاز واحد. يحصل كل منها على هويته وذاكرته وإعداداته الخاصة — ولا يحتاج أي منها إلى معرفة وجود الآخر. جرّبها مع hermes profile create وشاهد كيف يصبح سير عملك متعدد الوكلاء أكثر سلاسة!
📖 التوثيق الرسمي
この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › user-guide/profiles