Ajanlara salt okumayla başlayın, erişimi bilerek genişletin

Yeni bir ajanla geçen ilk hafta, onun verileriniz, araçlarınız ve ekibinizin alışkanlıkları üzerinde nasıl davrandığını en az bildiğiniz dönemdir. Pek çok ekibin ona en geniş erişimi verdiği dönem de budur; çünkü kurulum böyle daha kolaydır ve henüz hiçbir şey ters gitmemiştir. Bunu tersine çevirin. Yeni ajan erişimini işe yarar en dar biçimiyle, ki bu çoğunlukla okumaktır, başlatın ve her biri bir önceki adımda gördüklerinize dayanan, sizin seçtiğiniz adımlarla genişletin.

Salt okumayla başlamak size ne kazandırır

Salt okuma yetkisiyle çalışan bir ajan, değerli işin çoğunu yine de yapabilir: araştırma, özet, karşılaştırma, bilgi çıkarma, taslak. Değişen, hatalarının bedelidir. Yanlış bir özet incelemede yakalanır; yanlış bir yazma işlemini ise bir müşteri yakalayabilir. Salt okuma size başka hiçbir yolla elde edemeyeceğiniz bir şey de verir: ajanın ne yapacak olduğunun kaydı. Taslakları, önerdiği değişiklikler ve yerine getiremediği istekler, muhakemesini o muhakeme herhangi bir şeye dokunmadan önce gösterir.

Güven tartışmasını da kısaltır. Ajanın CRM'e yazmaya hazır olup olmadığını tartışmak yerine, CRM için hazırladığı bir dizi taslağa bakar ve kanıta dayanarak karar verirsiniz.

Salt okuma, göründüğünden dardır

“Salt okuma” güvenebileceğiniz bir etiket değil, kontrol etmeniz gereken bir özelliktir. Sızdırdığı birkaç yer:

• Yan etkili okumalar. Bazı API'ler yalnızca veri çektiğinizde bile bir mesajı okundu olarak işaretler, ücretli bir sorgu başlatır ya da bir erişim kaydı düşer. Her okuma uç noktasının adına değil, ne yaptığına bakın.
• Okumak da veri taşıyabilir. Bir müşteri klasörünü okuyup bir özeti herhangi bir yere gönderebilen ajanın, tek bir dosya yazamasa bile bir dışa aktarma yolu vardır. Gönderme ve dışa aktarmanın ayrı eylem sınıfları olarak durmasının nedeni budur.
• Fazla okumak. Her sisteme okuma erişimi de geniş erişimdir. Tek bir projeyle ve işin gerçekten ihtiyaç duyduğu belgelerle başlayın.
• Okunan içerik talimat taşıyabilir. Bir belge ya da sayfa, ajanı yönlendirmek için yazılmış metin içerebilir. Salt okuma bu metnin ajana neler yaptırabileceğini sınırlar; oradan başlamak için bir neden daha.

Mümkün olduğunda salt okumayı ajanın talimatlarına güvenerek değil, okunan sistemin kendisinde, yalnızca görüntüleme yetkili bir rolle ya da okumaya sınırlanmış bir belirteçle uygulayın.

Kimlik bilgisi izin değildir

Erişimin kazara genişlemesinin en yaygın yolu kimlik bilgileridir. Biri, ajan takvimi okuyabilsin diye bir hesabı bağlar; verdiği belirteç etkinlik oluşturmaya da izin verir. Kurulumda yanlış bir şey yoktur, ama ajan artık yazabilir.

Ajanın neyi yapabildiğini, neyi yapmaya yetkili olduğundan ayırın. GoCux'ta verilmiş bir kimlik bilgisi tek başına gözetimsiz yazmaya yetki vermez ve bir bağlayıcının kayıtlı olması her görevin onu kullanabileceği anlamına gelmez; kimlik bilgileri tarayıcıda değil, sunucu tarafında referans olarak tutulur. Aynısı beceriler için de geçerlidir: bir kaydın nasıl güncelleneceğini anlatan yeniden kullanılabilir bir talimat, onu güncelleme izni değildir. Bağlayıcıları yetkiyi genişletmeden araç bağlamak yazısı daha ayrıntılı ele alıyor; MCP sunucuları için MCP hızlı başlangıç rehberi de aynı nedenle salt okumayla başlamayı öneriyor.

