BroadRouter
Başlayın

Kodlama ajanlarını gece boyunca gözetimsiz ve güvenle çalıştırma

BroadNet Inference ekibi · 5 dk okuma · Yayımlandı · Güncellendi

Ajanı yalnızca deponun bağlı olduğu bir konteynerde veya sanal makinede, kendi git dalında çalıştırın ve her tamamlanan adımdan sonra commit etsin. Ona yazılı bir görev dosyası, bir adım sınırı ve bir bitiş saati verin, sonra dalı sabah inceleyin. BroadNet'in aylık $60 fiyatlı Full Moon planı gibi sabit bir plan oturumu en kötü durumdaki faturayı sabitler.

Kodlama ajanları uzun, iyi tanımlanmış, sıkıcı işlerde iyidir: elli modüle test eklemek, her çağrı noktasını yeni bir API’ye taşımak, bin lint uyarısını düzeltmek. Bu tür işler sizin başında beklemenizi gerektirmez. Gereken; güvenli bir çalışma ortamı, net bir görev, takılmaya karşı korumalar ve sonucu kahvenizi içerken incelemenin bir yoludur.

Bunu kurmak için bir kontrol listesi aşağıda.

1. Gözetimsiz bir ajan nasıl sanal alana alınır?

Gözetimsiz bir ajan, kimsenin onaylamadığı kabuk komutları çalıştırır. Eninde sonunda sizin çalıştırmayacağınız bir şeyi çalıştıracağını varsayın: yanlış dizini silmek, bir paket kurmak, bir uzak depoya push etmek. Onu sınırlayın.

  • Dizüstü bilgisayarınızın ana kullanıcı hesabı değil, bir konteyner veya sanal makine. Docker’ın güvenlik belgeleri kontrolleri anlatıyor; en azından root olmayan bir kullanıcıyla çalıştırın ve ihtiyaç duymadığınız yetenekleri (capabilities) kaldırın.
  • Yalnızca depoyu bağlayın. Ana dizin yok, SSH anahtarı yok, bulut kimlik bilgisi yok, token dolu bir ~/.config yok.
  • Üretim sırrı yok. Test veritabanları ve sahte API anahtarları kullanın. Ajanın gerçek bir hizmete ihtiyacı varsa, ona kapsamı sınırlı ve iptal edilebilir bir anahtar verin.
  • Ağı sınırlayın. Ajanın model API’sine ve belki bir paket kaydına ihtiyacı var. Başka bir şeye nadiren ihtiyaç duyar.
  • Push yetkisi yok. Yerel olarak commit etsin. İncelemeden sonra push’u siz yaparsınız.

Model API anahtarı, ajanın sahip olması gereken tek kimlik bilgisidir. Bu amaçla oluşturulmuş bir anahtar kullanın ve sağlayıcınız destekliyorsa onu sanal alanın çıkış IP’siyle kısıtlayın. BroadNet anahtarları 32 girişe kadar IP izin listelerini destekliyor; böylece sızan bir anahtar başka hiçbir yerden işe yaramaz.

2. Neden her ajana kendi dalını vermeli?

main üzerinde değil, ayrılmış bir dalda çalışın. Birden fazla ajan çalıştırıyorsanız, her birine git worktree ile kendi çalışma dizinini verin:

git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes

Her worktree aynı deponun ayrı bir çalışma kopyasıdır; böylece ajanlar birbirinin dosyalarının üzerine yazmaz ve her dal tek bir ajanın tam olarak ne yaptığını gösterir.

Ardından her tamamlanan adımdan sonra commit edin. Aider bunu varsayılan olarak yapar. Diğer ajanlarda bunu talimatlara ekleyin veya döngüyü testler her geçtiğinde commit olacak şekilde sarın. Küçük commit’lerden oluşan bir geçmiş, “ajan gece 3’te bir şeyi bozdu” cümlesini “14. commit bozdu; 1’den 13’e kadar kalsın” cümlesine çevirir.

3. Görev dosyasına ne yazılır?

