Ajan entegrasyonu

Signals, kodunuzu değiştiren kodlama ajanlarının okuması için tasarlanmıştır. Ajan işe başlamadan önce kısa bir özet görür, üzerinde çalıştığı yolun altındaki grupları okuyabilir ve bir düzeltmeyi kaydedebilir. Ancak kendi düzeltmesini doğrulanmış ilan edemez.

Çalışma zamanı satırı

Ajanın üzerinde çalıştığı yolun altında aktif gruplar varsa, Pathrule'un hook'ları ve pathrule_get_context aracılığıyla ajanın bağlamına tek bir satır gelir:

Runtime: 2 active issues under apps/web/checkout (1 came back after a fix). Inspect with pathrule_runtime_events.

Bu satır yalnızca sayıları taşır. Raporlanan mesajlar hiçbir zaman bu satırla iletilmez.

Grupları okuma

pathrule_runtime_events salt okunurdur. Çalışma alanını, isteğe bağlı olarak da bir group_id, bir path, bir kind, bir environment, bir status, bir verification durumu, bir limit (1 ile 100 arası, varsayılan 20) ve bir cursor alır. Grupları revizyonları, doğrulama durumları ve varsa kaydedilmiş düzeltmeleriyle birlikte, sonraki sayfa için bir cursor ve kapsam bilgisiyle döndürür.

Döndürdüğü her şey güvenilmeyen gözlem olarak işaretlenir. Hata mesajları ve meta veriler çalışan bir uygulamadan gelir; bu yüzden ajan bunları asla talimat olarak değil, incelenecek veri olarak ele alır.

Bir düzeltmeyi kaydetme

pathrule_runtime_events_resolve bir gruba karşı düzeltme kaydeder. group_id değerini, ajanın okuduğu expected_revision değerini, bir idempotency_key ve isteğe bağlı olarak bir baseline_release, en fazla 500 karakterlik bir note ve en fazla 20 bilgi referansı alır. Bir sonraki adımla birlikte recorded, replayed veya refused yanıtını verir.

Kayıt bir kanıt değil, bir iddiadır. Grup, daha yeni bir sürüm doğrulama ve yaşam döngüsü bölümünde açıklanan kanıtı getirene kadar olduğu yerde kalır. Düzeltme kaydı Pathrule Local'de ve Pathrule Cloud'da aynı şekilde çalışır.

Terminalde

pathrule instrument events --path apps/web/checkout --verification recurred

pathrule instrument events grupları aynı filtrelerle listeler: --path, --kind error|event, --environment, --status active|declared|resolved|archived, --verification unobserved|observing|quiet|verified|recurred, --group <id>, --limit ve --cursor. Betikler için --json ekleyin.

Cloud kurulumunu bir ajanla yapma

Pathrule Cloud'da Signals kurulumunu sizin yerinize bir ajan yapabilir. pathrule_instrument çalışma alanının Signals durumunu ve bir kurulum kılavuzunu gösterir. pathrule_instrument_activate onayınızı kaydeder, bir proje anahtarı oluşturur ve SDK'yı projeye bir kaynak dosyası olarak ekler; böylece hiçbir paket kayıt deposundan kurulum yapılmaz.