<!-- Canonical URL: https://ask.atlascloud.ai/th/integrate-hermes-agent-atlascloud -->

# คุณจะรวม Hermes Agent กับ Atlas Cloud ได้อย่างไร

> เชื่อมต่อ Hermes Agent กับ Atlas Cloud โดยเก็บ Atlas Cloud key ไว้ใน ~/.hermes/.env เลือก provider: custom ตั้งค่า base URL เป็น https://api.atlascloud.ai/v1 และเลือก live model ID จาก /v1/models

Hermes Agent สามารถใช้ [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) เป็นผู้ให้บริการ inference ที่เข้ากันได้กับ OpenAI แบบกำหนดเอง การผสานการทำงานต้องใช้สามสิ่ง: คีย์ API ของ Atlas Cloud, base URL `https://api.atlascloud.ai/v1` และ [รหัสโมเดลจากรายการโมเดลของ Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) เมื่อตั้งค่าเหล่านั้นในการกำหนดค่า `model:` ปัจจุบันของ Hermes Agent แล้ว เอเจนต์จะสามารถทำงานผ่าน Atlas Cloud ได้โดยไม่ต้องใช้ SDK เฉพาะของผู้ให้บริการ

> **ประเด็นสำคัญ**
>
> * ติดตั้ง Hermes Agent ด้วยตัวติดตั้งอย่างเป็นทางการ จากนั้นเก็บคีย์ Atlas Cloud ไว้ใน `~/.hermes/.env` แทนที่จะเก็บไว้ในระบบควบคุมเวอร์ชัน
> * กำหนดค่า Hermes Agent ด้วย `provider: custom` และ `base_url: https://api.atlascloud.ai/v1`
> * เรียกดู `/v1/models` ก่อนเลือกโมเดล ชื่อโมเดลเปลี่ยนแปลงเร็วกว่าโค้ดที่ผสานการทำงาน ดังนั้นการตอบสนองแบบเรียลไทม์ปลอดภัยกว่าการคัดลอก ID เก่าจากบทช่วยสอน
> * รัน `hermes doctor` ก่อนเริ่มใช้เอเจนต์ระยะยาว จากนั้นใช้ `hermes` เพื่อทดสอบการสนทนาครั้งแรก
> * API แบบรวมของ Atlas Cloud ทำให้สามารถเปลี่ยนโมเดลภาษาในภายหลังได้โดยไม่ต้องสร้างการผสานการทำงาน Hermes ใหม่

## Hermes Agent และ Atlas Cloud คืออะไร

