Menyu

Hermes

AGENT INTEGRATION

Hermes ile Noxery

OpenAI uyumlu sağlayıcı ayarlarıyla güvenilir bir agent bağlantısı kur.

Gereksinimler

Bir Noxery API anahtarı ve GET /v1/models yanıtında görünen aktif bir model gerekir. Anahtarı yalnızca agent'ın çalıştığı makinede, environment variable olarak sakla.

shell
export NOXERY_API_KEY="nox-YOUR_KEY"
export NOXERY_BASE_URL="https://api.noxery.net/v1"

Yapılandırma

Hermes sürümünde OpenAI-compatible provider seçeneğini aç. Alan adları sürüme göre değişebildiği için temel değerler şunlardır:

environment
OPENAI_API_KEY=nox-YOUR_KEY
OPENAI_BASE_URL=https://api.noxery.net/v1
OPENAI_MODEL=gpt-6-astra

Agent ayarlarında farklı isimler kullanılıyorsa karşılıkları api_key, base_url ve model olarak gir. Bu agent'ın kendi güncel config dokümanında OpenAI-compatible endpoint desteği yoksa Noxery'ye doğrudan bağlanamaz.

Model seçimi

Model adını tahmin etme; katalogdan al. Agent yapılandırmasında paneldeki görünen adı değil, API'den dönen id alanını kullan.

curl
curl https://api.noxery.net/v1/models \
  -H "Authorization: Bearer $NOXERY_API_KEY"

Örnek model: gpt-6-astra. Model listesi ve limitler zamanla değişebilir.

Uzun sohbetler ve araç çağrıları

Her konuşma için sabit ve benzersiz bir session ID gönder. Bu, bağlantılı isteklerin upstream tarafında izlenmesini ve loglanmasını sağlar.

http
x-opencode-session: project-123-session-01
# Alternatif: x-codex-session veya x-conversation-id

Uzun geçmişi her turda sınırsız büyütme. Sistem context penceresine sığması için eski mesajları sıkıştırabilir; araç çağrısı ile araç sonucunu birlikte gönder. Streaming kullanırken SSE bağlantısını kesmeden parçaları sırayla birleştir.

Tool calling kullanan agent'larda tools, tool_choice ve gerekli tool sonuçlarını aynı istekte tut. Eksik bir tool çifti 400 hatasına veya tekrarlanan agent turuna yol açabilir.

Sorun giderme

401 alıyorum
Header'ın tam olarak Authorization: Bearer nox-... olduğundan ve environment variable'ın agent sürecinde tanımlı olduğundan emin ol.
404 model hatası alıyorum
GET /v1/models ile güncel ID'yi al. Modelin paneldeki adı ile API ID'si aynı olmak zorunda değildir.
429 alıyorum
Free plan için limit 15 RPM ve 30M token/aydır. 429 yanıtında kısa, jitter'lı backoff uygula; kota dolduysa tekrar denemek sorunu çözmez.
Agent uzun sohbetlerde kopuyor
Client timeout'unu artır, SSE buffering'i kapat, session header'ını sabit tut ve geçmişi düzenli aralıklarla özetle. Tek isteği sonsuza kadar büyütmek yerine yeni bir session aç.