Azure AI Search'te Oturumlarda Hata Ayıklama

Hata Ayıklama Oturumları, Oturum süresince bir dizin oluşturucu ve beceri kümesi tarafından üretildiği için tek bir zenginleştirilmiş belgenin yapısını ve içeriğini kullanıma sunarak Azure portalında mevcut beceri kümesiyle çalışan bir görsel düzenleyicidir. Canlı bir belgeyle çalıştığınız için oturum etkileşimlidir; hataları tanımlayabilir, beceri yürütmeyi değiştirebilir ve çağırabilir ve sonuçları gerçek zamanlı olarak doğrulayabilirsiniz. Değişiklikleriniz sorunu çözerse, düzeltmeleri genel olarak uygulamak için bunları yayımlanmış bir beceri kümesine işleyebilirsiniz.

Hata ayıklama oturumu nasıl çalışır?

Bir oturum başlattığınızda, arama hizmeti beceri kümesini, dizin oluşturucuyu ve beceri kümesini test etmek için kullanılan tek bir belgeyi içeren bir veri kaynağının bir kopyasını oluşturur. Tüm oturum durumu, sağladığınız bir Azure Depolama hesabında Azure AI Arama hizmeti tarafından oluşturulan yeni bir blob kapsayıcısına kaydedilir. Oluşturulan kapsayıcının adı "ms-az-cognitive-search-debugsession" ön ekini içerir. Oturum verilerini yanlışlıkla hesabınızdaki başka bir kapsayıcıya aktarma olasılığını azalttığı için ön ek gereklidir.

Zenginleştirilmiş belgenin ve beceri kümesinin önbelleğe alınmış bir kopyası görsel düzenleyiciye yüklenir; böylece zenginleştirilmiş belgenin içeriğini ve meta verilerini inceleyebilir ve her belge düğümünü denetleyerek beceri kümesi tanımının herhangi bir yönünü düzenleyebilirsiniz. Oturumda yapılan tüm değişiklikler önbelleğe alınır. Bu değişiklikler, siz işlemediğiniz sürece yayımlanan beceri kümesini etkilemez. Değişikliklerin işlenmesi üretim beceri kümesinin üzerine yazılır.

Zenginleştirme işlem hattında hata yoksa, bir belgeyi artımlı olarak zenginleştirmek, değişiklikleri işlemeden önce her değişikliği test etmek ve doğrulamak için hata ayıklama oturumu kullanılabilir.

Hata Ayıklama Oturumu durumunu yönetme

Başlangıç düğmesini kullanarak hata ayıklama oturumunu yeniden çalıştırabilir veya İptal düğmesini kullanarak devam eden bir oturumu iptal edebilirsiniz.

Yapay Zeka Zenginleştirmeleri sekmesi > Beceri Grafı

Görsel düzenleyici sekmeler ve bölmeler halinde düzenlenir. Bu bölümde görsel düzenleyicisinin bileşenleri tanıtılmaktadır.

Beceri Grafiği, beceri kümesinin görsel bir hiyerarşisini ve yukarıdan aşağıya yürütme sırasını sağlar. Diğer becerilerin çıkışına bağlı olan beceriler grafikte daha düşük bir konuma yerleştirilir. Hiyerarşide aynı düzeydeki beceriler paralel olarak yürütülebilir. Grafikteki renk kodlu beceri etiketleri, beceri kümesinde yürütülmekte olan beceri türlerini gösterir (METNEÇEVİr veya VİzYON).

Grafikte bir beceri seçildiğinde, sağ bölmede becerinin tanımı, hataları veya uyarıları ve yürütme geçmişi dahil olmak üzere bu beceri örneğinin ayrıntıları görüntülenir. Beceri Grafiği, hata ayıklamak veya geliştirmek için hangi beceriyi seçeceğiniz yerdir. Sağ tarafta bulunan ayrıntılar bölmesi, düzenleyip keşfedeceğiniz yerdir.

Beceri ayrıntıları bölmesi

Beceri Grafiği'nde bir nesne seçtiğinizde, bitişik bölme sekmeli düzende etkileşimli çalışma alanları sağlar. Ayrıntılar bölmesinin çizimini önceki ekran görüntüsünde bulabilirsiniz.

Beceri ayrıntıları aşağıdaki alanları içerir:

• Beceri Ayarlar, beceri tanımının biçimlendirilmiş bir sürümünü gösterir.
• Beceri JSON Düzenleyicisi tanımın ham JSON belgesini gösterir.
• Yürütmeler , bir becerinin her yürütülişine karşılık gelen verileri gösterir.
• Hatalar ve uyarılar , oturum başlatıldığında veya yenilendiğinde oluşturulan iletileri gösterir.

Yürütmeler veya Beceri Ayarlar, beceri giriş ve çıkışlarının ifadelerini görüntülemek ve düzenlemek için kullanılan İfade Değerlendiricisi'ni açmak için simgeyi seçin</>.

Beceri Ayarlar iç içe giriş denetimleri projeksiyonlar için karmaşık şekiller, karmaşık tür alanı için çıkış alanı eşlemeleri veya beceriye giriş oluşturmak için kullanılabilir. İfade Değerlendirici ile kullanıldığında, iç içe girişler kolay bir test ve doğrulama ifadesi oluşturucusu sağlar.

Yürütmeler bölmesi

Beceri, tek bir belge için beceri kümesinde birden çok kez yürütülebilir. Örneğin, OCR becerisi tek bir belgeden ayıklanan her görüntü için bir kez yürütülür. Yürütmeler bölmesi, becerinin yürütme geçmişini görüntüler ve becerinin her çağrısına daha ayrıntılı bir bakış sağlar.

Yürütme geçmişi, belirli bir zenginleştirmeyi oluşturan beceriye geri izlemenizi sağlar. Bir beceri girişine tıklanması, bu girişi oluşturan beceriye gider ve yığın izleme benzeri bir özellik sağlar. Bu, aşağı akış becerisinde ortaya çıkarabilecek bir sorunun kök nedeninin belirlenmesine olanak tanır.

Özel beceri içeren bir hatanın hatalarını ayıkladığınızda, yürütme geçmişinde beceri çağırma isteği oluşturma seçeneği vardır.

Yapay Zeka Zenginleştirmeleri sekmesi > Zenginleştirilmiş Veri Yapısı

Zenginleştirilmiş Veri Yapısı bölmesi, beceri kümesi aracılığıyla belgenin zenginleştirmelerini gösterir ve her zenginleştirmenin bağlamını ve kaynak beceriyi ayrıntılı olarak gösterir. İfade Değerlendirici, her zenginleştirmenin içeriğini görüntülemek için de kullanılabilir.

İfade Değerlendirici

İfade Değerlendirici herhangi bir yolun değerine hızlı bir bakış sağlar. Bir beceri veya projeksiyon için herhangi bir girişi veya bağlamı güncelleştirmeden önce yolu düzenlemeye ve sonuçları test etmeye olanak tanır.

Pencereyi, bir bağımlılık grafiğinin bölümleri veya zenginleştirme ağacındaki düğümler de dahil olmak üzere simgeyi </> gösteren herhangi bir düğümden veya öğeden açabilirsiniz.

İfade Değerlendirici, beceri bağlamını, girişleri test etmek ve çıkışları denetlemek için tam etkileşimli erişim sağlar.

Sonraki adımlar

Hata ayıklama oturumlarının öğelerini anladığınıza göre, mevcut beceri kümesinde ilk hata ayıklama oturumunuzu başlatın.