คู่มือการตั้งค่า Hermes Agent: config.yaml, .env, SOUL.md และลำดับ priority

การตั้งค่า Hermes Agent อย่างถูกต้องเป็นสิ่งสำคัญเพื่อให้ AI agent ทำงานได้อย่างมีประสิทธิภาพสูงสุด คู่มือนี้จะอธิบายโครงสร้างไฟล์ต่างๆ คำสั่งการจัดการ และลำดับความสำคัญของการตั้งค่า

โครงสร้าง Directory ของ Hermes Agent

Hermes Agent เก็บไฟล์การตั้งค่าทั้งหมดใน ~/.hermes/ ซึ่งมีโครงสร้างดังนี้:

ไฟล์หลักที่ต้องรู้จัก

config.yaml - Settings หลักของระบบ (model, terminal, TTS, compression ฯลฯ) .env - เก็บ API keys และ secrets ที่ต้องปกป้อง auth.json - เก็บ OAuth credentials (เช่นสำหรับ Nous Portal) SOUL.md - กำหนดอัตลักษณ์ของ agent (slot #1 ใน system prompt) memories/ - เก็บข้อมูลความจำถาวร (MEMORY.md, USER.md) skills/ - เก็บ skills ที่ agent สร้างขึ้น (จัดการผ่าน skill_manage tool) cron/ - เก็บงานอัตโนมัติตามกำหนดเวลา sessions/ - เก็บข้อมูลเซสชันต่างๆ logs/ - เก็บ log ไฟล์ (errors.log, gateway.log) โดย secrets จะถูกซ่อนอัตโนมัติ

คำสั่งจัดการ Config

Hermes Agent มีคำสั่งที่ใช้งานง่ายสำหรับการจัดการ config:

ดู configuration ปัจจุบัน

คำสั่งนี้จะแสดงการตั้งค่าทั้งหมดปัจจุบันในรูปแบบที่อ่านง่าย

แก้ไข config.yaml

จะเปิดไฟล์ config.yaml ใน editor ที่กำหนดไว้ในระบบ

ตั้งค่าเฉพาะเจาะจง

คำสั่งนี้มีประโยชน์มากเพราะจะ route ค่าไปยังไฟล์ที่ถูกต้องโดยอัตโนมัติ: API keys จะถูกบันทึกลงใน .env เพื่อความปลอดภัย Settings อื่นๆ จะถูกบันทึกลงใน config.yaml

ตรวจสอบ options ที่ขาดหาย

คำสั่งนี้จะตรวจสอบว่ามี options ใดที่จำเป็นแต่ยังไม่ได้ตั้งค่า

เพิ่ม missing options แบบ interactive

คำสั่งนี้จะถามคำถามเพื่อเพิ่ม options ที่ขาดหายไปอย่างง่ายดาย

ลำดับ Priority ของการตั้งค่า

Hermes Agent ใช้ลำดับความสำคัญในการอ่านการตั้งค่า โดยมีลำดับจากสูงสุดไปต่ำสุดดังนี้:

1. CLI arguments (ลำดับสูงสุด)

ค่าที่ระบุผ่าน command line จะ override การตั้งค่าอื่นๆ ทั้งหมด:

2. config.yaml (ลำดับที่ 2)

เป็นไฟล์ config หลักสำหรับ non-secret settings:

temperature: 0.5
max_tokens: 2000

3. .env (ลำดับที่ 3)

เป็น fallback สำหรับ environment variables และ จำเป็นสำหรับ secrets:

NVIDIA_API_KEY=nvidia-xxx

4. Defaults (ลำดับต่ำสุด)

ค่าเริ่มต้นของระบบที่จะใช้เมื่อไม่มีการตั้งค่าจากแหล่งอื่นๆ

เคล็ดลับการตั้งค่า

การจัดการ API keys อย่างปลอดภัย

ห้าม เก็บ API keys ใน config.yaml ต้อง เก็บใน .env เสมอ ใช้ hermes config set API_KEY value เพื่อให้ระบบจัดการให้อัตโนมัติ

การสร้าง SOUL.md ที่ดี

SOUL.md เป็นหัวใจของ agent identity ควรมี: ชื่อและบุคลิก ของ agent วัตถุประสงค์ และเป้าหมาย สไตล์การสื่อสาร ที่ต้องการ ขอบเขต ของความรู้และความสามารถ

การจัดการ Memory

MEMORY.md - เก็บความรู้ทั่วไปและประสบการณ์ USER.md - เก็บข้อมูลเฉพาะของผู้ใช้แต่ละคน ใช้ brain_store() และ brain_recall() สำหรับการจัดการ

สรุป

การตั้งค่า Hermes Agent อย่างถูกต้องจะช่วยให้ AI agent ทำงานได้อย่างมีประสิทธิภาพสูงสุด ด้วยการเข้าใจโครงสร้างไฟล์ คำสั่งจัดการ และลำดับ priority ของการตั้งค่า ผู้ใช้จะสามารถปรับแต่ง Hermes Agent ให้เหมาะกับการใช้งานได้ดีที่สุด คำสั่ง hermes config set เป็นเครื่องมือที่มีประโยชน์มากที่จะช่วยให้การตั้งค่าเป็นไปอย่างถูกต้องและปลอดภัย อ่านต้นฉบับ: https://hermes-agent.nousresearch.com/docs/user-guide/configuration