İş emri açma ajanının araç yetkileri

Bağlam ve kısıtlar#

Bakım planlama masası bir metin işleme masasıdır: gelen talebi okur, hangi ekipmandan bahsedildiğini çıkarır, aciliyetini üretim planına göre değerlendirir ve bir kayıt açar. İşin doğası ajana uygun görünüyordu. Sorun, kaydın açıldığı sistemin aynı zamanda bakım bütçesini, parça hareketlerini ve teknisyen atamalarını taşıyan sistem olmasıydı.

Asıl kısıt girdinin kaynağıydı. Taleplerin bir bölümü kurum dışından geliyordu: tedarikçi yazışmaları, servis raporları, ekli belgeler. Bu metinler güvenilmeyen içerik sınıfındadır ve ajanın araç kümesi ne kadar geniş olursa, o metnin dolaylı olarak elde ettiği yetki de o kadar geniş olur. Tasarımın çıkış noktası bu denklem oldu.

Veri ve erişim#

Erişim iki yönde ayrıldı: ajanın okuyabildiği şeyler ile yazabildiği şeyler aynı kümede değil. Okuma tarafı geniş, çünkü doğru ekipmanı eşlemek için varlık hiyerarşisini ve geçmiş iş emirlerini görmesi gerekiyor. Yazma tarafı ise tek bir işleme indirildi. Bu asimetri bilinçli: okuma hatası bir öneri hatasıdır, yazma hatası bir kayıt hatasıdır.

• Gelen talep kanalları: çağrı sistemi, e-posta, yazışma ve elle girilen notlar; hepsi güvenilmeyen içerik olarak etiketli
• Varlık hiyerarşisi ve ekipman kimlikleri: yalnızca okuma, eşleme için kanonik kaynak
• Geçmiş iş emirleri: yalnızca okuma, mükerrerlik kontrolü ve benzer talep tespiti için
• Yedek parça stok durumu: yalnızca sorgu; rezerv ve sipariş araçları ajana hiç tanımlanmadı
• Taslak iş emri oluşturma: ajanın tek yazma yetkisi, dar sözleşmeli ve alan kümesi sabit
• Araç çağrısı günlüğü: değiştirilemez, kaynak belge kimliğiyle birlikte saklanıyor

Mimari kararlar#

Ajan güvenliğinde kararların çoğu modelin davranışını iyileştirmekle değil, yanlış davrandığında yapabileceği en kötü şeyi küçültmekle ilgili. Aşağıdaki tablo bu küçültmenin nerelerden geçtiğini kaydeder.

Güvenlik ve yetki#

Ölçüm düzeni#

• Düzeltme türü dağılımı: ekipman eşlemesi yanlış, öncelik yanlış, mükerrer veya talep yanlış anlaşılmış
• Yetki reddi sayısı: ajanın tanımsız bir araca ya da sözleşme dışı alana ulaşma denemeleri ayrı izleniyor
• Kırmızı takım kapısı: bilinen enjeksiyon desenlerinden oluşan set her sürümde yeniden koşuyor ve geçmeden yayım yapılmıyor
• Bütçe aşımı olayları: oturum başına çağrı sınırına dayanan ajan oturumları kayda geçiyor
• Mükerrer taslak tespiti: aynı ekipmana kısa aralıkta açılan taslaklar işaretlenip planlamacıya birlikte gösteriliyor
• Günlük incelemesi: araç çağrısı günlüğünün bir örneklemi haftalık olarak kaynak belgeyle birlikte okunuyor

Devreye alma ve işletme#

1. 1Yalnızca okuma modu

   Ajan hiçbir şey yazmadı; talebi okuyup ekipman eşlemesi ve öncelik önerisini panelde gösterdi.

2. 2Kırmızı takım seti

   Gelen kanallardan toplanan gerçek metinler ve bilinen enjeksiyon desenleriyle bir sürüm kapısı kuruldu.

3. 3Taslak yazma

   Tek yazma aracı açıldı; her taslak zorunlu onaydan geçti ve onaylanmayanlar ayrı kuyrukta tutuldu.

4. 4Günlük denetimi

   Araç çağrısı günlüğü düzenli incelemeye alındı; ilk gerçek enjeksiyon denemesi bu incelemede görüldü.

Nerede yanıldık#

Tehlikeyi yanlış yerde aradık. Silme ve sipariş gibi gürültülü işlemleri baştan kapatmıştık, ama ajanın var olan bir taslağı güncelleme yetkisi duruyordu ve bunu zararsız saymıştık. Gelen bir yazışmanın içindeki talimat benzeri metin, mevcut bir taslağın açıklamasını değiştirdi; kayıt hâlâ oradaydı, alanlar değişmişti, kimse bir şey fark etmedi. Bu olaydan sonra güncelleme yetkisini tamamen kaldırdık ve daha önemlisi, araç seçimini istemden alıp kod tarafındaki durum makinesine taşıdık. İstem içinde kurduğumuz talimat ve veri ayrımının, yetki tasarımının yerini tutmadığını böyle öğrendik.