Kogei
NASIL ÇALIŞIR

Her sayının arkasındaki mekanizma.

Mimariyi değerlendiren kişiler için bir referans: bir ajanı oluşturduğunuz katalog, birbirine bağladığınız üç düğüm tipi, bir kompozisyonu geçerli tutan tip sistemi, ve onu çalıştıran motor, zamanlayıcı ve hesaplama katmanı.

Üç düğüm tipi, bir grafik.

Deterministik adım

Hesaplar.

Sayı üretebilir. Golden test edilir: aynı girdi, aynı çıktı.

Ajan

Kendi adımlarına karar verir ve araç kullanır.

Sayı üretemez. Bütçelidir. İzlenir.

Workflow çağrısı

Yayınlanmış, imzalı bir boruyu çalıştırır.

Kim çağırırsa çağırsın deterministik çalışır ve kendi garantisini taşır.

Her biri diğerini kendi içinde barındırabilir.

Ajan → workflow. İmzalı, test edilmiş bir workflow ajanın alet çantasında durur. Ajan onu ne zaman çalıştıracağına karar verir; workflow yine de deterministik çalışır. Ajanın özgürlüğü ham SQL ile değil, onaylanmış yeteneklerle sınırlıdır — güvenlik ekibiniz workflow listesini bir kez onaylar, ajanlar sonra serbestçe birleşir.

Workflow → ajan. Deterministik bir borudaki bir adım “bunu bir ajana çözdür” diyebilir: ajan araçlarını kullanır, gerektiği kadar döngü kurar ve tipli bir sonuçla döner.

Adım kataloğu.

Topla

  • Veritabanı sorgusu
  • Dosya / klasör
  • Posta kutusu (salt okunur)
  • Memex bilgi tabanı
  • Önceki çalışmanın çıktısı
  • HTTP APIkutudan çıkar
  • Web aramasıkutudan çıkar
  • Web sayfası getirkutudan çıkar

Dönüştür (deterministik)

  • İki kümeyi karşılaştır
  • Koşula göre filtrele
  • Grupla ve topla
  • Eşik kontrolü
  • Birleştir / zenginleştir
  • Önceki döneme karşı eğilim

Yorumla (yerel model)

  • Özetle
  • Farkları açıkla
  • Riskleri işaretle
  • Sınıflandır
  • Belgeden alan çıkar

Teslim et

  • Rapor
  • Bildirim

Bu katalogdan seçersiniz — kod yazmazsınız. Dönüştürme adımları da katalog öğesidir ve her biri deterministiktir: bir rapordaki sayılar yine de koddan gelir, asla modelden.

İki tip: table ve text.

Katalogdaki her adım neyi kabul ettiğini ve neyi ürettiğini bildirir — bir karşılaştırma adımı table → table alabilir, bir özetleme adımı table → text alabilir — ve düzenleyici, uyumsuz bir bağlantıyı doğrudan reddeder. Adımları hiçbir zaman bozuk bir ajan üretmeden serbestçe birbirine bağlamanızı sağlayan tek mekanizma budur.

Şablonlar başlangıç grafiğidir, sabit bir grafik değil.

Bir şablon, satıcıdan başlangıç grafiği olarak gelir. Onu düzenlediğiniz an ajan çatallanmış sayılır ve bu işareti arayüzde göründüğü her yerde taşır. Sessiz bir kayma yoktur — ama düzenlemeye başladığınız andan sonra kayma varsayılan yoldur.

Düzenlendi — artık şablonu takip etmiyor.

Çalışma motoru.

Tek giriş noktası.

Çalışma isteğini alır, şablonun adım grafiğinde ilerler ve çalışırken her adımın girdisini, çıktısını ve durumunu yazar.

Tek düğüm, sınırlı eşzamanlılık.

Bir çalışma motoru, bir kutu. Eşzamanlılık sınırlıdır, bir küme üzerine dağıtılmaz.

Nasılını devreder.

Motor bir adımın ne yaptığını bilmez — bunu, her sürücüye, dönüştürmeye ve teslim kanalına sahip katman olan Step Kit’ten çözer.