Aşamalı bir geçiş

Erişimi, her birinin net bir çıkış koşulu olan aşamalarla genişletin. Aşağıdaki aşamalar bir başlangıç noktasıdır; ekibinize uyacak şekilde yeniden adlandırın ya da birleştirin.

1. Yalnızca taslak. Ajan yalnızca kendisine verilenle çalışır ve hiç araç çağrısı yapmaz. Talimatları ve çıktı biçimini sınamak için kullanışlıdır. Taslakları yalnızca hafif düzeltme gerektirdiğinde bir sonraki aşamaya geçin.
2. Tek bir proje içinde okuma. Ajan projenin belgelerini ve işin ihtiyaç duyduğu kaynakları okur. Araştırması incelemede ayakta kaldığında ve kapsamın içinde durduğunda ilerleyin.
3. Ajan yazmayı önerir, kişi uygular. Ajan e-postayı, kayıt güncellemesini ya da değişiklik setini hazırlar; bir kişi gönderir ya da uygular. Öneriler olağan biçimde yazıldığı gibi uygulanmaya başladığında ilerleyin.
4. Kapılı yazma. Ajan yazabilir ve gönderme, dışa aktarma, silme, zamanlama gibi her sonuç doğuran eylem bir karar için durur. Kararlar olağanlaştığında ve duraklamalar tıklanıp geçilmeden okunduğunda sınıf sınıf ilerleyin.
5. Düşük riskli yazmalar için sınırlı özerklik. Olağan, geri alınabilir yazmalar iş emrinin kapsam, süre, araç çağrısı ve harcama sınırları içinde duraklamadan çalışır. Sonuç doğuran sınıflar yine durur.

Her ajanın son aşamaya ulaşması gerekmez. Pek çok faydalı ajan kalıcı olarak ikinci ya da üçüncü aşamada kalmalıdır.

Genişletmeden önce neye bakmalı

Her yükseltme, birinin değiştirdiği bir ayar değil, kayda geçmiş bir karar olmalıdır. Genişletmeden önce şunları gözden geçirin:

• Ajanın neyi okuduğu ve bunların herhangi birinin amaçladığınız kapsamın dışına çıkıp çıkmadığı.
• Neyi önerdiği ve önerilerin uygulanmadan önce ne sıklıkla değiştirildiği.
• Neyi denediği ve yapamadığı. Retler ve engellenen çağrılar, ajanın sınırlarını nerede zorladığını gösterir.
• Okuduğu bir şeyin ona talimat vermeye çalışıp çalışmadığı ve ajanın buna nasıl tepki verdiği.

Bu yanıtların yeri denetim izidir. İz bunları yanıtlayamıyorsa, herhangi bir şeyi genişletmeden önce izi düzeltin.

Yeni bir ajan için kontrol listesi

• Erişim tek bir projeyle ve okunan sistemlerde uygulanan salt okuma kapsamıyla başlar.
• Her kimlik bilgisinin yalnızca ne için verildiğine değil, gerçekte neye izin verdiğine bakılmıştır.
• Bağlayıcılar ve beceriler tüm görevler için varsayılmaz, görev başına etkinleştirilir.
• Okumak da veri taşıyabileceği için gönderme ve dışa aktarma salt okuma aşamasında bile kapılıdır.
• Her genişletme adımı, kimin karar verdiği ve hangi kanıta baktığıyla birlikte yazılıdır.
• Erişimi yeniden daraltmak, genişletmek kadar kolaydır.

Kapılı aşamaya geldiğinizde neyin durmaya devam etmesi gerektiğini yedi eylem sınıfı yazısı, GoCux'ın kimlik bilgilerini ve sınırları nasıl ele aldığını ise güvenlik sayfası anlatıyor.