Gerçek Dünyada Çalışan Bir Claude Ajanı Oluşturma Kılavuzu
Çoğu Claude ajanı eğitimi "Merhaba Dünya" ile biter.
Size Claude'a nasıl bir araç çağırtacağınızı gösterirler. Temel bir döngü kurmayı anlatırlar. Basit bir oyuncak görevde nasıl otonom yanıt alacağınızı öğretirler.
Sonra gerçek bir şey inşa etmeye kalkışırsınız ve her şey dağılır.
Görev çok belirsizdir. Ajan takılıp kalır. Çıktılar tutarsızdır. Oturum biter ve hiçbir şey kaydedilmemiştir. Bir dahaki sefere sıfırdan başlarsınız.
Bir eğitimde çalışan Claude ajanı ile üretimde çalışan Claude ajanı arasındaki fark, Claude'ın yeteneğindeki bir boşluk değildir.
Bu, ajanın nasıl tasarlandığındaki bir boşluktur.
Bu kılavuz, bu boşluğu tamamen kapatır.
Sonunda, güvenilir bir şekilde gerçek bir iş akışı çalıştıran bir Claude ajanınız olacak. Bir demo değil. Oyuncak bir görev değil. Tutarlı çıktılar üreten, uç durumları zarifçe yöneten, zamanla gelişen ve her adımı sizin başlatmanızı gerektirmeyen bir iş akışı.
Gerçek Dünya Ajanını Farklı Kılan Şey
Bir şey inşa etmeden önce, gerçek dünya ajanını bir eğitim ajanından ayıran şeyi anlayın.
Bir eğitim ajanı, temiz girdilerle temiz bir görev çalıştırır ve temiz bir çıktı üretir. Görev iyi tanımlanmıştır. Girdiler tam olarak beklenen formatta sağlanır. Beklenmedik hiçbir şey olmaz. Başarı ikili ve açıktır.
Gerçek dünya ajanı, karmaşık girdilerle karmaşık görevler çalıştırır ve yine de kullanışlı çıktılar üretmek zorundadır. Görev kısmen tanımlanmıştır. Girdiler değişen formatlarda gelir. Beklenmedik şeyler düzenli olarak olur. Başarı bir derece meselesidir ve değerlendirmek için yargı gerektirir.
Bir ajanın gerçek dünyayla temasında hayatta kalıp kalmayacağını belirleyen dört özellik vardır:
Sağlam görev tanımı. Ajan sadece ne yapacağını değil, pratikte karşılaşacağı görevin yirmi varyasyonunu nasıl yöneteceğini de bilir. Talimatlar sadece mutlu yol senaryosunu değil, uç durumları da kapsar.
Kalıcı bellek. Ajan, oturumlar arasında bağlam biriktirir. Geçen hafta yaptığı iş, bugün yaptığı işi bilgilendirir. Her oturumda sıfırdan başlamaz.
Zarif hata yönetimi. Bir şey ters gittiğinde ajan durmak yerine kurtarır. Ne olduğunu günlüğe kaydeder, alternatifleri dener ve yalnızca kurtarma imkansız olduğunda bir insanı uyarır.
Kalite kendi kendini doğrulama. Ajan, çıktılarını teslim etmeden önce tanımlı standartlara göre kontrol eder. İlk ürettiği şeyi geri vermek yerine kendi geri bildirim döngüsünü kapatır.
Çoğu eğitim ajanı bu özelliklerin hiçbirine sahip değildir. Bu kılavuz dördünü de inşa eder.
Ajan Mimarisi
Mimari, birlikte çalışan dört bileşenden oluşur.
Görev Tanım Katmanı
Görevi, süreci, uç durum yönetimini ve kalite standardını tanımlayan yapılandırılmış bir beceri dosyası. Bu bir istem değildir. Ajanın her yürütmeden önce okuduğu eksiksiz bir operasyonel şartnamedir.
Bellek Katmanı
Ajanın ne yaptığını, ne öğrendiğini ve oturumlar arasında hatırlaması gerekenleri depolayan kalıcı bir veritabanı. Hermes Agent aracılığıyla SQLite üzerine kurulmuştur veya dosya tabanlı günlükleme ile manuel olarak uygulanmıştır.
Yürütme Katmanı
İşi yapan gerçek Claude API çağrıları. İş akışının her adımı için doğru modeli, doğru bağlamı ve doğru araçları kullanacak şekilde yapılandırılmıştır.
Kalite Katmanı
Çıktıları teslim etmeden önce tanımlı standartlara göre kontrol eden ve çıktılar yetersiz kaldığında belirli düzeltmelerle yeniden deneyen doğrulama döngüsü.
Temeli Kurmak
Gerekli araçları yükleyin:
Orkestrasyon ve bellek için Hermes Agent'ı yükleyin
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
npm install
Araç erişimi için MCP sunucularını yükleyin
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-brave-search
Ortamınızı yapılandırın:
Temel yapılandırma
MODEL_PROVIDER=anthropic
MODEL_NAME=claude-opus-4-8
ANTHROPIC_API_KEY=api-anahtarınız-buraya
Bellek yapılandırması — mutlak yollar kullanın
MEMORY_BACKEND=sqlite
MEMORY_PATH=/Users/kullaniciadiniz/ajan-verisi/memory.db
Zamanlayıcı yapılandırması
ENABLE_SCHEDULER=true
SCHEDULER_TIMEZONE=Europe/Istanbul
Çıktı yapılandırması — sonuçların gideceği yer
OUTPUT_PATH=/Users/kullaniciadiniz/ajan-ciktisi
Hata kurtarma
SKILL_RETRY_ENABLED=true
SKILL_RETRY_MAX=3
SKILL_RETRY_DELAY=300
Bildirimler
NOTIFICATION_GATEWAY=telegram
TELEGRAM_BOT_TOKEN=bot-tokeniniz
TELEGRAM_CHAT_ID=sohbet-id-niz
CLAUDE.md dosyasını yazın:
Bu, tüm kurulumdaki en önemli dosyadır. Her ajan oturumu onu okuyarak başlar. Her çıktının kalitesi, burada yazılanların özgüllüğüne bağlıdır.
Ajan Yapılandırması — CLAUDE.md
Kimlik ve Amaç
[Bu ajanın ne yaptığını belirli bir paragrafta açıklayın.
Claude'un genel olarak ne olduğunu değil. Bu belirli ajanın
bu belirli operasyon için ne yapacak şekilde yapılandırıldığını.]
Operasyonel Bağlam
[Bu ajanın içinde çalıştığı iş veya kişisel bağlamı açıklayın.
Bu ajanı yapılandıran kişi ne yapıyor?
Standartları ve öncelikleri neler?]
Mevcut Aktif Görevler
[Bu ajanın çalıştırdığı belirli yinelenen görevleri listeleyin.
Her biri için: ne yaptığı, ne zaman çalıştığı, iyi bir çıktının
nasıl göründüğü.]
Araç İzinleri
Bu araçları otonom olarak kullanma izniniz vardır:
- Dosya sistemi: [BELİRLİ YOLLAR]'da okuma ve yazma
- Web araması: [BELİRLİ KONULAR] hakkında araştırma için
- [Belirli kapsamlı diğer araçlar]
Şunları yapmamalısınız:
- Yapılandırılmış çıktı dizini dışındaki herhangi bir yola yazma
- Yukarıda listelenmeyen harici API çağrıları yapma
- Açık onay olmadan harici sistemleri etkileyen herhangi bir işlem yapma
Kalite Standartları
[Her görev türü için iyi bir çıktının nasıl göründüğünü açıklayın.
Mümkünse örnekler ekleyin.
Ajanın kendi kendini değerlendirebilmesi için yeterince spesifik olun.]
Bellek Talimatları
Bellekte şunları saklayın:
- Tarih ve kalite değerlendirmesi ile birlikte her önemli çıktı
- Karşılaşılan her uç durum ve nasıl ele alındığı
- Her kalite hatası ve buna neyin sebep olduğu
- Çıktılar arasında tanımlanan her model
Hata Yönetimi
Araç hatasında: bir kez yeniden dene, hatayı günlüğe kaydet, mevcut
araçlarla devam et.
Kalite hatasında: tamamen yeniden yazma değil, belirli düzeltmelerle
yeniden dene. Maksimum üç yeniden deneme.
Kurtarılamaz hatada: kısmi çalışmayı kaydet, belirli hatayı günlüğe
kaydet, bildirim gönder, zarifçe dur.
Görev Tanım Katmanını Oluşturmak
Görev tanım katmanı, çoğu gerçek dünya ajanının başarısız olduğu yerdir.
İnsanlar mutlu yol senaryosunu tanımlayan bir istem yazar ve dururlar. Ajan mutlu yolu iyi idare eder ve diğer her şeyde bozulur.
Sağlam bir görev tanımı, görevin tam operasyonel gerçekliğini kapsar. İşte şablon:
[GÖREV ADI]
Amaç
[Bir cümle: bu beceri neyi başarır?]
Tetikleyici
[Bunun çalışmasına neden olan kesin koşullar:
zamanlanmış saat, dosya görünümü, manuel komut, vb.]
Yürütme Öncesi Kontroller
Başlamadan önce doğrulayın:
- [Gerekli girdi mevcut ve erişilebilir]
- [Gerekli araçlar bağlı ve yanıt veriyor]
- [Çıktı yolu yazılabilir]
- [Bellek erişilebilir ve güncel]
Herhangi bir kontrol başarısız olursa: hatayı günlüğe kaydedin ve durun.
Eksik ön koşullarla devam etmeyin.
Ana Süreç
Adım 1: Bağlam Yükleme
Tam operasyonel bağlam için CLAUDE.md dosyasını okuyun.
Etiketlenmiş ilgili geçmiş için belleği okuyun: [GÖREV-ETİKETİ]
Bu yürütmeyi bilgilendirmesi gereken önceki yürütmelerden
kalıpları not edin.
Adım 2: Girdi İşleme
[Girdi ile tam olarak ne yapılacağını açıklayın.
Birincil formatı VE pratikte görünen alternatif formatları kapsayın.]
Standart girdi formatı için:
[Kesin işleme adımları]
Alternatif girdi formatı A için:
[Nasıl ele alınacağı]
Alternatif girdi formatı B için:
[Nasıl ele alınacağı]
Hatalı biçimlendirilmiş veya eksik girdi için:
[Nasıl ele alınacağı — asla sessizce başarısız olmayın]
Adım 3: Temel Yürütme
[Becerinin asıl işi.
Alt adımlara bölün. Her alt adım, yeni bir Claude örneğinin
ek bağlam olmadan yürütebileceği kadar spesifik olmalıdır.]
Adım 4: Kalite Doğrulama
Çıktıyı kaydetmeden önce, bu standartlara göre doğrulayın:
GEREKLİ: [Pazarlık konusu olmayan çıktı özellikleri]
TERCİH EDİLEN: [Çıktıyı iyileştiren kalite özellikleri]
YASAK: [Çıktıda asla görünmemesi gereken şeyler]
Çıktı gerekli kontrollerde başarısız olursa:
- Tam olarak neyin başarısız olduğunu belirleyin
- Hedeflenen düzeltme ile yeniden deneyin
- Maksimum üç yeniden deneme
- Üç denemeden sonra hala başarısızsa: başarısız bayrağı ile kaydedin
Adım 5: Çıktı ve Depolama
Çıktıyı şuraya kaydedin: [BELİRLİ YOL VE DOSYA ADI FORMATI]
Etiketlenmiş bellekte saklayın: [GÖREV-ETİKETİ, TARİH]
Herhangi bir güncel bilgi değiştiyse CLAUDE.md dosyasını güncelleyin.
Bildirim gönderin: [BİLDİRİME NELER DAHİL EDİLECEK]
Uç Durumlar
[Uç Durum 1 Adı]
Durum: [Bu ne zaman oluşur]
Tespit: [Nasıl tanınacağı]
Yanıt: [Ne yapılacağı]
[Uç Durum 2 Adı]
Durum: [Bu ne zaman oluşur]
Tespit: [Nasıl tanınacağı]
Yanıt: [Ne yapılacağı]
[Uç Durum 3 Adı]
Durum: [Bu ne zaman oluşur]
Tespit: [Nasıl tanınacağı]
Yanıt: [Ne yapılacağı]
Kalite Standardı
Harika bir çıktı: [Spesifik açıklama]
Kabul edilebilir bir çıktı: [Minimum bar]
Kabul edilemez bir çıktı: [Yeniden denemeyi tetiklemesi gereken şey]
Bellek Talimatları
Her yürütmeden sonra saklayın:
- Yürütme tarihi ve süresi
- Çıktı kalite değerlendirmesi (harika/kabul edilebilir/başarısız)
- Karşılaşılan herhangi bir uç durum ve nasıl ele alındığı
- Gelecek yürütmeler için kayda değer herhangi bir desen
İlk Gerçek Ajanınız: Araştırma ve Brifing Ajanı
İşte bu mimari kullanılarak inşa edilmiş eksiksiz bir gerçek dünya ajanı. Bu ajan, günlük olarak bir dizi kaynağı izler, işinizle ilgili konuları araştırır ve her sabah yapılandırılmış bir brifing sunar.
Bu oyuncak bir görev değildir. Her gün kırk beş dakikalık manuel araştırma derlemesinin yerini alan gerçek bir iş akışıdır.
skills/research-brief.md dosyasını oluşturun:
research-brief
Amaç
Yapılandırılmış kaynakları izleyin ve mevcut projeler
ve önceliklerle ilgili gelişmeleri kapsayan yapılandırılmış
bir istihbarat brifingi üretin.
Tetikleyici
Her gün saat 06:00'da zamanlanmış.
Manuel: "Araştırma brifingi" veya "Sabah brifingi"
Yürütme Öncesi Kontroller
Başlamadan önce doğrulayın:
- CLAUDE.md dosyası 07-SYSTEM/CLAUDE.md yolunda okunabilir
- Brave Search MCP yanıt veriyor
- Çıktı yolu outputs/briefings/ yolunda yazılabilir
- Bellek veritabanına erişilebilir
Ana Süreç
Adım 1: Bağlam Yükleme
CLAUDE.md dosyasını tamamen okuyun. Şunları not edin:
- Mevcut aktif projeler ve durumları
- İzleme için işaretlenmiş konular
- İstihbarat gerektiren bekleyen kararlar
- Bu brifing için kalite standartları
Etiketlenmiş belleği okuyun: research-brief
Son brifinglerde nelerin kapsandığını not edin
tekrardan kaçınmak için.
Adım 2: Kaynak Araştırması
CLAUDE.md izleme listesindeki her konu için:
Arama sorgusu: "[KONU] son 24 saat haberi"
Toplayın: başlık, kaynak, tarih, ana iddia
Sinyal filtresi uygulayın:
DAHİL ET: Yeni gelişme, veri, ürün lansmanı, önemli açıklama, araştırma bulgusu
HARİÇ TUT: Mevcut kapsamın tekrarı, yeni bilgi olmayan görüş, son 3 brifingde kapsanan her şey
Sinyal filtresini geçen her sonuç için:
İlk sonuç önemli bir gelişme gösteriyorsa
takip araması ile daha derin araştırma yapın.
Adım 3: Sentez
Bulguları konuya göre gruplayın.
Her konu grubu için şunları belirleyin:
- En önemli tek gelişme
- Mevcut projeler için neden önemli olduğu
- Hangi eylemi ima ettiği
Konular arası sentez:
- Daha büyük bir desen öneren bağlantılı iki veya daha fazla bulgu var mı?
- Herhangi bir bulgu, aktif bir projeyi veya bekleyen kararı doğrudan etkiliyor mu?
Adım 4: Kalite Doğrulama
Son haline getirmeden önce doğrulayın:
GEREKLİ:
- En az 3 sinyal öğesi (gürültü değil)
- Her öğe belirli bir kaynağa dayandırılmış
- Her öğe mevcut çalışmayla ilgisini açıklıyor
- Son 5 brifingden hiçbir öğe tekrarlanmamış
TERCİH EDİLEN:
- En az bir konular arası bağlantı
- Belirli bir eylemi ima eden en az bir öğe
- Sakin bir haber günüyse dürüst kabul
YASAK:
- Belirli kanıt olmadan genel analiz
- İlginç ancak alakasız öğeler
- Brifingi daha kapsamlı göstermek için doldurma
Brifing gerekli kontrollerde başarısız olursa: tam olarak
neyin eksik olduğunu belirleyin ve yeniden denemeden önce
ek kaynaklar için arama yapın. Zayıf sinyallerle doldurmayın.
Adım 5: Çıktı Oluşturma
Brifingi bu tam formatta oluşturun:
Sabah İstihbarat Brifingi — [TARİH]
BUGÜN EN ÖNEMLİ
[En önemli tek gelişme ve mevcut çalışma için neden
önemli olduğu. Spesifik. Dayandırılmış.]
SİNYAL ÖĞELERİ
[Konu 1]
Gelişme: [Ne oldu]
Kaynak: [Yayın, tarih]
Alaka: [Mevcut projeler için neden önemli]
Anlamı: [Bunun önerdiği herhangi bir eylem]
[Konu 2]
[Aynı format]
[Her sinyal öğesi için devam edin]
BAĞLANTI
[İki veya daha fazla öğe daha büyük bir desen önerecek
şekilde bağlanıyorsa, burada açıklayın. Gerçek bir bağlantı
yoksa atlayın.]
KARAR ALAKASI
[Herhangi bir öğe CLAUDE.md dosyasındaki bekleyen bir
kararla doğrudan ilgiliyse, burada belirtin ve ayrıntıları verin.]
KAPSAM NOTU
[Dürüst değerlendirme: kapsamlı gün / sakin haber günü.
Taranan kaynak sayısı.]
Adım 6: Depolama ve Bildirim
Şuraya kaydedin: outputs/briefings/[TARİH]-sabah-brifingi.md
Bellekte saklayın:
- Tarih: [BUGÜN]
- Kapsanan öğeler: [KONULARIN LİSTESİ]
- Kalite: [harika/kabul edilebilir/başarısız]
- Kayda değer: [Herhangi bir uç durum veya desen] Etiket: research-brief
Telegram bildirimi gönderin:
"Sabah brifingi hazır: [N] sinyal öğesi.
[EN ÖNEMLİ GELİŞME tek satırda]"
Uç Durumlar
Bir Konu İçin Sinyal Bulunamadı
Durum: Aramalar yeni gelişme döndürmüyor
Tespit: Tüm sonuçlar 48 saatten daha eski
Yanıt: Bu konu için "Yeni gelişme yok" olarak not edin.
Uydurmayın veya doldurmayın. Sonraki konuya geçin.
Kaynak Çelişkili Bilgi Döndürüyor
Durum: İki kaynak çelişkili gerçekler bildiriyor
Tespit: Belirli bir iddiada doğrudan çelişki
Yanıt: Her iki versiyonu da bildirin, her iki kaynağı da belirtin,
çelişkili olarak işaretleyin. Birini diğerine tercih etmeyin.
Arama Aracı Kullanılamıyor
Durum: Brave Search MCP yanıt vermiyor
Tespit: Araç çağrısı hata döndürüyor
Yanıt: Hatayı günlüğe kaydedin. Telegram üzerinden bildirin.
Kısmi brifingi şu notla kaydedin: "Arama kullanılamıyor —
brifing yalnızca bellek bağlamına dayanmaktadır."
Sessizce başarısız olmayın.
Brifing Dünün En Önemli Öğesini Tekrarlayacak
Durum: En önemli gelişme dünle aynı
Tespit: Bellekteki dünün brifingiyle çapraz referans
Yanıt: "[TARİH] tarihinden itibaren devam eden gelişme" olarak not edin
ve bugün özellikle yeni olana odaklanın.
Kalite Standardı
Harika brifing: 4-6 sinyal öğesi. Her öğe alakalı.
En az bir konular arası içgörü. 5 dakikadan kısa sürede okunur.
Kabul edilebilir brifing: 3 sinyal öğesi. Hepsi alakalı.
Konular arası içgörü yok. 5 dakikadan kısa sürede okunur.
Kabul edilemez brifing: 3'ten az sinyal öğesi.
Genel veya mevcut çalışmayla alakasız herhangi bir öğe.
Son 3 brifingden tekrarlanan herhangi bir öğe.
Kalite Doğrulama Katmanını Oluşturmak
Kalite doğrulama katmanı, tutarlı sonuçlar üreten ajanları değişken sonuçlar üreten ajanlardan ayıran şeydir.
Çoğu ajan bu katmanı tamamen atlar. Bir çıktı üretir ve onu döndürür. Kalite, tamamen üretimin ne kadar iyi olduğuna bağlıdır. Bazı oturumlar mükemmeldir. Bazıları vasattır. Hangisini alacağınızı asla bilemezsiniz.
Bir kalite doğrulama katmanı, her çıktıyı tanımlı standartlara göre kontrol ederek ve standartlar karşılanmadığında belirli düzeltmelerle yeniden deneyerek çıktı kalitesini tutarlı hale getirir.
İşte kalite doğrulamayı uygulayan Claude API çağrı modeli:
async function executeWithQualityVerification(prompt, qualityStandard, maxRetries = 3) {
let attempt = 0;
let lastOutput = null;
let lastFailure = null;
while (attempt < maxRetries) {
// Çıktıyı oluştur
const response = await fetch('https://api.anthropic.com/v1/messages', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ANTHROPIC_API_KEY,
'anthropic-version': '2023-06-01'
},
body: JSON.stringify({
model: 'claude-opus-4-8',
max_tokens: 4096,
messages: [
{
role: 'user',
content: attempt === 0
? prompt
: \${prompt}
Önceki deneme kalite kontrolünden geçemedi: ${lastFailure}
Özellikle bu başarısızlık için düzeltme yapın. Her şeyi yeniden yazmayın.\
}
]
})
});
const data = await response.json();
lastOutput = data.content[0].text;
// Kaliteyi doğrula
const verificationResponse = await fetch('https://api.anthropic.com/v1/messages', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ANTHROPIC_API_KEY,
'anthropic-version': '2023-06-01'
},
body: JSON.stringify({
model: 'claude-opus-4-8',
max_tokens: 1000,
messages: [
{
role: 'user',
content: `Bir kalite denetleyicisisiniz. Bu çıktıyı aşağıdaki standartlara göre değerlendirin:
${qualityStandard}
Değerlendirilecek çıktı:
${lastOutput}
Yalnızca ŞUNUNLA yanıt verin:
PASS eğer çıktı tüm gerekli standartları karşılıyorsa
FAIL: [başarısız olanın spesifik açıklaması] eğer gerekli standartları karşılamıyorsa
Açıklama yapmayın. İyileştirme önermeyin. Sadece PASS veya FAIL ile spesifik başarısızlık açıklaması yapın.`
}
]
})
});
const verificationData = await verificationResponse.json();
const verificationResult = verificationData.content[0].text.trim();
if (verificationResult.startsWith('PASS')) {
return { output: lastOutput, attempts: attempt + 1, passed: true };
}
lastFailure = verificationResult.replace('FAIL:', '').trim();
attempt++;
}
// Tüm yeniden denemeler tükendi
return {
output: lastOutput,
attempts: maxRetries,
passed: false,
failure: lastFailure
};
}
Bu model bir çıktı oluşturur, onu tanımlı standartlara göre kontrol eder ve başarısız olduğunda belirli düzeltmelerle yeniden dener. Tüm yeniden denemeler başarısız olursa, çökme yerine başarısız bayrağı ile en iyi çıktıyı döndürür.
Bellek Entegrasyon Modeli
Bellek, yetenekli bir ajanı öğrenen bir ajana dönüştüren şeydir.
Bellek olmadan her oturum sıfırdan başlar. Ajan daha önce ne yaptığını bilmez. Geçmiş yürütmelerden öğrenmeleri uygulayamaz. Daha önce yaptığı hatalardan kaçınamaz.
Bellekle her oturum bir öncekinin üzerine inşa edilir. Ajan neyin işe yaradığını ve neyin yaramadığını bilir. Birikmiş bağlamı mevcut çıktıları iyileştirmek için uygular. Zaman içinde belirli görevde daha iyi hale gelir.
İşte herhangi bir Claude ajanı için bellek entegrasyon modeli:
Her yürütmenin başında:
Etiketlenmiş bellek girişlerini okuyun: [GÖREV-ETİKETİ]
Sınır: En alakalı 20 giriş
Strateji: alaka (sadece yenilik değil)
Bu bağlamı uygulayın:
- Önceki yürütmelerden kalıpları not edin
- Daha önce karşılaşılan uç durumları not edin
- Daha önce tanımlanan kalite sorunlarını not edin
- Öğrenmeleri mevcut yürütmeye uygulayın
Her yürütmenin sonunda:
Bellekte saklayın:
tarih: [BUGÜN]
görev: [GÖREV ADI]
kalite: [harika/kabul edilebilir/başarısız]
kayda değer: [hatırlamaya değer her şey]
uç_durum: [karşılaşılan herhangi bir uç durum]
desen: [gözlemlenen herhangi bir desen]
Etiket: [GÖREV-ETİKETİ], [TARİH]
Aylık birleştirme:
Etiketlenmiş tüm bellek girişlerini okuyun: [GÖREV-ETİKETİ]
Şunları belirleyin:
- Birden çok girişte görünen kalıplar
- Tekrarlayan uç durumlar
- Tekrarlayan kalite sorunları
- Harika ve kabul edilebilir çıktılar arasında neyin ilişkili olduğu
Tek bir güncellenmiş bağlam girişinde birleştirin
90 günden eski bireysel girişleri arşivleyin
Hata Kurtarma Sistemi
Gerçek dünya ajanları hatalarla karşılaşır. Kaynaklar çevrimdışı olur. API'ler hız sınırı uygular. Dosyalar beklendikleri yerde değildir. Çıktılar maksimum yeniden denemeden sonra kalite kontrollerinde başarısız olur.
Hata kurtarma sistemi, bu hataların görünmez küçük aksaklıklar mı yoksa felaket duruşlar mı olduğunu belirler.
Üç kademeli hata yönetimi:
Kademe 1: Otomatik Kurtarma
Yeniden denemede çözülen geçici hatalar. Araç kullanılamıyor. Ağ zaman aşımı. Hız sınırına takılma.
Kademe 1 Kurtarma Protokolü
Herhangi bir araç çağrısı hatasında:
- 60 saniye bekleyin
- Aynı çağrıyı tam olarak yeniden deneyin
- Yeniden deneme başarılı olursa: normal devam edin, aksaklığı günlüğe kaydedin
- Yeniden deneme başarısız olursa: Kademe 2'ye yükseltin
Kademe 2: Zarif Düşüş
Çözülemeyen ancak kısmi tamamlamaya izin veren hatalar. Bir kaynak kullanılamıyor. Bir araç yanıt vermiyor. Çıktının bir bölümü kalite kontrollerinde başarısız oluyor.
Kademe 2 Kurtarma Protokolü
Çözülemeyen kısmi hatada:
- Tamamlanabilecek olanı tamamlayın
- Özellikle neyin atlandığını ve nedenini not edin
- Çıktıyı dosya adında kısmi olarak işaretleyin
- Çıktının kendisine açık not ekleyin
- Bildirim gönderin: "Kısmi çıktı — [spesifik neden]"
- Bir bileşen başarısız oldu diye tüm görevi başarısız saymayın
Kademe 3: Zarif Duruş
Tüm görevi imkansız kılan hatalar. CLAUDE.md bulunamadı. Çıktı yolu yazılabilir değil. Bellek veritabanına erişilemiyor.
Kademe 3 Kurtarma Protokolü
Tam başarısızlıkta:
- Spesifik başarısızlık noktasını belirleyin
- Yapılan herhangi bir çalışmayı geçici konuma kaydedin
- Tam başarısızlık bağlamını günlüğe kaydedin
- Bildirim gönderin: "Görev başarısız oldu — [spesifik neden]"
- Mevcut çıktıları bozmadan temiz bir şekilde durun
- Otomatik olarak yeniden denemeyin — insan müdahalesini bekleyin
Ajanınızı Dağıtmadan Önce Test Etme
Gerçek dünya ajanı dağıtımında en yaygın hata, yapılandırılmış testi atlamaktır.
Herhangi bir ajan yayına girmeden önce üç test aşaması:
Aşama 1: Bileşen Testi
Tüm iş akışını test etmeden önce her bileşeni ayrı ayrı test edin.
Belleğin kalıcı olduğunu test edin
hermes chat
Depolanmış en eski bellek girişiniz nedir?
Beklenen: Bir giriş bildirmeli veya boş veritabanı bildirmeli
Hata döndürürse: bellek yapılandırması yanlış
Araç erişimini test edin
[ÇIKTI YOLU] içindeki dosyaları listeleyin
Beklenen: Gerçek dosyaları listelemeli
Hata döndürürse: dosya sistemi MCP doğru yapılandırılmamış
Aramayı test edin
"Bugün AI haberleri" için arama yapın ve bana en iyi sonucu söyleyin
Beklenen: Gerçek arama sonuçları döndürmeli
Hata döndürürse: Brave Search MCP doğru yapılandırılmamış
Aşama 2: Mutlu Yol Testi
Beceriyi temiz bir standart girdi üzerinde manuel olarak çalıştırın ve çıktının kalite standardını karşıladığını doğrulayın.
Beceriyi manuel çalıştırın
hermes run research-brief
Çıktıyı kontrol edin
cat outputs/briefings/[BUGÜN]-sabah-brifingi.md
Kalite standardına göre doğrulayın:
- En az 3 sinyal öğesi var mı?
- Her öğe mevcut çalışmayla alakalı mı?
- Genel analiz yok mu?
- 5 dakikadan kısa sürede okunuyor mu?
Aşama 3: Uç Durum Testi
Belgelenen her uç durumu kasıtlı olarak tetikleyin ve kurtarma davranışını doğrulayın.
Test: internet erişimi yok
.env dosyasında Brave Search'ü devre dışı bırakın
Beceriyi çalıştırın
Beklenen: Kademe 3 hatası, temiz duruş, bildirim gönderildi
Test: çıktı yolu yazılabilir değil
OUTPUT_PATH'i var olmayan bir dizine değiştirin
Beceriyi çalıştırın
Beklenen: Kademe 3 hatası, temiz duruş, bildirim gönderildi
Test: sakin haber günü
Hafta sonu veya tatilde çalıştırın
Beklenen: Sakin günü belirten KAPSAM NOTU ile Kademe 2 çıktısı
Ajanınızı Üretimde Çalıştırma
Her üç test aşaması da geçildiğinde, zamanlayıcıyı yapılandırın ve üretime geçin.
1{2 "schedules": [3 {4 "skill": "research-brief",5 "cron": "0 6 * * *",6 "description": "Her gün saat 06:00'da",7 "timeout_minutes": 15,8 "on_failure": "notify_and_stop"9 }10 ]11}
Hermes'i arka plan modunda başlatın:
npm run start -- --daemon
İlk zamanlanmış çalıştırmayı doğrulayın:
06:00'dan sonra günlükleri kontrol edin
cat logs/hermes-[TARİH].log
Çıktının üretildiğini kontrol edin
ls outputs/briefings/
Belleğin güncellendiğini kontrol edin
hermes chat
Kaç tane research-brief bellek girişiniz var?
İlk otomatik çalıştırma iyi çıktı üretirse, ajan üretimdedir.
3. Ayda Ne Değişir?
Birinci ay: Ajan güvenilir bir şekilde çalışır. Çıktılar tutarlıdır. Hatalar zarifçe ele alınır. Her sabah kırk beş dakika kazanırsınız.
İkinci ay: Bellek katmanı gözle görülür bir iyileşme sağlamaya başlar. Aracı, altmış günlük kaynağı işlemiş ve hangi kaynakların yüksek sinyalli içerik ürettiğine karşı gürültü olduğuna dair bağlam biriktirmiştir. Sinyal filtrelemenin kalitesi artar çünkü aracı, hangi kaynakların takip edilmeye değer olduğunu öğrenmiştir.
Üçüncü ay: Bellek konsolidasyonu iki kez çalıştı. Aracı, doksan günlük araştırma boyunca desenleri tanımladı. Özetler, birikmiş bağlama atıfta bulunarak, onları herhangi bir tek seanslık araştırmanın üretebileceğinden daha sağlam ve daha spesifik hale getiriyor.
Üçüncü aydaki aracı, birinci aydakiyle aynı iş akışını çalıştırmıyor.
Doksan günlük birikmiş operasyonel zekaya dayalı olarak bu iş akışının geliştirilmiş bir sürümünü çalıştırıyor.
Bir eğitim aracısı ile gerçek dünya aracısı arasındaki fark budur.
Eğitim aracısı görevi yapar.
Gerçek dünya aracısı görevi daha iyi yapmayı öğrenir.
Bu hafta sonu temeli kur.
Bir hafta çalıştır. Bozulanları düzelt.
Bir ay çalıştır. İyileşmesini izle.
Üç ay çalıştır. Birinci günde ona söyleyemeyeceğin şeyleri bildiğini fark et.
Gerçek dünyada gerçekten çalışan bir Claude aracısı oluşturmak işte böyle görünüyor.
Claude aracılarınızın gerçek dünyayla temas halinde hayatta kalmasını sağlayan her aracı mimarisi, beceri şablonu ve üretim dağıtım deseni için @cyrilXBT'yi takip edin.
