Ajan araştırma yığınının katmanları: veri toplamadan onaya

Araştırma ajanı geliştiren ekipler çoğu zaman işe hangi arama API'sini kullanacaklarını sorarak başlar. Makul bir soru, ama birkaç katmandan yalnızca biriyle ilgili; katmanları bilmeden bileşen seçmek de genellikle kimsenin denetleyemediği bir yapıştırma koduyla sonuçlanır. Bir araştırma ve izleme yığını malzemeyi içeri almak, içinde doğru pasajları bulmak, pasajları yapılandırılmış değerlere dönüştürmek, soruları bir takvime göre tekrarlamak, her iddianın arkasındaki kanıtı saklamak ve sonuç doğuran bir şey olmadan önce bir insan için durmak zorundadır. Bu sayfa bu katmanları, her birinde nelere bakılacağını ve ajan araştırmayı kendi başına planlayıp yürüttüğünde nelerin değiştiğini anlatıyor.

Yığına genel bakış

Orkestrasyon döngüsü (ajanın kendisi, planlayıcısı ve araç çağrıları) bunların hepsinin üzerinden geçer. Araçlar giderek daha sık MCP üzerinden ya da komut satırı becerileri olarak sunuluyor; artıları ve eksileri MCP, beceri ya da CLI araçları yazısında ele alınıyor.

Veri toplama ve bilgi getirme

Veri toplama

Web malzemesini içeri almanın dört yaygın yolu vardır ve çoğu yığın birden fazlasını kullanır. Web arama API'si bir sorguya sıralı sonuçlar ve kısa alıntılarla yanıt verir; sayfaları getirip okumak yine size kalır. Tarayıcı (crawler) bilinen siteleri bir takvime göre dolaşır. Kazıma ya da bilgi çıkarma API'si bilinen bir sayfayı temiz metne veya alanlara dönüştürür. Başsız tarayıcı, JavaScript ya da etkileşim gerektiren sayfaları ele alır. Lisanslı veri akışları ve kendi dokümanlarınız açık webin kapsamadığı yerleri doldurur.

Hangisini seçerseniz seçin, malzeme sisteme girdiği anda adresini ve alınma zamanını kaydedin; robots kurallarına ve site koşullarına uyun. Kaynak bilgisi sonradan eklenemez. Kazıma seçenekleri arasında karar vermek için kazıma API'si rehberine bakın.

Bilgi getirme

Malzeme içeri girdikten sonra bilgi getirme katmanı önemli pasajları bulur. Tam metin arama adlar, kodlar ve birebir ifadeler için isabetlidir; anlamsal arama ise ifadeler değiştiğinde yardımcı olur. Üretimdeki sistemlerin çoğu ikisini birleştirir ve sonuçları yeniden sıralar. İki özellik herhangi bir sıralama tablosundan daha önemlidir: Getirme kapsamlı olmalıdır, yani bir projenin dokümanları asla başka bir projenin sorusunu yanıtlamamalıdır; ayrıca “hiçbir şey bulunamadı” ile “dizine ulaşılamadı” durumlarını ayırt etmelidir. Bu ikisini ayıramayan bir ajan, sistem yalnızca çökmüşken bir şeyin olmadığını kendinden emin bir şekilde raporlar.

Bilgi çıkarma ve izleme

Bilgi çıkarma, pasajları yapılandırılmış değerlere dönüştürür: bir paket sınırı, bir sicil numarası, bir bildirim tarihi. Önce şemayı tanımlayın, çıkarıcının her değeri destekleyen pasajı da döndürmesini şart koşun ve bilinmiyor yanıtını birinci sınıf bir değer olarak kabul edin. Hücredeki makul görünen bir tahmini yakalamak, boş bir hücreyi yakalamaktan daha zordur. Ölçekli şema ve doğrulama konuları yapılandırılmış bilgi çıkarma rehberinde ele alınıyor.

İzleme, bir takvime göre tekrarlanan bilgi çıkarma ya da araştırma ile bir karşılaştırmanın toplamıdır. Parçaları şunlardır: bir başlangıç anlık görüntüsü, gürültüyü ayıklayan normalleştirme, önemli değişikliğin yazılı tanımı ve bir insanın gözden geçirebileceği, her çalıştırma için ayrı bir kayıt. Bir izleyici bildirim yapmalı, harekete geçmemelidir. Tespit edilen bir değişikliğin iş başlatması gerekiyorsa önce bir inceleyiciye yönlendirin.

Kanıt deposu, en sık atlanan katmandır

Prototiplerin çoğu yalnızca nihai yanıtı ve belki bir URL listesini saklar. Sayfa değiştikten bir ay sonra bir iddiayı savunmak için bu yetmez. Kanıtı kendi başına bir kayıt olarak tutun:

{
  "claim_id":   "c-0192",
  "claim":      "Tedarikçi, Ekip paketinde tek oturum açmayı (SSO) listeliyor",
  "source":     "https://vendor.example/pricing",
  "retrieved":  "YYYY-MM-DDTHH:MM:SSZ",
  "snapshot":   "normalleştirilmiş sayfa metninin sha256 özeti",
  "quote":      "Single sign-on (Team and above)",
  "method":     "extracted",
  "status":     "supported"
}

