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

# Bagaimana cara mengintegrasikan Hermes Agent dengan Atlas Cloud?

> Hubungkan Hermes Agent ke Atlas Cloud dengan menyimpan kunci Atlas Cloud di ~/.hermes/.env, memilih penyedia: kustom, mengatur URL dasar ke https://api.atlascloud.ai/v1, dan memilih ID model langsung dari /v1/models.

Hermes Agent dapat menggunakan [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) sebagai penyedia inferensi kustom yang kompatibel dengan OpenAI. Integrasi ini membutuhkan tiga hal: kunci API Atlas Cloud, URL dasar `https://api.atlascloud.ai/v1`, dan [ID model dari daftar model Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Setelah ketiganya berada di konfigurasi `model:` Hermes Agent saat ini, agen dapat berjalan melalui Atlas Cloud tanpa SDK khusus penyedia.

> **Poin-poin penting**
>
> * Instal Hermes Agent dengan penginstal resmi, lalu simpan kunci Atlas Cloud di `~/.hermes/.env` dan bukan di kontrol sumber.
> * Konfigurasikan Hermes Agent dengan `provider: custom` dan `base_url: https://api.atlascloud.ai/v1`.
> * Kueri `/v1/models` sebelum memilih model. Nama model berubah lebih cepat daripada kode integrasi, jadi respons langsung lebih aman daripada menyalin ID lama dari tutorial.
> * Jalankan `hermes doctor` sebelum memulai agen jangka panjang, lalu gunakan `hermes` untuk menguji percakapan pertama.
> * API terpadu Atlas Cloud memungkinkan perubahan model bahasa nanti tanpa membangun ulang integrasi Hermes.

## Apa itu Hermes Agent dan Atlas Cloud?

[Hermes Agent](https://github.com/NousResearch/hermes-agent) adalah agen sumber terbuka yang dapat meningkatkan diri sendiri yang dibuat oleh Nous Research. Ini mencakup antarmuka terminal, memori persisten, keterampilan, otomatisasi terjadwal, gateway pesan, dan dukungan untuk beberapa penyedia inferensi. Dokumentasi Hermes Agent saat ini menekankan bahwa model dapat diubah tanpa menulis ulang agen.

[Platform utama Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) mengekspos ratusan model bahasa, gambar, video, dan audio melalui API terpadu. Untuk Hermes Agent, bagian penting adalah permukaan inferensi yang kompatibel dengan OpenAI: Hermes dapat memperlakukan Atlas Cloud sebagai penyedia kustom dan mengirimkan lalu lintas penyelesaian obrolan normal ke sana.

Pemasangan ini berguna ketika Anda ingin Hermes Agent tetap independen dari satu vendor model. Konfigurasi agen tetap stabil, sementara model Atlas Cloud yang dipilih dapat berubah seiring perubahan persyaratan, harga, atau ketersediaan.

## Sebelum memulai

Anda memerlukan:

1. Lingkungan Linux, macOS, WSL2, atau Windows yang didukung.
2. Instalasi Hermes Agent yang berfungsi.
3. Akun Atlas Cloud dan kunci API.
4. Saldo Atlas Cloud yang cukup atau akses akun untuk model yang Anda pilih.

Jangan menempelkan kunci API asli ke repositori publik, isu, tangkapan layar, atau file konfigurasi bersama. Hermes Agent mendukung file `.env` lokal khusus agar rahasia dapat tetap terpisah dari konfigurasi biasa.

## Langkah 1: Instal Hermes Agent

Di Linux, macOS, atau WSL2, gunakan penginstal yang diterbitkan oleh Nous Research:

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

Muat ulang shel Anda setelah instalasi:

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

Jika Anda menggunakan Bash, muat ulang `~/.bashrc` sebagai gantinya. Kemudian pastikan bahwa CLI tersedia:

```bash
hermes --help
```

Proyek resmi juga mendukung Windows asli melalui penginstal PowerShell. Ikuti [dokumentasi instalasi Hermes Agent](https://hermes-agent.nousresearch.com/docs/) saat ini daripada menerjemahkan perintah Unix ke PowerShell sendiri.

## Langkah 2: Buat kunci API Atlas Cloud

Masuk ke konsol Atlas Cloud dan buat kunci API untuk penyebaran Hermes Agent ini. Gunakan kunci khusus jika kontrol akun Anda memungkinkan; memisahkan lalu lintas agen memudahkan rotasi dan tinjauan penggunaan nantinya.

Simpan kunci di file lingkungan lokal Hermes Agent:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'ganti-dengan-kunci-atlas-cloud-anda' >> ~/.hermes/.env
```

Gantikan tempat dudukan secara lokal. Jangan sertakan kunci asli di `config.yaml` jika file itu akan dicadangkan, disinkronisasikan, atau dikomit.

Mengapa menggunakan `OPENAI_API_KEY`? Jalur penyedia kustom Hermes Agent saat ini menyelesaikan variabel lingkungan itu ketika URL dasar yang kompatibel dengan OpenAI dikonfigurasikan. Atlas Cloud menggunakan autentikasi bearer-token pada antarmuka yang kompatibel tersebut.

## Langkah 3: Dapatkan ID model Atlas Cloud langsung

Jangan menebak ID model. Periksa [daftar model Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), lalu tanyakan API untuk katalog saat ini:

```bash
export ATLASCLOUD_API_KEY='ganti-dengan-kunci-atlas-cloud-anda'

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

Pilih model teks yang mendukung perilaku yang dibutuhkan penyebaran Hermes Anda, terutama penggunaan alat, penalaran, panjang konteks, dan latensi yang diharapkan. Salin `id` persis yang dikembalikan oleh API.

Untuk agen persisten, mulailah dengan model serba guna yang mampu menggunakan alat daripada hanya mengoptimalkan harga token termurah. Setelah integrasi berfungsi, Anda dapat menguji model berbiaya lebih rendah untuk perangkuman atau tugas rutin lainnya.

## Langkah 4: Arahkan Hermes Agent ke Atlas Cloud

Buka `~/.hermes/config.yaml` dan konfigurasikan bagian `model:` tingkat atas saat ini:

```yaml
model:
  default: "ganti-dengan-id-model-atlas-cloud-langsung"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

Simpan kunci di `~/.hermes/.env`; file YAML hanya membutuhkan penyedia, titik akhir, dan ID model.

Detil ini penting karena contoh Hermes Agent yang lebih lama mungkin menggunakan blok `inference:`. Contoh konfigurasi resmi saat ini menggunakan `model:`. Jika versi terinstal Anda berperilaku berbeda, jalankan `hermes update` dan periksa dokumentasi konfigurasi yang disertakan dengan versi tersebut sebelum mengubah lebih banyak pengaturan.

## Langkah 5: Diagnosa konfigurasi

Jalankan pemeriksaan bawaan Hermes Agent:

```bash
hermes doctor
```

Kemudian mulai agen:

```bash
hermes
```

Kirim permintaan uji kecil yang tidak memerlukan alat eksternal, seperti:

```text
Balas dengan nama model yang Anda gunakan, lalu rangkum alat apa saja yang tersedia di sesi Hermes ini.
```

Respons streaming normal menegaskan bahwa Hermes dapat mengautentikasi, mencapai titik akhir Atlas Cloud, dan memanggil model yang dikonfigurasi.

## Masalah integrasi umum

### Kesalahan autentikasi

Periksa bahwa `OPENAI_API_KEY` ada di `~/.hermes/.env`, berisi kunci Atlas Cloud tanpa tanda kutip atau spasi tambahan, dan sedang dimuat oleh instalasi Hermes yang sama yang Anda jalankan. Putar kunci jika telah terekspos.

### Kesalahan model tidak dikenal

Panggil `https://api.atlascloud.ai/v1/models` lagi dan salin ID langsung yang tepat. Jangan hapus awalan penyedia atau persingkat pengenal kecuali respons API itu sendiri menggunakan bentuk yang lebih pendek.

### Hermes memanggil penyedia yang salah

Pastikan konfigurasi aktif berisi keduanya:

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

Memilih penyedia bawaan dapat mengarahkan permintaan ke titik akhir penyedia itu sendiri alih-alih Atlas Cloud.

### Konfigurasi cocok dengan tutorial lama tetapi gagal

Hermes Agent berkembang pesat. Bandingkan file Anda dengan [referensi konfigurasi resmi](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) saat ini dan gunakan `hermes config get` untuk memeriksa profil aktif. Secara khusus, verifikasi apakah versi Anda mengharapkan struktur `model:` saat ini.

## Cara mengubah model tanpa membangun ulang integrasi

Setelah Atlas Cloud dikonfigurasi sebagai penyedia kustom, mengganti model hanya memerlukan ID baru dari [katalog model langsung](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new):

1. Kueri `/v1/models`.
2. Perbarui `model.default` di `~/.hermes/config.yaml`.
3. Jalankan `hermes doctor`.
4. Mulai percakapan uji baru.

Titik akhir dan penanganan kredensial tetap sama. Ini adalah nilai praktis dari API terpadu untuk agen: evaluasi model menjadi perubahan konfigurasi alih-alih integrasi SDK baru.

## Kapan pengaturan ini cocok

Integrasi Atlas Cloud sangat cocok ketika:

* Anda ingin Hermes Agent mengakses beberapa keluarga model melalui satu akun.
* Anda berencana untuk melakukan benchmark atau mengganti model utama dari waktu ke waktu.
* Anda menginginkan titik akhir yang kompatibel dengan OpenAI daripada kode klien khusus penyedia.
* Keterampilan Hermes masa depan Anda mungkin memerlukan akses ke model gambar atau video dari platform yang sama.

Integrasi penyedia model langsung mungkin lebih sederhana jika agen akan secara permanen menggunakan satu penyedia dan Anda tidak memerlukan katalog model Atlas Cloud yang lebih luas. Pilihan yang tepat tergantung pada apakah fleksibilitas dan akses terpusat lebih penting daripada memiliki pengaturan penyedia tunggal yang paling pendek.

## Daftar periksa akhir

Sebelum meninggalkan Hermes Agent berjalan tanp pengawasan, verifikasi semua lima itm:

- Kunci Atlas Cloud disimpan di luar krontol vesi.
- `provider` diset ke `custom`.
- `base_url` tepat `https://api.atlascloud.ai/v1`.
- `model.default` cocok dengan ID dari titik akhir model langsung.
- `hermes doctor` dan perckapan sederhana berhasil.

Dengan periksa itu selesai, Hermes Agent terintegrasi dengan Atlas Cloud. Anda sekarang dapat mengevaluasi model bahasa yang berbeda di belakang agen yang sama tanpa mengubah alat, memori, keterampilan, atau antarmuka penggunanya.

## FAQ

### Apakah Hermes Agent memiliki penyedia Atlas Cloud bawaan?

Penyedia Atlas Cloud khusus tidak diperlukan. Hermes Agent dapat terhubung melalui penyedia kustom yang kompatibel dengan OpenAI menggunakan URL dasar dan kunci API Atlas Cloud.

### Apa URL dasar Atlas Cloud untuk Hermes Agent?

Gunakan https://api.atlascloud.ai/v1 sebagai URL dasar yang kompatibel dengan OpenAI.

### Di mana sebaiknya saya menyimpan kunci API Atlas Cloud?

Simpan di ~/.hermes/.env sebagai OPENAI_API_KEY dan jangan masukkan kunci asli ke dalam file konfigurasi, tangkapan layar, dan kontrol versi.

### Model Atlas Cloud mana yang harus digunakan oleh Hermes Agent?

Kueri https://api.atlascloud.ai/v1/models dan pilih model teks terkini yang memenuhi persyaratan penggunaan alat, penalaran, konteks, latensi, dan biaya Anda.

### Bagaimana cara memverifikasi integrasi?

Jalankan hermes doctor, mulai Hermes dengan perintah hermes, dan kirimkan prompt uji kecil. Kesalahan autentikasi atau model tidak dikenal biasanya mengarah pada kunci API, URL dasar, atau ID model.