Etkileşimli kullanımda işe yarayan tek satırlık bir istem gece başarısız olur, çünkü ajanın ilk sorusunu yanıtlayacak kimse yoktur. Bir görev dosyası yazın:

# Task: add unit tests to src/billing/

## Goal
Every public function in src/billing/ has at least one unit test.

## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit

## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.

## Notes
Append decisions and skipped items to NOTES.md as you go.

En önemli kısım “Done when” (bitti sayılır) bölümüdür. Ajana işi bitirdiğini anlamanın, size de kontrol etmenin bir yolunu verir. Notlar dosyası, çalışma yeniden başlarsa veya bağlam sıkıştırılırsa bellek işlevi de görür; bkz. uzun süre çalışan ajanlarda bağlam yönetimi.

4. Takılan bir ajanı hangi korumalar durdurur?

Gözetimsiz demek, takılan bir ajanı sabaha kadar kimsenin fark etmemesi demektir. Dört koruma:

  1. Adım sınırı. Görev başına sabit bir azami model çağrısı sayısı.
  2. Bitiş saati. Durum ne olursa olsun belirli bir saatte, örneğin 07:00’de durun.
  3. Tekrar tespiti. Aynı araç çağrısı aynı sonucu üç kez döndürdüğünde veya belirli sayıda adım boyunca hiçbir dosya değişmediğinde durun.
  4. Araç başına zaman aşımları. Takılan bir test paketi bütün geceyi kilitlememeli.

Bir koruma devreye girdiğinde ajan nedenini notlar dosyasına yazmalı ve düzgünce çıkmalı. Adım ve yeniden deneme sınırlarının maliyet açısından neden önemli olduğu, kodlama ajanı maliyet rehberindeki görev başına adımları sınırlayın bölümünde anlatılıyor.

Aider’ı bu şekilde çalıştırmak kolay: betik yazma belgeleri tek bir talimatı çalıştırıp çıkmak için --message seçeneğini, istemleri otomatik kabul etmek için --yes-always seçeneğini gösteriyor. Bunu bir görev listesi üzerinde dönen bir kabuk döngüsüne sarın, her çalışmanın etrafına timeout koyun; basit bir gece kuyruğunuz olur.

5. Gece için plan oturumu mu, token başına faturalandırma mı daha ucuz?

Gece çalışmaları maliyet sorusunu değiştirir. Sayaca kimse bakmıyordur ve takılan bir ajan saatlerce döngüde kalabilir.

Token başına ücretli bir anahtarda maliyet, ajanın ne kadar gönderdiğine bağlıdır. Ajanlar bağlamı her adımda yeniden gönderir; sekiz saatlik bir çalışma bu yüzden birikir. İstem önbellekleme çok yardımcı olur (DeepSeek V4.1 Flash modelinde önbellekli girdi 1M token başına $0.0055, yeni girdi $0.175), ama çıktı ve akıl yürütme token’ları tam ücretle faturalandırılır. Çalışma başına bir token bütçesine ve hesapta bir harcama sınırına ihtiyacınız olur.

Plan oturumunda token sayacı yoktur. Bir Full Moon oturumu, sınırsız DeepSeek V4.1 Flash için ayda $60 tutar ve ajan ne kadar uzun çalışırsa ya da ne kadar döngüye girerse girsin tavan budur. Gece işleri için asıl çekici yan bu: en kötü durumdaki fatura, siz yatmadan önce bellidir.

Token başına anahtar Plan oturumu
Takılan bir gecenin en kötü maliyeti Token’larla artar Plan fiyatında sabit
Paralel ajanlar Kullandıkça öde anahtarı başına aynı anda 4 isteğe kadar Oturum başına aynı anda tek istek
Modeller Tüm sohbet modelleri Yalnızca DeepSeek V4.1 Flash
Korumalar yine gerekli mi Evet, maliyet ve süre için Evet, süre için