Birkaç kural depoyu güvenilir kılar. Anlık görüntüler ve alıntılar değiştirilemez; düzeltmeler yeni bir kayıt oluşturur. Destekleyen alıntısı olmayan bir iddia atılmaz, açık soru olarak saklanır. Atıf da bir işaretçidir, kanıtın kendisi değildir: Alıntılanan pasajın iddianın söylediği şeyi gerçekten söyleyip söylemediğini birinin yine kontrol etmesi gerekir. Modelin hiç getirmeden ürettiği bir bağlantı ise hiçbir şekilde kanıt sayılmaz.

Onaylar, bütçeler ve iz

Araştırma ajanları belli bir ana kadar çoğunlukla yalnızca okuma yapar. Bir ajan e-posta gönderdiği, bir veri kümesini dışa aktardığı, tekrarlanan bir iş zamanladığı ya da kendi talimatlarını düzenlediği anda, bir insanın kararını hak eden eylemlere adım atmış olur. Bu katmanı baştan kurun:

• Eylemleri sınıflandırın; sonuç doğuran sınıflar, onaylayan kişiye birebir talebi göstererek dursun.
• Her onayı tek bir denemeyle sınırlayın ve eylem gerçekten yürütüldüğünde yeniden kontrol edin.
• Her çalıştırmayı süre, araç çağrısı ve harcama ile sınırlayın; sınıra gelindiğinde sessizce kötüleşmek yerine görünür biçimde durun.
• Talepleri, kararları, araç çalıştırmalarını ve sonuçları bir insanın baştan sona okuyabileceği tek bir ize yazın.

Bir ajan denetim izinin neleri kaydetmesi gerektiği notu bunu alan alan ele alıyor.

Otonom bir araştırma ajanı neler ekler

Otonom bir araştırma ajanı bir sonraki adımına kendisi karar verir: hangi sorguyu çalıştıracağına, hangi sayfayı okuyacağına, ne zaman duracağına. Bu, yığının üzerine üç bileşen ekler. Planlayıcı bir soruyu sıralı adımlara dönüştürür. Döngü denetleyicisi kanıtın ne zaman yeterli olduğuna ya da bütçenin ne zaman tükendiğine karar verir. Kaynak politikası ise ajanın nereye bakabileceğini sınırlar.

Planı gizli bir ara adım olarak değil, kendi başına bir çıktı olarak ele alın. Soruyu, adımları ve bir kaynak izin listesini yazın; çalışmadan önce bir insana onaylatın ve yürütmenin planı genişletmesine izin vermeyin. Soru yarı yolda değişirse ajanın sürüklenmesine izin vermek yerine planı yeniden yazın. Bu tür döngülerin nerelerde bozulduğunu ayakta kalan araştırma ajanları yazısı anlatıyor. Döngüyü kendiniz mi kuracağınız yoksa bir derin araştırma API'si olarak mı satın alacağınız ayrı bir karardır; derin araştırmayı kurmak ya da satın almak yazısı bu kararı adım adım ele alıyor.

GoCux nerede devreye girer

GoCux bir arama API'si, tarayıcı ya da model değildir; bu yüzden veri toplama katmanınızın yerini almaz. Onun üstündeki yönetişimli katmanları üstlenir. Bir iş emri bir hedef, işin dokunabileceği kapsam, kabul ölçütleri ve süre ile araç çağrısı gibi sınırlar taşır; kuyrukta, çalışıyor, karar bekliyor ve tamamlandı durumlarından geçer ve her adım gerçekleştiği anda kaydına işlenir. Araştırma planları bir kaynak izin listesi taşır ve çalışmadan önce onay gerektirir. Bilgi arama, tek bir projenin dokümanlarından atıflarla yanıt verir; Bilgi çıkarma her değeri dayandığı pasaja bağlar; Pulse tekrarlanan soruları birinin incelediği kayıtlara dönüştürür. Sonuç doğuran eylemler bir insan kararı için durur, harcama günlük bir tavanı olan görünür kredilerden düşer ve iz çalışma alanında okunabilir. MCP araçları sizin uyumlu istemcinizde çalışır; bir sunucunun yapılandırılmış olması, her görevin onu kullanabileceği anlamına gelmez.

Bileşen seçimi için kontrol listesi

• Her veri toplama aracı kaynak adresini ve alınma zamanını döndürüyor ya da kaydetmenize izin veriyor.
• Bilgi getirme proje bazında kapsamlı ve “ulaşılamadı” durumunu “hiçbir şey bulunamadı” durumundan ayrı raporluyor.
• Bilgi çıkarma her değer için destekleyen pasaj döndürüyor ve bilinmiyor yanıtına izin veriyor.
• İzleyicilerin başlangıç kayıtları, yazılı önemlilik kuralları ve her çalıştırma için incelenebilir bir kaydı var.
• Kanıt, alıntı ve anlık görüntü içeren değiştirilemez iddia kayıtları olarak saklanıyor.
• Sonuç doğuran eylemler birebir talebi göstererek duruyor ve onaylar yürütme anında yeniden kontrol ediliyor.
• Her çalıştırmanın süre, araç çağrısı ve harcama sınırları var.
• Otonom araştırma, kaynak izin listesi olan onaylanmış bir plandan yürütülüyor.