[Hermes Agent](https://github.com/NousResearch/hermes-agent) เป็นโอเพนซอร์ส เอเจนต์ที่พัฒนาตนเองได้ สร้างโดย Nous Research ประกอบด้วยอินเทอร์เฟซเทอร์มินัล, หน่วยความจำถาวร, ทักษะ, ระบบอัตโนมัติตามกำหนดเวลา, เกตเวย์ข้อความ และรองรับผู้ให้บริการ inference หลายราย เอกสารประกอบ Hermes Agent ปัจจุบันเน้นว่าสามารถเปลี่ยนโมเดลได้โดยไม่ต้องเขียนเอเจนต์ใหม่

[แพลตฟอร์มหลักของ Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) เผยให้เห็นโมเดลภาษา รูปภาพ วิดีโอ และเสียงหลายร้อยรายการผ่าน API แบบรวม สำหรับ Hermes Agent ส่วนสำคัญคือพื้นผิว inference ที่เข้ากันได้กับ OpenAI: Hermes สามารถปฏิบัติต่อ Atlas Cloud ในฐานะผู้ให้บริการแบบกำหนดเองและส่งปริมาณการรับส่งข้อมูล chat-completion ปกติไปยัง API นี้

การจับคู่นี้มีประโยชน์เมื่อคุณต้องการให้ Hermes Agent เป็นอิสระจากผู้จำหน่ายโมเดลรายเดียว การกำหนดค่าเอเจนต์จะคงที่ ในขณะที่โมเดล Atlas Cloud ที่เลือกสามารถเปลี่ยนแปลงได้ตามความต้องการ ราคา หรือความพร้อมใช้งาน

## ก่อนเริ่มต้น

คุณต้องมี:

1. สภาพแวดล้อม Linux, macOS, WSL2 หรือ Windows ที่รองรับ
2. การติดตั้ง Hermes Agent ที่ทำงานได้
3. บัญชี Atlas Cloud และคีย์ API
4. ยอดคงเหลือ Atlas Cloud เพียงพอหรือสิทธิ์การเข้าถึงบัญชีสำหรับโมเดลที่คุณเลือก

อย่าวางคีย์ API จริงลงในที่เก็บสาธารณะ, issue, ภาพหน้าจอ หรือไฟล์กำหนดค่าที่ใช้ร่วมกัน Hermes Agent รองรับไฟล์ `.env` ในเครื่องโดยเฉพาะเพื่อให้ความลับแยกจากการกำหนดค่าทั่วไป

## ขั้นตอนที่ 1: ติดตั้ง Hermes Agent

บน Linux, macOS หรือ WSL2 ให้ใช้ตัวติดตั้งที่เผยแพร่โดย Nous Research:

```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

โหลดเชลล์ใหม่หลังจากติดตั้ง:

```bash
source ~/.zshrc
```

หากคุณใช้ Bash ให้โหลด `~/.bashrc` แทน จากนั้นยืนยันว่า CLI พร้อมใช้งาน:

```bash
hermes --help
```

โปรเจ็กต์อย่างเป็นทางการยังรองรับ Windows ดั้งเดิมผ่านตัวติดตั้ง PowerShell ให้ทำตาม[เอกสารประกอบการติดตั้ง Hermes Agent](https://hermes-agent.nousresearch.com/docs/) ปัจจุบัน แทนที่จะแปลคำสั่ง Unix เป็น PowerShell ด้วยตัวเอง

## ขั้นตอนที่ 2: สร้างคีย์ API Atlas Cloud

ลงชื่อเข้าใช้คอนโซล Atlas Cloud และสร้างคีย์ API สำหรับการปรับใช้ Hermes Agent นี้ ใช้คีย์เฉพาะเมื่อบัญชีของคุณอนุญาต การแยกการรับส่งข้อมูลของเอเจนต์ทำให้การหมุนเวียนและการตรวจสอบการใช้งานในภายหลังทำได้ง่ายขึ้น

เก็บคีย์ไว้ในไฟล์สภาพแวดล้อมเฉพาะของ Hermes Agent:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'replace-with-your-atlas-cloud-key' >> ~/.hermes/.env
```

แทนที่ placeholder ในเครื่อง อย่าใส่คีย์จริงใน `config.yaml` หากไฟล์นั้นจะถูกสำรองข้อมูล ซิงค์ หรือคอมมิต

ทำไมต้องใช้ `OPENAI_API_KEY`? เส้นทางผู้ให้บริการแบบกำหนดเองของ Hermes Agent ปัจจุบันจะแก้ไขตัวแปรสภาพแวดล้อมนั้นเมื่อมีการกำหนดค่า base URL ที่เข้ากันได้กับ OpenAI อย่างชัดเจน Atlas Cloud ใช้การรับรองความถูกต้องแบบ bearer-token บนอินเทอร์เฟซที่เข้ากันได้นั้น

## ขั้นตอนที่ 3: รับรหัสโมเดล Atlas Cloud แบบเรียลไทม์

อย่าเดารหัสโมเดล ตรวจสอบ[รายการโมเดล Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) จากนั้นสอบถาม API เพื่อรับแคตตาล็อกปัจจุบัน:

```bash
export ATLASCLOUD_API_KEY='replace-with-your-atlas-cloud-key'

curl https://api.atlascloud.ai/v1/models \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
```

เลือกโมเดลข้อความที่รองรับพฤติกรรมที่การปรับใช้ Hermes ของคุณต้องการ โดยเฉพาะการใช้เครื่องมือ การให้เหตุผล ความยาวบริบท และเวลาแฝงที่คาดหวัง คัดลอก `id` ที่แน่นอนที่ API ส่งคืน

สำหรับเอเจนต์ถาวร ให้เริ่มต้นด้วยโมเดลที่ใช้เครื่องมือทั่วไปที่สามารถทำงานได้ดี แทนที่จะปรับให้เหมาะสมกับราคาโทเค็นที่ถูกที่สุดเท่านั้น หลังจากที่การผสานการทำงานใช้งานได้ คุณสามารถทดสอบโมเดลราคาถูกลงสำหรับงานสรุปหรืองานประจำอื่นๆ

## ขั้นตอนที่ 4: ชี้ Hermes Agent ไปยัง Atlas Cloud

เปิด `~/.hermes/config.yaml` และกำหนดค่าส่วน `model:` ระดับบนสุดปัจจุบัน:

```yaml
model:
  default: "replace-with-a-live-atlas-cloud-model-id"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

เก็บคีย์ไว้ใน `~/.hermes/.env` ไฟล์ YAML ต้องการเฉพาะผู้ให้บริการ, endpoint และรหัสโมเดล

รายละเอียดนี้สำคัญเพราะตัวอย่าง Hermes Agent รุ่นเก่าอาจใช้บล็อก `inference:` ตัวอย่างการกำหนดค่าอย่างเป็นทางการปัจจุบันใช้ `model:` หากเวอร์ชันที่ติดตั้งของคุณทำงานแตกต่าง ให้รัน `hermes update` และตรวจสอบเอกสารประกอบการกำหนดค่าที่มาพร้อมกับเวอร์ชันนั้นก่อนเปลี่ยนการตั้งค่าอื่นๆ

## ขั้นตอนที่ 5: วินิจฉัยการกำหนดค่า

รันการตรวจสอบในตัวของ Hermes Agent:

```bash
hermes doctor
```

จากนั้นเริ่มเอเจนต์:

```bash
hermes
```

ส่งคำขอทดสอบขนาดเล็กที่ไม่ต้องใช้เครื่องมือภายนอก เช่น:

```text
Reply with the model name you are using, then summarize what tools are available in this Hermes session.
```

การตอบกลับแบบสตรีมปกติยืนยันว่า Hermes สามารถตรวจสอบสิทธิ์ เข้าถึง endpoint Atlas Cloud และเรียกใช้โมเดลที่กำหนดค่าไว้ได้

## ปัญหาการผสานการทำงานทั่วไป

### ข้อผิดพลาดการตรวจสอบสิทธิ์

ตรวจสอบว่า `OPENAI_API_KEY` มีอยู่ใน `~/.hermes/.env`, มีคีย์ Atlas Cloud โดยไม่มีเครื่องหมายคำพูดหรือช่องว่างเพิ่มเติม และถูกโหลดโดยการติดตั้ง Hermes เดียวกับที่คุณกำลังรันอยู่ หมุนเวียนคีย์หากถูกเปิดเผย

### ข้อผิดพลาดโมเดลไม่รู้จัก

เรียก `https://api.atlascloud.ai/v1/models` อีกครั้งและคัดลอก ID ที่แน่นอนแบบเรียลไทม์ อย่าลบคำนำหน้าผู้ให้บริการหรือทำให้ตัวระบุสั้นลง เว้นแต่การตอบสนองของ API จะใช้รูปแบบที่สั้นกว่านั้นเอง

### Hermes เรียกผู้ให้บริการผิด

ยืนยันว่าการกำหนดค่าที่ใช้งานอยู่มีทั้งสองอย่าง:

```yaml
provider: "custom"
base_url: "https://api.atlascloud.ai/v1"
```

การเลือกผู้ให้บริการในตัวอาจส่งเส้นทางคำขอไปยัง endpoint ของผู้ให้บริการนั้นแทน Atlas Cloud

### การกำหนดค่าตรงกับบทช่วยสอนเก่าแต่ล้มเหลว

Hermes Agent กำลังพัฒนาอย่างรวดเร็ว เปรียบเทียบไฟล์ของคุณกับ[เอกสารอ้างอิงการกำหนดค่าอย่างเป็นทางการ](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) ปัจจุบัน และใช้ `hermes config get` เพื่อตรวจสอบโปรไฟล์ที่ใช้งานอยู่ โดยเฉพาะอย่างยิ่ง ตรวจสอบว่าเวอร์ชันของคุณคาดหวังโครงสร้าง `model:` ปัจจุบันหรือไม่

## วิธีเปลี่ยนโมเดลโดยไม่ต้องสร้างการผสานการทำงานใหม่

เมื่อกำหนดค่า Atlas Cloud เป็นผู้ให้บริการแบบกำหนดเองแล้ว การเปลี่ยนโมเดลต้องใช้ ID ใหม่จาก[แคตตาล็อกโมเดลแบบเรียลไทม์](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) เท่านั้น:

1. สอบถาม `/v1/models`
2. อัปเดต `model.default` ใน `~/.hermes/config.yaml`
3. รัน `hermes doctor`
4. เริ่มการสนทนาทดสอบใหม่

endpoint และการจัดการข้อมูลรับรองยังคงเหมือนเดิม นี่คือคุณค่าในทางปฏิบัติของ API แบบรวมสำหรับเอเจนต์: การประเมินโมเดลกลายเป็นการเปลี่ยนแปลงการกำหนดค่าแทนที่จะเป็นการผสานการทำงาน SDK ใหม่

## เมื่อการตั้งค่านี้เหมาะสม

การผสานการทำงาน Atlas Cloud เหมาะสมอย่างยิ่งเมื่อ:

* คุณต้องการให้ Hermes Agent เข้าถึงตระกูลโมเดลหลายตระกูลผ่านบัญชีเดียว
* คุณคาดว่าจะเปรียบเทียบหรือเปลี่ยนโมเดลหลักเมื่อเวลาผ่านไป
* คุณต้องการ endpoint ที่เข้ากันได้กับ OpenAI แทนโค้ดไคลเอ็นต์เฉพาะผู้ให้บริการ
* ทักษะ Hermes ในอนาคตของคุณอาจต้องเข้าถึงโมเดลรูปภาพหรือวิดีโอจากแพลตฟอร์มเดียวกัน

การผสานการทำงานโดยตรงกับผู้ให้บริการโมเดลอาจง่ายกว่าหากเอเจนต์จะใช้ผู้ให้บริการรายเดียวถาวรและคุณไม่ต้องการแคตตาล็อกโมเดลที่กว้างขึ้นของ Atlas Cloud ตัวเลือกที่ถูกต้องขึ้นอยู่กับว่าความยืดหยุ่นและการเข้าถึงแบบรวมศูนย์มีความสำคัญมากกว่าการตั้งค่าผู้ให้บริการรายเดียวที่สั้นที่สุดเท่าที่จะเป็นไปได้หรือไม่

## รายการตรวจสอบครั้งสุดท้าย

ก่อนปล่อยให้ Hermes Agent ทำงานโดยไม่มีผู้ดูแล ให้ตรวจสอบทั้งห้ารายการ:

- คีย์ Atlas Cloud ถูกจัดเก็บไว้ภายนอกระบบควบคุมเวอร์ชัน
- `provider` ถูกตั้งค่าเป็น `custom`
- `base_url` เป็น `https://api.atlascloud.ai/v1` ทุกประการ
- `model.default` ตรงกับ ID จาก endpoint โมเดลแบบเรียลไทม์
- `hermes doctor` และการสนทนาง่ายๆ ทั้งสองสำเร็จ

เมื่อการตรวจสอบเหล่านั้นเสร็จสมบูรณ์ Hermes Agent ก็ถูกรวมเข้ากับ Atlas Cloud แล้ว ตอนนี้คุณสามารถประเมินโมเดลภาษาต่างๆ ภายใต้เอเจนต์เดียวกันได้โดยไม่ต้องเปลี่ยนเครื่องมือ หน่วยความจำ ทักษะ หรืออินเทอร์เฟซผู้ใช้

## FAQ

### Hermes Agent มีผู้ให้บริการ Atlas Cloud ในตัวหรือไม่?

ไม่จำเป็นต้องมีผู้ให้บริการ Atlas Cloud เฉพาะ Hermes Agent สามารถเชื่อมต่อผ่านผู้ให้บริการแบบกำหนดเองที่รองรับ OpenAI โดยใช้ URL ฐานและคีย์ API ของ Atlas Cloud

### base URL ของ Atlas Cloud สำหรับ Hermes Agent คืออะไร?

ใช้ https://api.atlascloud.ai/v1 เป็น base URL ที่เข้ากันได้กับ OpenAI

### ฉันควรเก็บคีย์ API ของ Atlas Cloud ไว้ที่ไหน?

เก็บไว้ใน ~/.hermes/.env ในชื่อ OPENAI_API_KEY และอย่าเก็บคีย์จริงไว้ในไฟล์กำหนดค่า ภาพหน้าจอ หรือระบบควบคุมเวอร์ชัน

### Hermes Agent ควรใช้โมเดล Atlas Cloud รุ่นใด

สอบถาม https://api.atlascloud.ai/v1/models และเลือกโมเดลข้อความปัจจุบันที่ตรงตามความต้องการด้านการใช้เครื่องมือ การใช้เหตุผล บริบท ความหน่วง และต้นทุน

### ฉันจะตรวจสอบการผสานรวมได้อย่างไร

รัน hermes doctor, เริ่ม Hermes ด้วยคำสั่ง hermes, และส่ง prompt ทดสอบเล็กๆ ข้อผิดพลาดเกี่ยวกับการตรวจสอบสิทธิ์หรือโมเดลที่ไม่รู้จักมักเกี่ยวข้องกับคีย์ API, URL ฐาน, หรือรหัสโมเดล