Hermes Agent Yapılandırma Rehberi: Config Dosyası ile Ajanınızı Kişiselleştirin

Hermes Agent yapılandırma dosyası, AI ajanınızın davranışını, kullandığı modelleri, araçları, güvenlik ayarlarını ve daha birçok özelliği kontrol etmenizi sağlar. Kurulumdan sonraki ilk adım, config dosyasını kendi ihtiyaçlarınıza göre düzenlemektir. Bu yazıda Hermes Agent yapılandırma dosyasının tüm önemli bölümlerini, hangi ayarların ne işe yaradığını ve pratik örneklerle nasıl özelleştireceğinizi adım adım anlatıyorum.

Hermes Agent Yapılandırma Dosyası Nerede Bulunur?

Hermes Agent kurulumdan sonra varsayılan yapılandırma dosyasını otomatik olarak oluşturur. Konumu işletim sisteminize göre değişir:

• Linux/macOS: ~/.hermes/config.yaml
• Windows: %USERPROFILE%\.hermes\config.yaml
• Proje bazlı kullanım: Çalışma dizininizdeki config.yaml

Dosyayı açıp incelediğinizde YAML formatında, bölümlere ayrılmış bir yapı göreceksiniz. Şimdi bu bölümleri tek tek ele alalım.

Model ve Sağlayıcı Ayarları

Config dosyasının en kritik bölümü model: anahtarı altında yer alır. Burada hangi AI modelini ve sağlayıcıyı kullanacağınızı belirlersiniz:

model:
  provider: openrouter
  default: deepseek/deepseek-v4-flash
  api_key: sk-or-...
providers: {}
fallback_providers: []

provider değeri hangi servisi kullanacağınızı belirtir. Şu anda desteklenen sağlayıcılar: openrouter, openai, anthropic, google, groq, fireworks, together ve daha fazlası. default ise varsayılan modelin adıdır. Birden fazla model tanımlayıp fallback_providers ile yedek sağlayıcılar ekleyebilirsiniz — böylece bir model yanıt vermezse Hermes Agent otomatik olarak diğerine geçer.

Agent Davranışı ve Sınırlar

agent: bölümü, AI ajanınızın nasıl çalışacağını belirler. İşte en önemli ayarlar:

agent:
  max_turns: 90
  gateway_timeout: 1800
  api_max_retries: 3
  reasoning_effort: medium
  verbose: false

max_turns bir oturumda ajanın en fazla kaç adım atabileceğini sınırlar. Karmaşık görevler için bu değeri artırabilirsiniz. gateway_timeout saniye cinsinden maksimum oturum süresidir. reasoning_effort ise low, medium veya high değerlerini alabilir — yüksek değer daha derin düşünme sağlar ama daha yavaştır.

Terminal ve Çalışma Ortamı

terminal: bölümü, Hermes Agent’ın sisteminizdeki terminali nasıl kullanacağını belirler. Hermes Agent yapılandırma ayarlarının en pratik kısımlarından biridir:

terminal:
  backend: local
  cwd: .
  timeout: 180
  persistent_shell: true
  lifetime_seconds: 300

backend değeri local (kendi bilgisayarınız), docker (Docker konteyneri), modal veya ssh olabilir. cwd çalışma dizinini belirtir. persistent_shell: true ayarı, her komut için yeni bir kabuk başlatmak yerine mevcut oturumu kullanır. Bu sayede dizin değişiklikleri ve ortam değişkenleri komutlar arasında korunur.

Güvenlik Ayarları (Tirith)

Hermes Agent’ın en dikkat çekici özelliklerinden biri, yerleşik güvenlik tarayıcısıdır. Tirith adı verilen bu sistem, ajanın çalıştıracağı komutları tehdit seviyesine göre tarar:

security:
  tirith_enabled: true
  tirith_path: tirith
  tirith_timeout: 5
  tirith_fail_open: true
  redact_secrets: true

tirith_enabled: true ile güvenlik taraması aktif olur. Yüksek riskli komutlarda Hermes Agent sizden onay ister. redact_secrets: true ayarı, API anahtarları ve şifreler gibi hassas bilgilerin günlük kayıtlarında ve çıktılarda otomatik olarak gizlenmesini sağlar. Bu özellikle blog yazılarında kod örnekleri paylaşırken veya hata ayıklarken gizliliğinizi korur.

Tool Loop Koruması

AI ajanlarının en yaygın sorunlarından biri, aynı hatayı defalarca tekrarlayarak döngüye girmesidir. Hermes Agent’ın tool_loop_guardrails sistemi bunu önler:

