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

# Hermes Agent'i Atlas Cloud ile nasıl entegre edersiniz?

> Hermes Agent'i Atlas Cloud'a bağlamak için, Atlas Cloud anahtarını ~/.hermes/.env dosyasına kaydedin, sağlayıcı olarak "custom" seçin, temel URL'yi https://api.atlascloud.ai/v1 olarak ayarlayın ve /v1/models listesinden canlı bir model ID'si seçin.

Hermes Agent, [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) özel bir OpenAI uyumlu çıkarım sağlayıcısı olarak kullanabilir. Entegrasyon için üç şey gerekir: bir Atlas Cloud API anahtarı, `https://api.atlascloud.ai/v1` temel URL'si ve [Atlas Cloud'un model listesinden bir model kimliği](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Bunlar Hermes Agent'ın mevcut `model:` yapılandırmasına eklendiğinde, ajan herhangi bir sağlayıcıya özel SDK olmadan Atlas Cloud üzerinden çalışabilir.

> **Önemli çıkarımlar**
>
> * Hermes Agent'ı resmi yükleyici ile kurun, ardından Atlas Cloud anahtarını kaynak kontrolünde değil, `~/.hermes/.env` dosyasında saklayın.
> * Hermes Agent'ı `provider: custom` ve `base_url: https://api.atlascloud.ai/v1` ile yapılandırın.
> * Bir model seçmeden önce `/v1/models` sorgulayın. Model adları entegrasyon kodundan daha hızlı değişir, bu nedenle canlı yanıt, bir eğitimden eski bir kimliği kopyalamaktan daha güvenlidir.
> * Uzun süreli bir ajan başlatmadan önce `hermes doctor` çalıştırın, ardından ilk konuşmayı test etmek için `hermes` kullanın.
> * Atlas Cloud'un birleşik API'si, daha sonra Hermes entegrasyonunu yeniden oluşturmadan dil modelini değiştirmeyi mümkün kılar.

## Hermes Agent ve Atlas Cloud nedir?

[Hermes Agent](https://github.com/NousResearch/hermes-agent), Nous Research tarafından oluşturulmuş, açık kaynaklı, kendini geliştiren bir ajandır. Bir terminal arayüzü, kalıcı bellek, beceriler, zamanlanmış otomasyonlar, mesajlaşma ağ geçitleri ve birden çok çıkarım sağlayıcısı için destek içerir. Mevcut Hermes Agent belgeleri, modellerin ajanı yeniden yazmadan değiştirilebileceğini vurgular.

[Atlas Cloud'un ana platformu](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud), yüzlerce dil, görüntü, video ve ses modelini birleşik bir API aracılığıyla sunar. Hermes Agent için önemli olan kısım, OpenAI uyumlu çıkarım yüzeyidir: Hermes, Atlas Cloud'u özel bir sağlayıcı olarak ele alabilir ve normal sohbet tamamlama trafiğini ona gönderebilir.

Bu eşleştirme, Hermes Agent'ın tek bir model satıcısından bağımsız kalmasını istediğinizde kullanışlıdır. Ajan yapılandırması sabit kalırken, seçilen Atlas Cloud modeli gereksinimlere, fiyatlandırmaya veya kullanılabilirliğe bağlı olarak değişebilir.

## Başlamadan önce

İhtiyacınız olanlar:

1. Bir Linux, macOS, WSL2 veya desteklenen bir Windows ortamı.
2. Çalışan bir Hermes Agent kurulumu.
3. Bir Atlas Cloud hesabı ve API anahtarı.
4. Seçtiğiniz model için yeterli Atlas Cloud bakiyesi veya hesap erişimi.

Gerçek bir API anahtarını herkese açık bir depoya, soruna, ekran görüntüsüne veya paylaşılan yapılandırma dosyasına yapıştırmayın. Hermes Agent, özellikle sırların normal yapılandırmadan ayrı kalabilmesi için yerel bir `.env` dosyasını destekler.

## Adım 1: Hermes Agent'ı Kurun

Linux, macOS veya WSL2'de, Nous Research tarafından yayınlanan yükleyiciyi kullanın:

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

Kurulumdan sonra kabuğunuzu yeniden yükleyin:

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

Bash kullanıyorsanız, bunun yerine `~/.bashrc` dosyasını yeniden yükleyin. Ardından CLI'nin kullanılabilir olduğunu onaylayın:

```bash
hermes --help
```

Resmi proje ayrıca PowerShell yükleyicisi aracılığıyla yerel Windows'u da destekler. Unix komutunu kendiniz PowerShell'e çevirmek yerine mevcut [Hermes Agent kurulum belgelerini](https://hermes-agent.nousresearch.com/docs/) izleyin.

## Adım 2: Bir Atlas Cloud API Anahtarı Oluşturun

Atlas Cloud konsolunda oturum açın ve bu Hermes Agent dağıtımı için bir API anahtarı oluşturun. Hesap kontrolleriniz izin verdiğinde özel bir anahtar kullanın; ajan trafiğini ayırmak, daha sonraki döndürme ve kullanım incelemesini kolaylaştırır.

Anahtarı Hermes Agent'ın yerel ortam dosyasında saklayın:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'sizin-atlas-cloud-anahtariniz-ile-degistirin' >> ~/.hermes/.env
```

Yer tutucuyu yerel olarak değiştirin. `config.yaml` dosyası yedeklenecek, senkronize edilecek veya taahhüt edilecekse, gerçek anahtarı bu dosyaya eklemeyin.

Neden `OPENAI_API_KEY` kullanılır? Hermes Agent'ın mevcut özel sağlayıcı yolu, açık bir OpenAI uyumlu temel URL yapılandırıldığında bu ortam değişkenini çözer. Atlas Cloud, bu uyumlu arayüzde taşıyıcı belirteç kimlik doğrulaması kullanır.

## Adım 3: Canlı Bir Atlas Cloud Model Kimliği Alın

Model kimliğini tahmin etmeyin. [Atlas Cloud model listesini](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) kontrol edin, ardından mevcut kataloğu almak için API'ye sorun:

```bash
export ATLASCLOUD_API_KEY='sizin-atlas-cloud-anahtariniz-ile-degistirin'

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

Hermes dağıtımınızın ihtiyaç duyduğu davranışı, özellikle araç kullanımı, muhakeme, bağlam uzunluğu ve beklenen gecikmeyi destekleyen bir metin modeli seçin. API tarafından döndürülen tam `id` değerini kopyalayın.

Kalıcı bir ajan için, yalnızca en ucuz token fiyatını optimize etmek yerine genel amaçlı, araç kullanabilen bir modelle başlayın. Entegrasyon çalıştıktan sonra, özetleme veya diğer rutin görevler için daha düşük maliyetli modelleri test edebilirsiniz.

## Adım 4: Hermes Agent'ı Atlas Cloud'a Yönlendirin

`~/.hermes/config.yaml` dosyasını açın ve geçerli üst düzey `model:` bölümünü yapılandırın:

```yaml
model:
  default: "canli-bir-atlas-cloud-model-kimligi-ile-degistirin"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

Anahtarı `~/.hermes/.env` dosyasında tutun; YAML dosyasının yalnızca sağlayıcıya, uç noktaya ve model kimliğine ihtiyacı vardır.

Bu ayrıntı önemlidir çünkü eski Hermes Agent örnekleri bir `inference:` bloğu kullanabilir. Mevcut resmi yapılandırma örneği `model:` kullanır. Yüklü sürümünüz farklı davranıyorsa, daha fazla ayar değiştirmeden önce `hermes update` çalıştırın ve bu sürümle birlikte gelen yapılandırma belgelerini kontrol edin.

## Adım 5: Yapılandırmayı Teşhis Edin

Hermes Agent'ın yerleşik kontrollerini çalıştırın:

```bash
hermes doctor
```

Ardından ajanı başlatın:

```bash
hermes
```

Harici araçlar gerektirmeyen küçük bir test isteği gönderin, örneğin:

```text
Kullandığınız model adını yanıtlayın, ardından bu Hermes oturumunda hangi araçların mevcut olduğunu özetleyin.
```

Normal bir akışlı yanıt, Hermes'in kimlik doğrulaması yapabildiğini, Atlas Cloud uç noktasına ulaşabildiğini ve yapılandırılan modeli çağırabildiğini onaylar.

## Yaygın Entegrasyon Sorunları

### Kimlik doğrulama hataları

`OPENAI_API_KEY`'in `~/.hermes/.env` dosyasında bulunduğunu, Atlas Cloud anahtarını fazladan tırnak veya boşluk olmadan içerdiğini ve çalıştırdığınız Hermes kurulumu tarafından yüklendiğini kontrol edin. Anahtar ifşa edilmişse döndürün.

### Bilinmeyen model hataları

`https://api.atlascloud.ai/v1/models` adresini tekrar çağırın ve tam canlı kimliği kopyalayın. API yanıtı kısa formu kullanmadığı sürece bir sağlayıcı önekini kaldırmayın veya tanımlayıcıyı kısaltmayın.

### Hermes yanlış sağlayıcıyı çağırıyor

Aktif yapılandırmanın her ikisini de içerdiğini onaylayın:

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

Yerleşik bir sağlayıcı seçmek, isteği Atlas Cloud yerine o sağlayıcının kendi uç noktasına yönlendirebilir.

### Yapılandırma eski bir eğitimle eşleşiyor ancak başarısız oluyor

Hermes Agent hızla gelişiyor. Dosyanızı mevcut [resmi yapılandırma referansı](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) ile karşılaştırın ve aktif profili incelemek için `hermes config get` kullanın. Özellikle, sürümünüzün mevcut `model:` yapısını bekleyip beklemediğini doğrulayın.

## Entegrasyonu Yeniden Oluşturmadan Modeller Nasıl Değiştirilir

Atlas Cloud özel sağlayıcı olarak yapılandırıldıktan sonra, modelleri değiştirmek yalnızca [canlı model kataloğundan](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) yeni bir kimlik gerektirir:

1. `/v1/models` sorgulayın.
2. `model.default` değerini `~/.hermes/config.yaml` içinde güncelleyin.
3. `hermes doctor` çalıştırın.
4. Yeni bir test konuşması başlatın.

Uç nokta ve kimlik bilgisi işleme aynı kalır. Bir ajan için birleşik bir API'nin pratik değeri budur: model değerlendirmesi, yeni bir SDK entegrasyonu yerine bir yapılandırma değişikliği haline gelir.

## Bu Kurulum Ne Zaman Uygundur

Atlas Cloud entegrasyonu şu durumlarda güçlü bir uyumdur:

* Hermes Agent'ın tek bir hesap üzerinden birden çok model ailesine erişmesini istiyorsanız.
* Ana modeli zamanla karşılaştırmayı veya değiştirmeyi bekliyorsanız.
* Sağlayıcıya özel istemci kodu yerine OpenAI uyumlu bir uç nokta istiyorsanız.
* Gelecekteki Hermes becerilerinizin aynı platformdan görüntü veya video modellerine erişmesi gerekebilir.

Ajan kalıcı olarak tek bir sağlayıcı kullanacaksa ve Atlas Cloud'un daha geniş model kataloğuna ihtiyacınız yoksa, doğrudan bir model sağlayıcı entegrasyonu daha basit olabilir. Doğru seçim, esneklik ve merkezi erişimin, mümkün olan en kısa tek sağlayıcılı kurulumdan daha önemli olup olmadığına bağlıdır.

## Son Kontrol Listesi

Hermes Agent'ı gözetimsiz bırakmadan önce beş maddenin tümünü doğrulayın:

- Atlas Cloud anahtarı sürüm kontrolü dışında saklanır.
- `provider` `custom` olarak ayarlanmıştır.
- `base_url` tam olarak `https://api.atlascloud.ai/v1` şeklindedir.
- `model.default`, canlı modeller uç noktasından bir kimlikle eşleşir.
- `hermes doctor` ve basit bir konuşma başarılı olur.

Bu kontroller tamamlandığında, Hermes Agent Atlas Cloud ile entegre olur. Artık aynı ajanın arkasında, araçlarını, belleğini, becerilerini veya kullanıcı arayüzünü değiştirmeden farklı dil modellerini değerlendirebilirsiniz.

## FAQ

### Hermes Agent'in yerleşik bir Atlas Cloud sağlayıcısı var mı?

Özel bir Atlas Cloud sağlayıcısı gerekmez. Hermes Agent, kendi özel OpenAI uyumlu sağlayıcısı aracılığıyla Atlas Cloud temel URL'sini ve API anahtarını kullanarak bağlanabilir.

### Hermes Agent için Atlas Cloud temel URL'si nedir?

OpenAI uyumlu temel URL olarak https://api.atlascloud.ai/v1 kullanın.

### Atlas Cloud API anahtarını nerede saklamalıyım?

Bunu ~/.hermes/.env dosyasına OPENAI_API_KEY olarak kaydedin ve gerçek anahtarı yapılandırma dosyalarından, ekran görüntülerinden ve sürüm kontrolünden uzak tutun.

### Hermes Agent hangi Atlas Cloud modelini kullanmalı?

https://api.atlascloud.ai/v1/models adresini sorgulayın ve araç kullanımı, muhakeme, bağlam, gecikme ve maliyet gereksinimlerinizi karşılayan güncel bir metin modeli seçin.

### Entegrasyonu nasıl doğrulayabilirim?

hermes doctor komutunu çalıştır, Hermes'i hermes komutuyla başlat ve küçük bir test istemi gönder. Kimlik doğrulama veya bilinmeyen model hataları genellikle API anahtarı, temel URL veya model kimliği ile ilgilidir.