Nöbetçi mühendis: yapay zekâ ajanı PagerDuty uyarısını bir düzeltme önerisine dönüştürür

Gece üçte bir olayın ilk yarım saati hep aynı soruşturmaya benzer. Uyarıyı okursunuz, olay günlüğünü açarsınız, yakın zamanda neyin değiştiğini düşünürsünüz, son dağıtımlara geri dönersiniz, daha önce olup olmadığını kontrol edersiniz. Bu okuma ve çapraz kontrol işi tekrarlıdır, ama nöbetçi kişiye tam da bunu iyi yapmaya en az müsait olduğu anda yük bindirir. Tek bir temel koşulla bir yapay zekâ ajanına uygundur: ajan okur ve önerir, insan harekete geçer.

İlham: okuyan ilk müdahaleci

Başlangıç noktası, Hermes Agent kullanıcılarının aktardığı ve nöbetçi mühendise dair bir kartta özetlenen bir kullanımdır: uyarıdan önerilen düzeltmeye. Bir ajan olayı alır, depoyu neyin neden olmuş olabileceğini arayarak gezer ve incelenecek bir düzeltme hazırlar.

Okumayı ve öneriyi tutuyor, harekete geçen her şeyi çıkarıyoruz. Atako bu fikri, olaya bir not ve depoya bir issue yazan ama olayı çözmek, merge etmek ya da kod göndermek için hiçbir aracı olmayan bir ajanla uygular.

Ajan ne yapar

Senaryo, PagerDuty'nize ve GitHub deponuza bağlı bir ajan dağıtır.

İzlenen hizmetin tetiklenmiş ya da onaylanmış her yeni olayı için uyarıyı, olay günlüğünü ve zaten orada olan notları okur, nöbetçinin kim olduğunu kontrol eder. Ardından nedeni depoda arar: olaydan önceki kırk sekiz saatin commit'leri (şüpheli olanları açar), uyarıda ya da stack trace'te adı geçen dosyalar ve yakın zamanda merge edilmiş pull request'ler. Önce nereye bakacağını bilmek için girdiğiniz teknik bağlama dayanır. Ayrıca ilgili issue'ları, aynı türden önceki olaylar dahil, arar.

Sonra PagerDuty olayına kısa ve gerçeklere dayalı bir not yazar: kanıtların gösterdiği şey, güven düzeyiyle olası neden, kanıtlar, kontrol edemedikleri ve nöbetçi kişi için sonraki adım. Ardından depoda tam analizle bir issue açar: zaman çizelgesi, olası neden, kanıtlar, sözcüklerle ya da kod parçası olarak tarif edilmiş bir düzeltme önerisi, riskleri ve nasıl doğrulanacağı. Kopya oluşturmamak için önce var olan bir issue arar ve kusursuz bir analizi beklemek yerine ilk notu tamamlar.

Hizmeti her on beş dakikada bir izler ve her pazartesi 9:00'da proje wiki'sine "Haftanın olay değerlendirmesi" sayfasını yazar: ele alınan olaylar, olası neden, açılan issue, hâlâ açık olanlar.

Ajan ne yapmaz

Sınırlar tasarımın parçasıdır. Ajan olayı çözmez, onaylamaz, yeniden atamaz ve yükseltmez: verilen PagerDuty erişimi okuma ve not eklemeyle sınırlıdır. Hiçbir şeyi merge etmez, kod göndermez, dal ya da pull request oluşturmaz; altyapınıza veya üretime erişimi yoktur. Bu araçlar ona verilmemiştir: bu, bir talimatta verilen bir söz değil, eksik bir yetenektir.

Ajan bir hipotezi asla olgu gibi sunmaz. "Olası neden" yazar, güvenini ve kanıtlarını belirtir, hiçbir şey bulamadığında bunu açıkça söyler. Bir günlükte ya da dosyada karşılaştığı sırları, token'ları veya kişisel verileri kopyalamaz: bir tane olduğunu ve nerede olduğunu söyler. Uyarı metinlerini, günlük satırlarını, commit mesajlarını ve kodu analiz edilecek veri olarak ele alır, asla talimat olarak değil. Karar ve eylem insanda kalır; insan doğrulamalı bir tasarımın ilkesi budur.

