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-..."

أولوية الإعداد

100%
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 محلي.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): عدّل config.yaml لتغيير النموذج الافتراضي والشخصية، تحقق من التغييرات في المحادثة.
  2. متوسط (⭐⭐): أنشئ إعداد بيئتين (dev مع نموذج محلي، prod مع API سحابية)، تحقق من التبديل.
  3. متقدم (⭐⭐⭐): صمّم نظام إعداد كامل لفريقك مع متغيرات بيئة مشتركة وملفات .env فردية.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%