Azure Yapay Zeka Arama'te Hata Ayıklama Oturumları

Hata Ayıklama Oturumları, Azure portalında mevcut bir beceri kümesi ile işleyen ve bir oturum süresince bir dizin oluşturucu ve beceri kümesi tarafından üretilmiş tek bir zenginleştirilmiş belgenin yapısını ve içeriğini görselleştiren 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 yoluyla veri öbekleme ve gömme becerisi aracılığıyla vektörleştirme yapan tümleşik vektörleştirme için kullanılan yerleşik beceriler.

• Sağladığınız harici işlemleri entegre etmek için kullanılan özel yetenekler.

İ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 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.

• Müşteri tarafından yönetilen anahtarlar (CMK) aracılığıyla etkinleştirilmiş şifrelemeye sahip veri kaynakları.

• Paylaşılan özel bağlantılar desteklenmez. Arama hizmetiniz veri kaynaklarına veya diğer kaynaklara erişmek için özel uç nokta bağlantısı kullanıyorsa hata ayıklama oturumları bu kaynaklara erişemez. Geçici bir çözüm için bkz. Oturumlarda ve özel bağlantılarda hata ayıklama.

• Ş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ılmalıdı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. Azure Yapay Zeka Arama hizmeti, tüm oturum durumunu sağladığınız bir Azure Depolama hesabında oluşturduğu yeni bir blob kapsayıcısına kaydeder. Oluşturulan kapsayıcı adının ön eki ms-az-cognitive-search-debugsessionvardır. Bu ön ek, oturum verilerini yanlışlıkla hesabınızdaki başka bir kapsayıcıya aktarma olasılığını azaltır.

Depolama hesabı bağlantısını yönetilen kimlik kullanarak yapılandırdıysanız, rolü depolama hesabındaki arama hizmeti kimliğinize atayın Storage Blob Data Contributor . Depolama hesabınızda, Azure Yapay Zeka Arama yazma erişimine izin vermek için güvenilen hizmetleri etkinleştirin.

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 taahhüt etmediğiniz sürece yayımlanan beceri kümesini etkilemez. Değişikliklerin uygulanması, üretim beceri kümesini üzerine yazar.

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.

Hata ayıklama oturumları verileri, beceri girişlerini ve çıkışlarını ve alan eşlemelerini analiz ederek hataların veya uyarıların kök nedenini belirlemeye yardımcı olur. Her becerinin giriş olarak ne aldığını ve çıkış olarak ne ürettiğini incelemek için beceri ayrıntıları bölmesini kullanın. Bu inceleme beceri tanımlarının, ifadelerinin ve alan eşlemelerinin doğru şekilde oluşturulduğunu doğrulamaya yardımcı olur. Dizin oluşturucu yanlış ağ kurulumu veya izinle ilgili erişim hataları gibi yapılandırma sorunlarıyla karşılaşırsa, ilgili hata iletisini ve bağlantılı belgeleri gözden geçirin. Sorun giderme yönergeleri için bkz. Yaygın dizin oluşturucu hataları ve uyarıları.

Oturumlarda ve özel bağlantıda hata ayıklama

Hata ayıklama oturumları paylaşılan özel bağlantıları desteklemez. Üretim arama hizmetiniz veri kaynaklarına veya diğer kaynaklara erişmek için özel uç nokta bağlantısı kullanıyorsa, hata ayıklama oturumları bu hizmette çalıştırılamaz.

Geçici çözüm: test arama hizmeti kullanma

Beceri kümesinde hata ayıklamak için özel bağlantı kısıtlamaları olmadan ayrı bir Azure Yapay Zeka Arama hizmeti oluşturun. Üretim verilerini ve şema ayrıntılarını özel olmayan bir ortamdan uzak tutmak için yapay belgelerle test kurulumunuzu oluşturun:

• Üretim verilerinizin alan türleri ve yapısıyla eşleşen, ancak gerçek veriler yerine genel alan adlarını (örneğin, content, title, category) ve yer tutucu değerlerini kullanan test belgeleri oluşturun. Beceri kümesi mantığı, belirli alan adlarına değil içerik türlerine ve yapıya bağlıdır.
• Üretim hizmetinizden JSON beceri kümesini kopyalayın. Beceri girişleri üretim alanı adlarına başvuruda bulunursa, bu başvuruları genel test alanı adlarınızla eşleşecek şekilde güncelleştirin. Test alanı adlarını beceri kümesi girişleriyle hizalamak için test dizin oluşturucusunda alan eşlemelerini kullanın.
• Test veri kaynağında çalışacak bir dizin oluşturucu yapılandırın.

Beceri girişlerini ve çıkışlarını incelemek, beceri ifadelerini ve alan eşlemelerini doğrulamak ve hataları tanımlamak için test hizmetinde hata ayıklama oturumunu çalıştırın. Değişiklikleriniz doğrulandığında, JSON beceri kümesindeki özgün üretim alanı adı başvurularını geri yükleyin ve üretim hizmetinize geri uygulayın.

Oturum düzeninde hata ayıklama

Görsel düzenleyici, belge çözme ile başlayarak beceriler, eşlemeler ve bir dizinle işlemlerin ilerlemesini gösteren bir görsel yüzey 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ı penceresi

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 ne içerdiğini insan tarafından kolayca okunabilecek bir şekilde sunar. 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.