Daimi talimatlar, tanımlanmış programlar için agent’ınıza kalıcı işletim yetkisi verir. Her görev için agent’ı yönlendirmek yerine kapsamı, tetikleyicileri ve eskalasyon kuralları açıkça belirlenmiş programlar tanımlarsınız; agent da bu sınırlar içinde özerk olarak yürütür: “Haftalık rapor senin sorumluluğunda. Her cuma derle, gönder ve yalnızca bir şeyler yanlış görünüyorsa eskale et.”
Neden daimi talimatlar
Daimi talimatlar olmadan: her görev için agent’ı yönlendirmeniz gerekir, rutin işler unutulur veya gecikir ve darboğaz siz olursunuz.
Daimi talimatlarla: agent, tanımlanmış sınırlar içinde özerk olarak yürütür, rutin işler zamanında gerçekleşir ve yalnızca istisnalar ile onaylar için sürece dahil olursunuz.
Nasıl çalışırlar
Daimi talimatlar, agent çalışma alanı dosyalarınızda tanımlanır. Önerilen yaklaşım, agent’ın bunları her zaman bağlamında bulundurması için talimatları doğrudan AGENTS.md içine (her oturumda otomatik olarak eklenir) dahil etmektir. Daha büyük yapılandırmalar için bunları standing-orders.md gibi özel bir dosyaya da yerleştirip AGENTS.md içinden bu dosyaya başvurabilirsiniz.
Her program şunları belirtir:
- Kapsam - agent’ın neleri yapmaya yetkili olduğu
- Tetikleyiciler - ne zaman yürütüleceği (zamanlama, olay veya koşul)
- Onay eşikleri - harekete geçmeden önce nelerin insan onayı gerektirdiği
- Eskalasyon kuralları - ne zaman durup yardım isteneceği
Agent, bu talimatları çalışma alanı başlangıç dosyaları aracılığıyla her oturumda yükler (otomatik eklenen dosyaların tam listesi için Agent Çalışma Alanı bölümüne bakın) ve zamana dayalı yaptırım için Cron işleri ile birlikte bunlara göre yürütür.
Her oturumda yüklenmelerini garanti etmek için daimi talimatları AGENTS.md içine koyun. Çalışma alanı başlangıcı AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md ve MEMORY.md dosyalarını otomatik olarak ekler; ancak alt dizinlerdeki herhangi bir dosyayı eklemez.
Bir daimi talimatın anatomisi
Daimi talimatlar ve Cron işleri
Daimi talimatlar, agent’ın neyi yapmaya yetkili olduğunu tanımlar. Cron işleri, bunun ne zaman gerçekleşeceğini tanımlar. Birlikte çalışırlar:
Cron işi istemi, daimi talimatı yinelemek yerine ona başvurmalıdır:
Örnekler
Örnek 1: içerik ve sosyal medya (haftalık döngü)
Örnek 2: finans işlemleri (olayla tetiklenen)
Örnek 3: izleme ve uyarılar (sürekli)
Yürüt-doğrula-raporla kalıbı
Daimi talimatlar, katı yürütme disipliniyle birleştirildiğinde en iyi sonucu verir. Daimi talimattaki her görev şu döngüyü izlemelidir:
- Yürüt - Asıl işi yap (yalnızca talimatı aldığını belirtme)
- Doğrula - Sonucun doğru olduğunu teyit et (dosya mevcut, mesaj iletildi, veriler ayrıştırıldı)
- Raporla - Sahibine ne yapıldığını ve neyin doğrulandığını bildir
Bu kalıp, en yaygın agent başarısızlık biçimini önler: görevi tamamlamadan yalnızca alındığını bildirmek.
Çok programlı mimari
Birden fazla konuyu yöneten agent’lar için daimi talimatları sınırları açıkça belirlenmiş ayrı programlar olarak düzenleyin:
Her programda şunlar bulunmalıdır:
- Kendi tetikleme sıklığı (haftalık, aylık, olay odaklı, sürekli)
- Kendi onay eşikleri (bazı programlar diğerlerinden daha fazla gözetim gerektirir)
- Açık sınırlar (agent, bir programın nerede bitip diğerinin nerede başladığını bilmelidir)
En iyi uygulamalar
Yapılması gerekenler
- Dar kapsamlı yetkiyle başlayın ve güven arttıkça kapsamı genişletin
- Yüksek riskli eylemler için açık onay eşikleri tanımlayın
- “YAPILMAMASI gerekenler” bölümlerini dahil edin; sınırlar da izinler kadar önemlidir
- Zamana dayalı güvenilir yürütme için Cron işleriyle birleştirin
- Daimi talimatlara uyulduğunu doğrulamak için agent günlüklerini haftalık olarak inceleyin
- İhtiyaçlarınız geliştikçe daimi talimatları güncelleyin; bunlar yaşayan belgelerdir
Kaçınılması gerekenler
- İlk günden geniş kapsamlı yetki vermek (“en iyi olduğunu düşündüğün şeyi yap”)
- Eskalasyon kurallarını atlamak; her programın bir “ne zaman durulup sorulacağı” maddesine ihtiyacı vardır
- Agent’ın sözlü talimatları hatırlayacağını varsaymak; her şeyi dosyaya koyun
- Konuları tek bir programda karıştırmak; ayrı alanlar için ayrı programlar kullanın
- Cron işleriyle uygulamayı unutmak; tetikleyicileri olmayan daimi talimatlar öneriye dönüşür
İlgili konular
- Otomasyon: tüm otomasyon mekanizmalarına genel bakış.
- Cron işleri: daimi talimatlar için zamanlama uygulaması.
- Kancalar: agent yaşam döngüsü olayları için olay odaklı betikler.
- Webhook’lar: gelen HTTP olay tetikleyicileri.
- Agent çalışma alanı: otomatik eklenen başlangıç dosyalarının tam listesi (
AGENTS.md, SOUL.md vb.) dahil olmak üzere daimi talimatların bulunduğu yer.