tool_loop_guardrails:
  warnings_enabled: true
  hard_stop_enabled: false
  warn_after:
    exact_failure: 2
    same_tool_failure: 3
  hard_stop_after:
    exact_failure: 5
    same_tool_failure: 8

Bu ayarlar sayesinde aynı araç 3 kez üst üste başarısız olursa Hermes Agent bir uyarı gösterir. 8 başarısızlıktan sonra ise otomatik olarak durur. Bu sayede gereksiz API tüketimi ve döngü hatalarının önüne geçilir. Detaylı araç kullanımı için Hermes Agent Tools Kullanımı yazısına göz atabilirsiniz.

Bellek (Memory) Ayarları

Hermes Agent, kullanıcı tercihlerini ve geçmiş bilgileri hatırlayabilir. memory: bölümü bu özelliği kontrol eder:

memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200
  user_char_limit: 1375
  nudge_interval: 10

memory_enabled: false yaparsanız Hermes Agent geçmiş konuşmaları hatırlamaz — bu gizlilik odaklı kullanımlar için idealdir. memory_char_limit ise bellekte saklanacak maksimum karakter sayısını belirler.

Cron Jobs (Zamanlanmış Görevler)

Hermes Agent’ın en güçlü özelliklerinden biri, AI ajanını zamanlanmış görevler için kullanabilmesidir. Config dosyasında cron: bölümü bu işleri yönetir:

cron:
  wrap_response: true
  max_parallel_jobs: null

Bu ayarlar sayesinde belirli saatlerde otomatik olarak içerik yayınlayabilir, yedekleme alabilir veya sistem kontrolleri yapabilirsiniz. Cron jobs ile ilgili detaylı rehberi Hermes Agent ile Cron Jobs yazısında bulabilirsiniz.

Skills (Yetenekler) Yönetimi

skills: bölümü, Hermes Agent’ın özel yeteneklerini kontrol eder:

skills:
  external_dirs: []
  template_vars: true
  inline_shell: false
  guard_agent_created: false

external_dirs ile harici skill dosyalarının konumlarını belirtebilirsiniz. guard_agent_created: true yaparsanız, yalnızca sizin onayladığınız skill’ler etkinleştirilir. Skills sistemi hakkında daha fazla bilgi için Hermes Agent Skills Nedir? yazısını okuyabilirsiniz.

Görüntü ve Tema Ayarları

Hermes Agent’ın arayüzünü kişiselleştirmek için display: bölümünü kullanabilirsiniz:

display:
  skin: default
  language: en
  compact: false
  show_cost: false
  streaming: true
  timestamps: false

Merak edenler için: display.skin değerini catppuccin, dracula veya nord gibi temalarla değiştirebilirsiniz. streaming: true ile yanıtların anlık olarak akmasını sağlayabilirsiniz.

Config Dosyasını Düzenlerken Dikkat Edilmesi Gerekenler

Hermes Agent yapılandırma dosyasını düzenlerken şu noktalara dikkat edin:

• YAML formatına dikkat edin: Girintiler boşlukla yapılır, sekme kullanmayın. Yanlış girinti tüm config dosyasını geçersiz kılar.
• API anahtarlarını güvende tutun: Config dosyasında api_key alanları vardır. Bu dosyayı başkalarıyla paylaşmayın ve chmod 600 ile yalnızca sizin okuyabildiğinizden emin olun.
• Yedek alın: Değişiklik yapmadan önce config dosyasının bir kopyasını alın. Böylece hata durumunda geri dönebilirsiniz.
• Değişiklikler hemen etkili olmayabilir: Bazı ayarlar için Hermes Agent’ı yeniden başlatmanız gerekebilir.

Ayrıca sitenizde web tasarım paketleri sayfasını ziyaret ederek profesyonel web çözümlerini inceleyebilirsiniz. WordPress sitenizde güvenlik ve performans için Bolcal Anti Spam eklentisini ve fatura süreçleriniz için WooCommerce Bireysel Kurumsal Fatura eklentisini kullanabilirsiniz.

Sonuç

Hermes Agent yapılandırma dosyası, AI ajanınızı tamamen size göre şekillendirmenizi sağlayan güçlü bir araçtır. Model seçiminden güvenliğe, terminal davranışından cron görevlerine kadar her şeyi bu dosyadan kontrol edebilirsiniz. Config dosyasını ihtiyaçlarınıza göre düzenleyerek Hermes Agent’dan en yüksek verimi alabilirsiniz.

Daha fazla sorunuz varsa iletişim sayfasından bana ulaşabilirsiniz.