Zamanlayıcı: tek giriş noktası, ve bugün garanti ettiği şey.

Tek giriş noktası.

Zamanlanmış bir çalışma ile elle tetiklenen bir çalışma tam olarak aynı kaydı yazar. Girişin bir yolu vardır, oradan tek bir kod yolu.

catch_up politikası.

Bir çalışma zamanı geldiğinde kutu kapalıysa, her ajan sıradaki adımı kendisi bildirir: atla — varsayılan olan — ya da kutu geri geldiğinde bir kez çalıştır.

Çakışma koruması.

Bir ajanın önceki çalışması hâlâ sürüyorsa, yeni çalışma hemen skipped_overlap olarak kapanır. Birincinin üzerine asla ikinci bir çalışma başlatmaz.

Sessizlik alarmı.

Beklenen çalışma takvimi aktif olarak izlenir. Üretilmesi gerekip üretilmeyen bir rapor, kendisi bir alarm olayıdır — sessizlik, hiçbir şey olmamış gibi değil, bir arıza olarak ele alınır.

Üretimde kullanım, zamanlayıcının henüz yapmadığı beş şeyi ortaya çıkarır: ajanlar arasında bağımlılıklar (B çalışması yalnızca A başarılı olduktan sonra), canlı raporlara karıştırmadan geçmiş bir dönemi geriye doldurma, bir çalışmayı atlamak yerine geciktiren bir bakım penceresi, kimse onaylamadığında sıralı bir kişi listesi üzerinden yükselen bir alarm eskalasyonu, ve belirli çalışmaları saklama süresinin silinmesinden muaf tutan bir yasal tutma. Bunların hiçbiri henüz inşa edilmedi.

Bir kutunun ötesinde: hesaplama filosu.

Bir site nadiren tek bir kutudur. Diğer Spark kümeleri, GPU sunucuları, vLLM, TGI, Ollama veya NIM arkasında m modele hizmet veren n makine — Kogei işi bunların herhangi birine gönderebilir. Keşif katmanlıdır, en güvenilir önce gelir: bir makineyi adresle eklemek her zaman işe yarar ve regüle müşterilerin çoğunun seçtiği yol budur; Kubernetes veya Consul üzerinden keşif sıradadır; bir alt ağ taraması en sonda gelir ve yalnızca bir yöneticinin verdiği bir aralığa karşı çalışır, denetim izine kaydedilen dar, hız sınırlı bir port listesiyle — bir bankanın ağında habersiz bir port taraması, güvenlik ekibinin izlemesini tam olarak bunu yakalamak için kurduğu şeydir. Birden fazla makine eklendiğinde üç şey değişir: bir ajan adımı belirli bir model değil, bir model sınıfı ister; her makine bir ajanın geçemeyeceği bir güven bölgesi etiketi taşır; ve çalışma kaydı artık işi hangi makinenin yaptığını belirtir.

Anlat, grafiği o kursun.

Finans, operasyon veya satıştaki çoğu kişi akış şeması çizmez. Kanvas hâlâ var, ama tek giriş yolu değil: ihtiyacınızı kendi kelimelerinizle anlatabilirsiniz, yerel bir model grafiği taslaklar. Buradaki risk farklıdır — yanlış bir grafik, bir raporda bir sayı göndermeden önce değil, kaydedilmeden önce bir kişi tarafından yakalanır, ve model kanvasın da kabul etmeyeceği hiçbir şey üretemez: aynı katalogdan tipli düğümler ve kenarlar üretir, dolayısıyla geçersiz bir grafik üretilemez. Grafiği gerçekten değiştiren şeyleri sorar — hangi kaynak, hangi eşik, kim görecek, bir araştırma adımı eklenip eklenmeyeceği — ve gerisini varsayar, varsaydığını gizlemek yerine gösterir. Bağlı olmayan bir kaynağı icat etmez; bağlamadığınız bir sistemden bahsederseniz, bunu söyler ve bir yer tutucu eklemek mi yoksa önce onu bağlamak mı istediğinizi sorar.