Azure AI Search'te Oturumlarda Hata Ayıklama

Hata Ayıklama Oturumları, Azure portalında mevcut bir beceri kümesiyle çalışan ve oturum süresince bir dizin oluşturucu ve beceri kümesi tarafından üretilen tek bir zenginleştirilmiş belgenin yapısını ve içeriğini ortaya çıkaran görsel bir 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.

Bu makalede desteklenen senaryolar ve düzenleyicinin nasıl düzenlendiği açıklanmaktadır. Beceri kümesi yapısını, akışını ve çalışma zamanında oluşturduğu içeriği inceleyebilmeniz için düzenleyicinin sekmeleri ve bölümleri beceri kümesinin farklı katmanlarını açar.

Desteklenen senaryolar

Aşağıdakilerle ilgili sorunları araştırmak ve çözmek için Hata Ayıklama Oturumlarını kullanın:

• Yapay zeka zenginleştirmesi için kullanılan OCR, görüntü analizi, varlık tanıma ve anahtar sözcük ayıklama gibi yerleşik beceriler.

• Metin Bölme ile veri öbekleme ve ekleme becerisi aracılığıyla vektörleştirme ile tümleşik vektörleştirme için kullanılan yerleşik beceriler.

• Sağladığınız dış işlemeyi tümleştirmek için kullanılan özel beceriler.

İlk iki senaryo için aşağıdaki hata ayıklama oturumu görüntülerini karşılaştırın. Her iki senaryoda da yüzey alanı, kaynak belgeden arama dizinine yönlendiren içerik oluşturan veya dönüştüren becerilerin ilerlemesini gösterir. Akış dizin eşleme seçeneklerini içerir ve işlem izini izlemek için okları izleyebilirsiniz. Sağdaki ayrıntılar bölmesi bağlama duyarlıdır. İşlem hattı tarafından oluşturulan zenginleştirilmiş belgenin gösterimini veya bir becerinin veya eşlemenin ayrıntılarını gösterir.

İlk görüntüde uygulanan yapay zeka zenginleştirme (vektör yok) için bir desen gösterilmektedir. Bağımlılık yoksa beceriler sırayla veya paralel olarak çalıştırılabilir. Dizin eşlemeleri, zenginleştirilmiş veya oluşturulan içeriğin bellek içi veri yapılarından dizindeki alanlara nasıl geçiş yapıldığını gösterir. Zenginleştirilmiş belge, beceri kümesinin oluşturduğu veri yapısını gösterir.

İkinci görüntüde tümleşik vektörleştirme için tipik bir desen gösterilmektedir. Tümleşik vektörleştirme becerileri genellikle Metin Bölme becerisini ve ekleme becerisini içerir. Metin Bölme becerisi, belgeyi öbeklere böler. Ekleme becerisi, bu öbekleri vektörleştirmek için ekleme API'sini çağırır. Bu özel beceri kümesi içeriği bir "sayfalar" dizisine ayırır. Tümleşik vektörleştirme için projeksiyon eşlemeleri, öbeklerin dizindeki alanlarla nasıl eşlendiğini denetler.

Sınırlamalar

Hata Ayıklama Oturumları, genel olarak kullanılabilen tüm dizin oluşturucu veri kaynaklarıyla ve çoğu önizleme veri kaynağıyla çalışır ve aşağıdaki özel durumlar geçerlidir:

• SharePoint Online dizin oluşturucu.

• MongoDB için Azure Cosmos DB dizin oluşturucu.

• NoSQL için Azure Cosmos DB için dizin sırasında bir satır başarısız olursa ve buna karşılık gelen meta veriler yoksa, hata ayıklama oturumu doğru satırı seçmeyebilir.

• Azure Cosmos DB'nin SQL API'sinde bölümlenmiş bir koleksiyon daha önce bölümlenmemişse, hata ayıklama oturumu belgeyi bulamaz.

• Özel beceriler için, Azure Depolama ile hata ayıklama oturumu bağlantısı için kullanıcı tarafından atanan yönetilen kimlik desteklenmez. Önkoşullarda belirtildiği gibi, sistem tarafından yönetilen kimlik kullanabilir veya anahtar içeren bir tam erişim bağlantı dizesi belirtebilirsiniz. Daha fazla bilgi için bkz . Yönetilen kimlik kullanarak arama hizmetini diğer Azure kaynaklarına bağlama.

• Şu anda, hangi belgenin hata ayıklanacağını seçebilme özelliği kullanılamıyor. Bu sınırlama kalıcı değildir ve yakında kaldırılacaktır. Şu anda Hata Ayıklama Oturumları kaynak veri kapsayıcısında veya klasöründeki ilk belgeyi seçer.

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ının ön eki ms-az-cognitive-search-debugsessionvardır. 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 bir hata ayıklama oturumu kullanılabilir.

Oturum düzeninde hata ayıklama

Görsel düzenleyici, belge çatlaması, ardından beceriler, eşlemeler ve bir dizinle başlayarak işlemlerin ilerlemesini gösteren bir yüzey alanı halinde düzenlenmiştir.

Herhangi bir beceriyi veya eşlemeyi seçtiğinizde ilgili bilgileri gösteren bir bölme açılır.

Beceri işlemede daha fazla detaya gitmek için bağlantıları izleyin. Örneğin, aşağıdaki ekran görüntüsünde Metin Bölme becerisinin ilk yinelemesinin çıkışı gösterilmektedir.

Beceri ayrıntıları bölmesi

Beceri ayrıntıları bölmesinde aşağıdaki bölümler vardır:

• Yinelemeler: Bir becerinin kaç kez yürütülür olduğunu gösterir. Her birinin girişlerini ve çıkışlarını de kontrol edebilirsiniz.
• Beceri Ayarları: JSON beceri kümesi tanımını görüntüleyin veya düzenleyin.
• Hatalar ve uyarılar: Bu beceriye özgü hataları veya uyarıları gösterir.

Zenginleştirilmiş veri yapısı bölmesi

Zenginleştirilmiş Veri Yapısı bölmesi, mavi gösteri veya gizle ok simgesini seçtiğinizde kenardan kayar. Zenginleştirilmiş belgenin içeriğinin okunabilir bir gösterimidir. Bu makaledeki önceki ekran görüntüleri zenginleştirilmiş veri yapısı örneklerini gösterir.

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.