Kimse yeni bir takım arkadaşına özgeçmişi yüzünden güvenmez. Güven yapıdan gelir: sınırları belirlenmiş bir sorumluluk, ekibin görebileceği bir yerde yürütülen iş ve hiçbir şey yayına çıkmadan önce yapılan inceleme. Bunlardan herhangi birini ortadan kaldırın, dâhi bir meslektaş bile yük hâline gelir. Aynısı takım arkadaşı olarak yapay zekâ ajanları için de geçerli. Soru asla "model yeterince akıllı mı" değildir. Soru şudur: "Bu şeyin neye dokunmasına izin verildiğini biliyor muyum, ne yaptığını görebiliyor muyum ve bir insan 'evet' demeden herhangi bir şey yayına çıkıyor mu?"
Sharkly bu soruya vaatlerle değil, yapılandırmayla yanıt verir. Sharkly'de bir Ajan, tek seferlik bir istem değil, kaydedilmiş bir çalışma yapılandırmasıdır: talimatları, Runtime'ı, Skill'leri, depoları, ortamı ve çalıştırma ayarları işi nasıl ele aldığını şekillendirir. Bir istem, terminal kapandığında kaybolur. Bir yapılandırma ise incelenebilir, paylaşılabilir ve her çalıştırmada sabit kalır.
Önce platforma genel bir bakış istiyorsanız, Sharkly nedir yazısıyla başlayıp geri dönün.
Kısaca
Sharkly'de bir Ajan, bir yapay zekâ aktörü için kaydedilmiş, yeniden kullanılabilir bir çalışma yapılandırmasıdır: çalışma talimatları, bir Computer ve Runtime bağlantısı, eklenmiş Skill'ler, Git depoları, ortam değişkenleri ve eşzamanlılık, zaman aşımları ve çalışma dizini modu gibi çalıştırma ayarları. Ona bir takım arkadaşına güvendiğiniz gibi güvenirsiniz; inançla değil, yapıyla: kapsamı yapılandırmada açıkça belirtilmiştir, yürütme durumları ve iz kaydı görülebilir ve sonuçları bir kişinin inceleyip kabul ettiği Task'a döner. Ajanlar araştırır, yürütür, test eder ve raporlar. Yönü insanlar belirler, yetkiyi insanlar verir ve sonucu insanlar kabul eder.
Bir Ajan nedir (ve ne değildir)
Bir Ajan, Sharkly'de işi ele almak üzere yapılandırılmış bir yapay zekâ aktörüdür. Kendisine atanan Task'ları alabilir, yorum yazabilir, mevcut iş akışı üzerinden Task durumunu güncelleyebilir ve bir yürütme izi üretebilir. Yapılandırma kaydedildiği için bir ekip; kod değişiklikleri, inceleme, test, dokümantasyon veya operasyonel triyaj için ayrı Ajanlar barındırabilir ve her Task için aynı talimatları yeniden yazmak zorunda kalmaz.
Baştan iki sınır önemli.
Bir Ajan, yürütme ana makinesi değildir. İşi, bağlı bir Computer üzerinde seçilen bir Runtime aracılığıyla çalışır. Ajan işin nasıl ele alınacağını tanımlar; Computer ana makineyi sağlar; Runtime asıl oturumu yürütür; Task ise paylaşılan kayıt olarak kalır. Her rolün tek bir işi vardır; bu yüzden tek bir Computer birden fazla Ajana hizmet edebilir.
Bir Ajan kendi modelini seçmez. Runtime'ın varsayılan modelini izler; Ajan üzerinde model seçici veya düşünme derinliği kontrolü yoktur. Farklı bir model kullanmak için Runtime veya Computer araç yapılandırmasında, örneğin Claude Code veya Codex içinde değiştirin.
Güven modelin değil, sistemin bir özelliğidir
Bu yazının dayandığı argüman şu: bir ajan, işi kapsamlandırılmış, görünür ve incelenebilir olduğunda güvenilirdir. Model etkileyici olduğunda değil.
Kapsamlandırılmış olması, Ajan'ın yetkisinin çalışmadan önce yazıya dökülmüş olması demektir: hangi depolara dokunabileceği, hangi Computer üzerinde yürüteceği, talimatlarının neye izin verdiği, aynı anda kaç Task çalıştırabileceği ve bir çalıştırmanın ne kadar sürebileceği. Görünür olması, çalıştırma durumlarının, iz olaylarının ve sonuçların özel bir terminalde kaybolmak yerine herkesin inceleyebileceği Task'a dönmesi demektir. İncelenebilir olması ise döngünün sonunda bir kişinin oturması demektir: bir Ajan, bir Task'ı insan yanıtı bekliyor veya insan incelemesi bekliyor durumunda bırakabilir ve bu sinyaller sorumlu kişinin Gelen Kutusu'na düşer.
İşte pratikte insan-ajan sözleşmesi budur. Otomasyon, ekip muhakemesinin gerektiği yerde durur. Hâlâ iş akışının kendisini tartıyorsanız, ajan tabanlı kodlama üzerine yazımız istem yazmaktan iş atamaya geçişi ele alıyor.
Ajan yapılandırma yüzeyi
Bir Ajan; ad, açıklama, avatar ve sahip; çalışma talimatları; görünürlük ve Space yerleşimi; bir Computer bağlantısı ve Runtime sağlayıcısı; atanmış Skill'ler; Ajana özel Git depoları; düz ve gizli ortam değişkenleri; ek Runtime argümanları; Task Çalışma Dizini ayarları; ayrıca paralel çalışan Task'lar için bir üst sınır ve Task başına zaman aşımı içerebilir. Her parça bir güven koludur.
Talimatlar her çalıştırmaya dâhil edilir. Bunları her Task'ta geçerli olması gereken davranışlar için kullanın: kapsam ve rol, harekete geçmeden önce bir Task'ın nasıl inceleneceği, ne zaman insan girdisi isteneceği, beklenen kontroller ve raporlama biçimi. Dokümanlar yararlı bir üçlü ayrım çizer: Task'a özgü gereksinimler Task açıklamasına veya yorumlara, birkaç Ajanın paylaşabileceği yeniden kullanılabilir bir prosedür bir Skill'e, Ajanın kendi talimatları ise onun istikrarlı kimliğine aittir. "Düzenlemeden önce Task açıklamasını ve son yorumları oku. Değişiklikleri istenen davranışla sınırlı tut. En yakın ilgili kontrolleri çalıştır ve hataları gizlemeden bildir" ifadesi Ajan'da yer almalıdır, çünkü pazartesi de doğru olmalı, martta da doğru kalmalıdır. Açıklama farklı bir okuyucuya hitap eder: insanlara neyi atayacaklarını söyler; talimatlar ise Ajan'a nasıl çalışacağını söyler.
Görünürlük ya Personal'dır, yani yalnızca mevcut sahibinin kullanımına açıktır, ya da Space'tir, yani Ajan'ın Space'ine erişebilen kişilerin kullanımına açıktır. Ayrıca Ajan'ı kimin atayabileceğini, onunla Agent Chat başlatabileceğini veya bir yorum ya da bahsetme yoluyla tetikleyebileceğini de kontrol eder. Ayarlama yaparken Personal olarak başlayın; yapılandırma paylaşmaya değer hâle geldiğinde Space'e taşıyın. Bu terfi anı, bir geliştiricinin çalışma pratiğinin ekip altyapısına dönüştüğü andır.
Computer ve Runtime birleşerek yürütme hedefini oluşturur. Bir Computer'ın çevrimiçi olması yalnızca yerel servisinin kalp atışı gönderdiği anlamına gelir; seçilen Runtime'ın bir Task'ı yürütebileceği anlamına gelmez. Computer çevrimdışıysa, yeni çalıştırmalar normalde yeniden bağlanmasını bekler; seçilen Runtime ortadan kalktıysa başka bir uygun olanı seçin. Kurulumun tüm hikâyesi Sharkly'de Computer'lar yazısında.
Skill'ler yeniden kullanılabilir talimatları ve destekleyici dosyaları paketler: inceleme kuralları, teslimat kontrol listeleri, bir ekip süreci. Yerel Runtime Skill'leri o Computer üzerinde otomatik olarak kullanılabilir kalır; paylaşılan Space Skill'leri açıkça atanmalıdır. Tekrarlamaya değer bir uyarı: çakışan talimatlar yürütmeyi daha az öngörülebilir kıldığı için çok sayıda örtüşen Skill bağlamaktan kaçının. Derinlemesine inceleme için Sharkly'de Skill'ler yazısına bakın.
Depolar elinizdeki en temiz kapsam belirleme koludur. Ajan'ın Space varsayılanından daha dar bir kod kapsamına ihtiyacı olduğunda bunları Ajana ekleyin; hiç bağlama yoksa Sharkly, Task'ın Space'i için yapılandırılmış depolara geri döner. Dokümantasyon deposuna bağlanmış bir dokümantasyon Ajanının ödeme servisinize giden hiçbir yolu yoktur.
Ortam ve çalıştırma ayarları bir çalıştırmanın neleri tüketebileceğini sınırlar. Düz ve gizli ortam değişkenleri ile ek Runtime argümanları, kimsenin bir Task'a kimlik bilgisi yapıştırmasına gerek kalmadan bir çalıştırmanın yapılandırma taşımasını sağlar. Depo token'larını, özel anahtarları veya kurulum token'larını asla bir Task açıklamasına, yorumuna, Ajan talimatına ya da Skill'e koymayın. Task Çalıştırma Ayarları paralel Task'ları, azami çalıştırma süresini ve çalışma dizini modunu kontrol eder:
| Geçici mod | Belirtilen mod | |
|---|---|---|
| Bir çalıştırmanın elde ettikleri | Task başına yalıtılmış bir dizin; depo destekli çalıştırmalar taze bir worktree hazırlayabilir | Ajan'ın dizin havuzundan yapılandırılmış tek bir mutlak yerel dizin |
| Eşzamanlılık | Daha güvenli paralel yürütme; varsayılan, Computer limitinin %50'sidir | Aynı anda dizin başına bir çalıştırma; varsayılan, dizin sayısıyla eşleşir |
| Kullanılabilirlik | Bağlı herhangi bir Computer | Yalnızca yerel Computer'lar |
| En uygun olduğu durumlar | Çoğu depo işi ve birkaç Task'ın aynı kod tabanını paralel olarak değiştirebileceği her durum | Çok büyük depolar, pahalı yerel önbellekler veya yerel servislere bağlı Task'lar |
Manuel eşzamanlılık değerini dizin sayısından yüksek ayarlarsanız ürün, yazmaların çakışabileceği uyarısını verir. Yalıtım mekaniği, Sharkly'nin Ajanları birleştirme çakışması olmadan nasıl paralel çalıştırdığı yazısının konusudur.
Konuşmalar ve Task'lar: iki yüzey, tek kural
Agent Chat; bir soru sormak, bir konuyu araştırmak veya henüz takip edilen bir Task'a ihtiyaç duyulmadan önce bir plan şekillendirmek için kullanılan bağımsız bir konuşmadır. Chat üç modu destekler: yalnızca okuma amaçlı araştırma için Explore, Sharkly planlanan task ve alt görevleri oluşturmadan önce inceleyip onayladığınız öneriler için Plan ve Ajan'ın yapılandırılmış CLI'ı üzerinden doğrudan eylem için Execute. Her oturum onu oluşturan kişiye aittir.
Bir Task ise işin sahiplik, durum, yürütme geçmişi veya inceleme gerektirdiği yerdir. Karar ikilisi şudur: iş takip edilen bir Task'a ihtiyaç duymadan önce keşfetmek, planlamak veya harekete geçmek için Chat'i kullanın; iş bir Atanan, durum, kabul kriterleri veya kalıcı bir kayıt gerektirdiğinde Task'ı kullanın.
Ekiplerin bağlamı kaybetmesini tek bir sınır engeller. Agent Chat'te bir mesaj göndermek bir task yorumu oluşturmaz ve bir task'ın Agent chat'indeki mesajlar Activity'de yorum olarak görünmez. Ekibin bir sonucu görmesi gerekiyorsa, onu task açıklamasına veya bir yoruma kopyalayın. Güven paylaşılan kayda bağlıdır ve paylaşılan kayıt Task'tır.
Durum state'leri size ne anlatır
Buradaki görünürlük, bir gösterge paneli sloganı değil, okuyabileceğiniz belirli bir durumlar kümesidir.
Bir Task çalıştırması queued, dispatched, waiting for local directory, running, completed, failed ve canceled aşamalarından geçer. Çalıştırma durumları, Task'ın iş akışı durumundan ayrıdır: bir çalıştırma başarısız olurken Task başka bir deneme için açık kalabilir. Yürütme günlüğü bir çalıştırmanın neden kuyruğa alındığını, ne zaman başlayıp bittiğini, araç çağrılarını ve Runtime olaylarını, tetikleme kaynağını ve hata ayrıntılarını kaydeder.
Ajan kullanılabilirliği üçüncü ve ayrı bir sinyaldir. Çevrimiçi bir Ajanın eşzamanlılık veya dizin kapasitesi dolduğu için yine de kuyruğa alınmış işi olabilir. Backlog ise bir park alanı işlevi görür: bir Ajana atanmış bir Task, Backlog'da olduğu sürece bekler ve onu işe hazır bir duruma taşımak çalıştırmayı başlatan şeydir. Bir Ajan atamak hiçbir zaman beklenmedik şekilde iş başlatmaz.
İlk Ajanınız: güvenebileceğiniz bir adım adım kılavuz
Güven inşa etmenin en hızlı yolu, Sharkly dokümanlarındaki en küçük faydalı döngüdür: bir Computer bağlayın, bir Ajan oluşturun ve düşük riskli bir Task atayın.
- Bir Computer bağlayın. Settings'i, ardından Computers'ı açın ve Connect Computer'ı seçin. En az bir kullanılabilir Runtime ile bağlı görünene kadar bekleyin.
- Ajanı dar bir rolle oluşturun. Ad: Code Reader. Açıklama: bir depoyu okur, mevcut uygulamayı açıklar ve dosyaları değiştirmeden riskleri bildirir. Görünürlük: Personal.
- Kapsamı zorunlu kılan talimatlar yazın: "Harekete geçmeden önce Task'ın tamamını ve ilgili yorumları oku. Kapsamı istekle sınırlı tut. İlk Task için dosyaları düzenleme. Neyi incelediğini, her sonucun kanıtını ve belirsiz kalan her şeyi bildir."
- Kodu bağlayın. Bir Git deposu ekleyin veya onu zaten içeren belirtilmiş bir yerel dizin yapılandırın. Skill'ler bekleyebilir.
- Küçük, yalnızca metinden oluşan bir Task oluşturun: kimlik doğrulama hata yolunu incele, kullanıcıya görünen üç hata durumunu belirle, her biri için ilgili dosyayı belirt, hiçbir şeyi değiştirme.
- Backlog yerine işe hazır bir durum kullanarak atayın ve başlatın. Çalıştırma durumunun queued'dan running'e geçişini izleyin, ardından sonucu Task üzerinde okuyun.
- Gerçekten inceliyormuş gibi inceleyin. Ajanın amaçlanan kodu inceleyip incelemediğini, düzenleme yapmama sınırı içinde kalıp kalmadığını, kanıt sunup sunmadığını ve tahmin etmek yerine belirsizliği kaydedip kaydetmediğini kontrol edin.
İşte son adım bütün meselenin kendisi. Yalnızca okuma amaçlı bir ilk Task, Ajanın herhangi bir yetkiye sahip olmadan önce yetkiyi kazanmasını sağlar. Döngü çalışmaya başladığında kapsamı bilinçli olarak genişletin. Atama mekaniğinin tamamı ilk Task'ınızı bir yapay zekâ kodlama Ajanına nasıl atarsınız yazısında.
Ve bir Ajan bu güveni kazanmayı bırakırsa, geri alma temizdir. Arşivleme onu atamalardan ve bahsetmelerden kaldırır ve çalışan işini iptal eder; önceki Task'ları, yorumları ve çalıştırma geçmişi ise erişilebilir kalır. İşinin kaydını kaybetmeden çıkışını yapabildiğiniz bir takım arkadaşı, işe almayı göze alabileceğiniz bir takım arkadaşıdır.
SSS
Sharkly'de bir Ajan tam olarak nedir?
Bir Ajan, Sharkly'de işi ele almak üzere yapılandırılmış bir yapay zekâ aktörüdür: talimatlar, bir Computer ve Runtime bağlantısı, Skill'ler, depolar, ortam değişkenleri ve çalıştırma ayarlarından oluşan kaydedilmiş bir yapılandırma. Kendisine atanan Task'ları alabilir, yorum yazabilir, Task durumunu güncelleyebilir ve bir yürütme izi üretebilir. Yapılandırma kaydedildiği için Ajan bir Space'e paylaşıldığında bir kişinin çalışma pratiği yeniden kullanılabilir hâle gelir.
Bir Sharkly Ajanı hangi modeli kullanır?
Ajan, seçili Runtime'ının (örneğin Claude Code veya Codex) varsayılan modelini izler ve belirli bir model adı göstermez veya vaat etmez. Ajan üzerinde model seçici ya da düşünme derinliği kontrolü yoktur. Modelleri değiştirmek için Runtime veya Computer araç yapılandırmasını güncelleyin.
Bir Ajanla sohbet etmek ile ona bir Task atamak arasındaki fark nedir?
Agent Chat; iş takip edilen bir kayda ihtiyaç duymadan önce keşfetmek, planlamak veya harekete geçmek için kullanılan bağımsız bir konuşmadır. Bir Task ise Atanan, durum, yürütme geçmişi ve inceleme içeren paylaşılan iş birimidir. Chat mesajları task yorumuna dönüşmez, dolayısıyla ekibin görmesi gereken sonuçlar Task'ta yer almalıdır.
Bir Ajanın neler yapabileceğini nasıl sınırlarım?
Kapsam yapılandırmada belirlenir: talimatlar rolü ve dikkat kurallarını tanımlar, depo bağlamaları Ajanın hangi kodu gördüğünü sınırlar ve Task Çalıştırma Ayarları paralel Task'ları ve çalıştırma süresini sınırlar. Geçici çalışma dizini modu, her Task'a kendi dizinini vererek yalıtım ekler. Nihai kabul yine de bir kişiye aittir.
Atadığım Task neden başlamıyor?
Üç şeyi kontrol edin. Backlog'daki bir Task tasarım gereği bekler; onu işe hazır bir duruma taşıyın. Bir Computer'ın çevrimiçi olması yalnızca kalp atışlarının geldiği anlamına gelir, bu yüzden seçili Runtime'ın kullanılabilir göründüğünü doğrulayın. Ayrıca çevrimiçi bir Ajan, eşzamanlılığı veya belirtilen dizinleri dolduğunda yine de işi kuyruğa alabilir.