Oturumlarla ilgili iki pratik not. Bir oturum aynı anda tek istek çalıştırır; bir oturumu paylaşan iki ajan sırayla çalışır. Tek oturumdaki görevler art arda yürür ve bu gece için çoğu zaman sorun değildir. Ajanların yan yana çalışmasını istiyorsanız her ajan için bir oturum satın alın. Hesabı sabit ücretli API’de paralel ajanlar yazısı yapıyor.

saniyede yaklaşık 100 token olan tipik hızda, bir oturum bir ay kesintisiz kullanımda yaklaşık 259 milyon çıktı token’ı üretebilir. Bunun sizin için token başına fiyatlandırmadan daha avantajlı olup olmadığı hacme bağlı; BroadNet’in tam zamanlı bir kodlama ajanı için hesapladığı örnek, kullandıkça öde ile ayda yaklaşık $65.40 ediyor. Kendi rakamlarınızı sabit ücret ve token başına ücret hesaplayıcısında hesaplayın. Uzun gözetimsiz çalışmalar ayrıca bağlam disiplini ve çökmeden sağ çıkan yeniden denemeler gerektirir: bkz. zaman aşımları, yeniden denemeler ve kontrol noktaları.

6. Çalışma sabah nasıl incelenir?

Bir gece çalışmasının değeri ancak inceleme anında ortaya çıkar. İncelemeyi hızlı yapın:

  1. Önce NOTES.md’yi okuyun. Ajan neyi bitirdi, neyi atladı, nerede takıldı?
  2. Durma nedenini kontrol edin. Bitti mi, adım sınırı mı, bitiş saati mi, tekrar mı?
  3. Testleri kendiniz çalıştırın. Ajanın testlerin geçtiğine dair raporuna güvenmeyin.
  4. Diff’i commit commit okuyun. Küçük commit’ler kötü değişiklikleri fark edip atmayı kolaylaştırır.
  5. Tuttuğunuz kısmı squash veya rebase edin, sonra normal bir pull request açın.

Çoğu sabah işin büyük kısmını tutar ve birkaç commit’i elle düzeltirsiniz. Kötü sabahlarda bir dalı silersiniz. Her iki durumda da sizden habersiz hiçbir şey main dalına dokunmamıştır.

İlk gece nasıl güvenle denenir?

İyi tanımlanmış tek bir görev, tek bir ajan ve tek bir oturumla başlayın. Bir Meteor saati ($1), bir şeyi bütün gece çalışır bırakmadan önce sanal alan, dal ve koruma kurulumunun çalıştığını kontrol etmeye yeter. Ajanın kendisi için Aider rehberinde tam bağlantı ayarları var; kodlama ajanları için en iyi açık model yazısı model seçmenize yardımcı oluyor; plan oturumları nasıl çalışır rehberi de anahtarları ve oturumları anlatıyor.

Sık sorulan sorular

Bir ajanın gözetimsiz kabuk komutu çalıştırması güvenli mi?

Yalnızca gönül rahatlığıyla atabileceğiniz bir sanal alanın içinde. Depoyu bağlayın, sırları ve üretim kimlik bilgilerini dışarıda tutun ve ağ erişimini görevin ihtiyacıyla sınırlayın.

Bir plan oturumu kaç gece görevini kaldırır?

Bir oturum aynı anda tek istek çalıştırır, bu yüzden bir oturumdaki görevler art arda çalışır. Görevleri tek oturumda sıraya koyun veya paralel çalışmasını istediğiniz her ajan için bir oturum satın alın.

Ajan gece derlemeyi bozarsa ne olur?

İncelemeden hiçbir şey ana dalınıza ulaşmaz. Adım başına bir commit ile işin tam olarak nerede bozulduğunu görür, o noktadan önceki iyi commit'leri tutarsınız.

Hangi görevler gece çalışmalarına uygun?

Yeni bir API'ye çağrı noktalarını taşımak, test edilmemiş modüllere test eklemek, kod tabanı genelinde lint düzeltmek, bağımlılıkları yükseltmek gibi iyi tanımlanmış ve test edilebilir işler. Ucu açık tasarım işi ise sürece bir insanın dahil olduğu şekilde daha iyi yapılır.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor