Hermes Agent: ملفات الإعداد
آخر تحديث: 2026-08-31
ملفات الإعداد هي مركز التحكم في Hermes Agent — بالإعداد الصحيح، الوكيل يبدو كصديق قديم يفهمك؛ بالإعداد الخاطئ، يبدو كموظف جديد لا يعرف الإجراءات.
💡 نصيحة: Hermes يستخدم YAML كصيغة الإعداد الأساسية، يدعم تجاوز متغيرات البيئة، والتبديل بين البيئات المتعددة. جميع الإعدادات لها قيم افتراضية معقولة — يعمل بدون إعداد من الصندوق.
📋 المتطلبات المسبقة: الدرس 2 — التثبيت
1. ما ستتعلمه
| # | المحتوى |
|---|---|
| ❶ | البنية الكاملة لـ config.yaml |
| ❷ | شرح خيارات الإعداد الأساسية |
| ❸ | آلية تجاوز متغيرات البيئة |
| ❹ | إدارة إعداد البيئات المتعددة |
| ❺ | التحقق من الإعداد وتصحيحه |
2. القصة
(1) المشكلة: تغيير الإعداد في كل مرة تبدل البيئة
Bob يستخدم نماذج محلية أثناء التطوير، يتحول إلى API سحابية للنشر، ويحتاج مفتاحًا مختلفًا للاختبار. كل مرة يعدّل الملفات يدويًا، يخطئ أو ينسى العودة.
(2) الحل: إعداد متعدد البيئات، تبديل تلقائي
Alice تستخدم إعداد بيئات متعددة:
BASH
# بيئة التطوير: نموذج محلي
hermes config env dev
# بيئة الإنتاج: API سحابية
hermes config env prod
# بيئة الاختبار: مفتاح اختبار
hermes config env test
3. البنية الكاملة لـ config.yaml
YAML
# ~/.hermes/config.yaml
# النموذج الأساسي
model:
default: "gpt-4o-mini"
temperature: 0.7
max_tokens: 4096
# شخصية الوكيل
personality:
tone: "friendly" # friendly / professional / creative
verbosity: "balanced" # concise / balanced / detailed
# الذاكرة
memory:
working_memory_limit: 50
long_term_enabled: true
auto_extract: true
# الأدوات
tools:
enabled: true
sandbox: true
auto_approve: ["fs_read", "web_search"]
# المنصات
platforms:
telegram:
enabled: false
discord:
enabled: false
# Cron
cron:
enabled: true
timezone: "Asia/Riyadh"
# النشر
deployment:
mode: "local"
host: "0.0.0.0"
port: 8080
4. خيارات الإعداد الأساسية
(1) إعداد النموذج
YAML
model:
default: "gpt-4o-mini"
temperature: 0.7
max_tokens: 4096
top_p: 1.0
frequency_penalty: 0
presence_penalty: 0
(2) إعداد الشخصية
YAML
personality:
tone: "friendly"
verbosity: "balanced"
system_prompt: ""
(3) إعداد الذاكرة
YAML
memory:
working_memory_limit: 50
long_term_enabled: true
auto_extract: true
honcho_enabled: true
5. تجاوز متغيرات البيئة
BASH
# متغيرات البيئة تتجاوز config.yaml
export HERMES_MODEL_DEFAULT="gpt-4o"
export HERMES_PERSONALITY_TONE="professional"
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
أولوية الإعداد
graph LR
A[متغيرات البيئة] -->|أولوية قصوى| C[الإعداد الفعّال]
B[config.yaml] -->|قيم افتراضية| C
6. إدارة البيئات المتعددة
YAML
# ~/.hermes/config.dev.yaml
model:
default: "llama3.2"
deployment:
mode: "local"
# ~/.hermes/config.prod.yaml
model:
default: "gpt-4o"
security:
auth_enabled: true
BASH
hermes config env dev
hermes config env prod
7. التحقق من الإعداد وتصحيحه
BASH
hermes config validate
hermes config show
hermes config get model.default
hermes config set model.default gpt-4o
❓ أسئلة شائعة
س هل أحتاج لإعداد كل شيء يدويًا؟
ج لا.
hermes init ينشئ إعدادًا معقولًا. الصفر-إعداد يعمل مباشرة.س أين تُخزّن مفاتيح API؟
ج الأفضل في ملف
.env أو متغيرات بيئة النظام، لا في config.yaml مباشرة. استخدم ${OPENAI_API_KEY} في YAML.س كيف أتحقق من أن الإعداد صحيح؟
ج
hermes config validate يفحص جميع الإعدادات ويُبلغ عن الأخطاء.س هل يمكنني مشاركة الإعداد بين الأجهزة؟
ج نعم. استخدم Git لمزامنة
~/.hermes/. مفاتيح API تبقى في .env محلي.📖 ملخص
- config.yaml هو ملف الإعداد الرئيسي، جميع الخيارات لها قيم افتراضية
- متغيرات البيئة تتجاوز YAML — مثالية للمفاتيح والأسرار
- إعداد البيئات المتعددة: dev/prod/test، تبديل بقرار واحد
hermes config validateللتحقق،hermes config showللعرض
📝 تمارين
- أساسي (⭐): عدّل config.yaml لتغيير النموذج الافتراضي والشخصية، تحقق من التغييرات في المحادثة.
- متوسط (⭐⭐): أنشئ إعداد بيئتين (dev مع نموذج محلي، prod مع API سحابية)، تحقق من التبديل.
- متقدم (⭐⭐⭐): صمّم نظام إعداد كامل لفريقك مع متغيرات بيئة مشتركة وملفات
.envفردية.