Atako'da nasıl kurulur

Bu kullanım senaryosunun sayfasından dağıtım dört adımda yapılır.

1. PagerDuty ve GitHub'ı bağlayın. Tercihen salt okunur ve not ekleme hakkı olan bir PagerDuty API anahtarı ile hizmetin deposuyla sınırlı, ince ayarlı bir GitHub token'ı oluşturun. Bağlantılar, herhangi bir şey oluşturulmadan önce doğrulanır.
2. Bağlamınızı girin. Depoyu sahip/ad biçiminde, izlenecek PagerDuty hizmetinin adını ve isterseniz kısa bir teknik bağlamı yazın: yığın, bileşenler, bilinen kırılgan alanlar. Ne kadar kesinse ajan o kadar hızlı doğru yere bakar.
3. Dağıtın. Tek bir eylem ajanı ve "Nöbet" projesini oluşturur. Ajan hazırlanır ve ilk talimatını kendiliğinden alır.
4. İlk sonuç, ardından düzenli izleme. Ajan hizmeti bulur, nöbetçinin kim olduğunu söyler, en son olayı işler ve olası nedeni ile önerilen düzeltmeyi sohbette özetler. Sonra on beş dakikalık izlemesini ve pazartesi değerlendirmesini kendisi planlar.

Henüz hesabınız yoksa, hesap oluşturmak deneme sürenizi başlatır ve senaryo hemen ardından kurulur. Yöneticiniz ajan oluşturmanıza izin vermediyse, dağıtım bunu size söyler ve orada durur.

Sonuçları nerede görürsünüz

Analiz notu PagerDuty'de olay üzerinde, önerilen düzeltmeyi içeren issue ise GitHub'da depoda okunur. Ele alınan her olayın özeti ajanın sohbetinde okunur. Atako'daki "Nöbet" projesinde nasıl çalıştığını anlatan sayfayı ve haftalık değerlendirmeyi bulursunuz; Atako floor'unda ajan güncel etkinliğiyle görünür.

Çalışmasını inceltmek için sohbetinde ona yazın, örneğin "bu hizmette önce veritabanı migrasyonlarına bak". Talimatı sonraki olaylar için belleğinde tutar.

Güvenceler

Erişim bilerek dardır. PagerDuty bağlantısı okumak ve not eklemek için yedi araçlık bir listeyle, GitHub bağlantısı commit'leri, dosyaları ve pull request'leri okumak ile issue aramak ve oluşturmak için yedi araçla verilir. Kısa bir araç listesi gören ajan, yüzlerce araçlık bir katalogda kaybolan ajandan daha güvenilir çalışır ve en önemlisi, bir uyarı metni zorlamaya çalışsa bile verilmeyen şey gerçekleşemez.

Oluşturduğunuz anahtarlar ilk güvencenizdir: tek bir hizmet, tek bir depo ve kesin haklarla sınırlı olduklarından, ne olursa olsun olası zararı sınırlarlar. Şifreli saklanırlar ve bunları istediğiniz zaman iptal edebilir veya ajanın erişimini kaldırabilirsiniz.

İnsan doğrulaması karar noktalarındadır. Nöbetçi kişi notu okur, hipotezi doğrular, düzeltmeye karar verir, onu kendisi yazar ve merge eder, ardından olayı onaylar ve çözer.

Beklentiniz ne olmalı

Dakikalar içinde yararlı bir ilk analiz bekleyin; özellikle olayın nedeni son değişikliklerde görünüyorsa: bir dağıtım, bir yapılandırma değişikliği, bir bağımlılık. Neden deponun dışındaysa, örneğin bir sağlayıcı kesintisi ya da kaynak doygunluğu, ajan bir açıklamayı zorlamak yerine bunu düşük güvenle söyler. Depoyu okur ama uyarı ve notların aktardığı dışında uygulama günlüklerinize veya metriklerinize erişimi yoktur. Değeri ilk okumanın hızından gelir: nöbetçi kişi olaya boş bir sayfayla değil, bir zaman çizelgesi, sıralanmış ipuçları ve incelenecek bir düzeltmeyle gelir.