Microsoft Foundry'de Fabric veri ajanları için gözlemlenebilirlik

Microsoft Foundry'de oluşturduğunuz bir ajana bir Fabric veri ajanı ekleyebilirsiniz. Bağladıktan sonra, Foundry ajanı Fabric veri ajanını çağırarak Fabric OneLake'de yaşayan kurumsal verilerinize bağlı soruları yanıtlar.

Bu makale, o kurulumun gözlemlenebilirliği hakkındadır. Foundry'de bir ajan oluşturup ona bir Fabric veri ajanı bağladığınızda, veri ajanının her istekte ne yaptığını görmek istersiniz, sadece nihai cevabı değil. Foundry Observability size bu görünürlüğü sağlıyor. Veri ajanının logları ve izleri, Foundry ajanınızın zaten rapor verdiği yere gönderilir, böylece bir isteği uçtan uca takip edebilirsiniz; Foundry ajanından Fabric veri ajanına ve sorguladığı veri kaynaklarına kadar takip edebilirsiniz.

Bu makalenin geri kalanı bu telemetrinin nerede saklandığını, oraya nasıl ulaştığını, nasıl okunacağını, kimlerin görebileceğini ve nasıl kontrol edileceğini açıklıyor.

Genel bir genel bakış için bkz. Üretken Yapay Zeka'da Gözlemlenebilirlik . Bir Fabric veri ajanını Foundry'ye bağlamak için Microsoft Foundry'de bir veri ajanı tüket bölümüne bakınız.

Dökümhane projeleri ve Uygulama İçgörüleri

Foundry projesi, ajanlarınızı inşa edip işletmeniz anlamına gelir. Foundry, ajan trace'leri bir Azure İzleyici Application Insights kaynağında saklıyor ve her proje bu kaynaklardan birine bağlanıyor.

Ajan oluşturucu olarak, bunu bir kez kurun. Foundry projenizde Ajanlar bölümünü açın, İzler seçeneğini belirleyin ve Bağlan seçeneğini belirleyin. Yeni bir Application Insights kaynağı oluşturabilir veya zaten var olan bir kaynağı bağlayabilirsiniz. Kaynağı bağladıktan sonra, Foundry proje için sunucu tarafı izlemeyi otomatik olarak açar. Kod değişikliği yapmanıza gerek yok ve izler dakikalar içinde akmaya başlıyor.

İlişki basittir: proje bir Application Insights kaynağına işaret eder ve o projedeki her ajan izlerini oraya gönderir. Proje, telemetrinin nerede toplanacağını tanımlar; Application Insights, onun yaşadığı yer ve sorgulama yaptığınız yerdir.

İzleri Foundry ajanınızın İzler sekmesinde görebilir veya doğrudan bağlı Application Insights kaynağında sorgulayabilirsiniz. Foundry portalı son 90 günden izleri gösteriyor.

Adım adım kurulum için, Microsoft Foundry'de AI ajanları için takip kurulumu bölümüne bakınız.

Fabric veri ajanı kayıtları ve izleri projenize nasıl ulaşır?

Bir Fabric veri ajanını Foundry'ye bağlamak için bir Foundry projesinde çalışın. Bir Application Insights kaynağını o projeye bağlarsanız, Fabric veri ajanı loglarını ve izlerini aynı kaynağa gönderir. Foundry ajanınızın telemetri verileri ile Fabric veri ajanınızın telemetri verileri tek bir yerde toplanır, böylece bunları birlikte inceleyebilirsiniz.

Akış şöyle işliyor:

  1. Foundry projenizde, önceki bölümde açıklandığı gibi bir Application Insights kaynağını bağlayın.
  2. O projede bir Foundry ajanına bir Fabric veri ajanı ekleyin.
  3. Foundry ajanı çalıştığında, Fabric OneLake'teki kurumsal verilerden içgörüler almak için Fabric veri ajanını çağırır.
  4. Fabric, projeye bağlı Application Insights kaynağını doğrular, ardından veri ajanının loglarını ve izlerini ona gönderir.
  5. Veri ajanının telemetrisi, Foundry ajanınızın izleriyle birlikte, hem bağlı Application Insights kaynağında hem de ajanın İzleri görünümünde görünür.

Sonuç olarak, Fabric veri ajanının yaptığı iş, isteğin izinin bir parçası haline gelir. Foundry ajanınızın veri ajanını çağırdığını ve veri ajanının cevabını üretmek için neler yaptığını görürsünüz; buna hangi veri kaynaklarını sorguladığı, her adımın ne kadar sürdüğü ve her adımın başarıyla tamamlanıp tamamlanmadığı dahildir.

İzleri okuyun

Foundry Observability, her talebi iz olarak kaydeder. İz, açıklıklardan oluşur ve her açıklık, kendi başlangıç zamanı, süresi ve durumu olan bir çalışma birimini temsil eder. Span'ler iç içe yerleştirildiğinden, bir trace'i yukarıdan aşağıya okumak, bir isteğin izlediği yolu ve zamanın nerede harcandığını gösterir.

Bir Fabric veri ajanı, izlemeye iki tür aralık ekler:

  • Ajan span: Fabric veri ajanının tek bir istek için toplam çalışması.
  • Araç kapsamı: veri ajanının talebe yanıt verirken çağırdığı tek bir veri kaynağı veya araç. Bir istek, birden fazla araç aralığı üretebilir.

Aşağıdaki örneğin, bir Foundry ajanı, soruyu yanıtlamak için iki veri kaynağını sorgulayan bir Fabric veri ajanını çağırmaktadır:

Request (trace)
└─ Foundry agent run
   └─ Fabric data agent (called as a tool)
      └─ Agent span            Overall run of the Fabric data agent
         ├─ Tool span          First data source the data agent queried
         └─ Tool span          Second data source the data agent queried

Aşağıdaki tablo, iz düzeylerinin her birini ve bunlara iliştirilen üst veri türünü açıklar.

Level Yayılan Temsil eder Örnek meta veri
Dökümhane ajanı işletmesi Döküm Kullanıcı isteğini işleyen Foundry ajanı Konuşma Kimliği, durum, süre
Fabric veri aracısı (araç çağrısı) Döküm Foundry ajanının Fabric veri ajanını çağırdığı nokta Ajanın gösterim adı, durumu, süresi
Ajan aralığı Fabric veri aracısı İstek için Fabric veri ajanının genel işleyişi Temsilci gösterim adı, konuşma kimliği, durum, süre
Araç aralığı Fabric veri aracısı Veri aracısının yanıtlamak için başvurduğu her veri kaynağı veya araç Veri kaynağı adı, mantık adım kimliği, durum, süre

Bu yapıyla, bir şey tuhaf göründüğünde önemli olan soruları yanıtlayabilirsiniz:

  • Bir yanıt yavaş olduğunda, her bir aralığın süresi hangi adımın daha fazla zaman aldığını gösterir.
  • Bir cevap yanlış olduğunda, araç aralıkları hangi veri kaynaklarının sorgulandığını ve hangi sırayla sorgulandığını gösterir.
  • Bir istek başarısız olduğunda, her span üzerindeki durum hatanın nerede oluştuğunu gösterir.

Kayıtları ve izleri kim görebilir

Veri ajanının loglarını ve izlerini depolayan Application Insights kaynağı erişimi yönetir. Bu kaynağa okuma erişimi olan herkes telemetriyi görebilir. Bir kaynağı bir projeye bağlamak, sakladığı verilere erişim sağlamaz.

Veriyi nerede gördüğünüz Gerekli erişim
Application Insights Bağlı Application Insights kaynağında okuma iznine sahip bir rol, örneğin Monitoring Reader veya Log Analytics Reader
Microsoft Foundry projesi Bağlantılı Application Insights kaynağında okuma izinleri ve Foundry projesinde Foundry Kullanıcı veya daha üzeri bir rol

Tek başına bir Foundry projesine erişim telemetriye erişimi içermez. Application Insights kaynağında okuma izni her zaman gereklidir.

Operasyonel meta veri kiracı ayarı

Fabric yönetici portalındaki bir kiracı ayarı, Fabric veri ajanlarının Foundry'de gözlemlenebilirlik için operasyonel meta veri gönderip göndermediğini kontrol eder. Ayar varsayılan olarak açıktır.

Ayar yalnızca operasyonel meta veri gönderir. Bu meta veriler, ajanların görünme adlarını, veri kaynağı isimlerini, mantık yürütme adımı kimliklerini ve konuşma kimliklerini içerir. Fabric hiçbir müşteri içeriği iletmez. Kullanıcı istemleri ve veri ajanı yanıtları Fabric'in uyumluluk sınırları içinde kalır ve bu telemetriye dahil edilmez.

Uyarı

Bir Fabric yöneticisi, kiracı için bunu kapatabilir. Kiracı ayarları değişikliklerinin yürürlüğe girmesi bir saate kadar sürebilir.

Mekan şöyledir.

Fabric veri ajanları, Microsoft Foundry'de gözlemlenebilirlik için operasyonel meta veri gönderebilir

Ajan oluşturucular, işletmesel meta verileri kullanarak ajan sağlığını izleyebilir, sorunları tespit edebilir ve yayımlanan ajanlarının uygulamalar ve hizmetler arasında nasıl kullanıldığını anlayabilir. Bu içgörüler, ajan üreticilerinin temsilci güvenilirliğini ve performansını geliştirmesine yardımcı olur.

Bu ayarı açtığınızda, Fabric veri ajanları işleme ve depolama için yapılandırmalı bir Application Insights kaynağına operasyonel meta verileri gönderir. Bu veriler, ajan gösterim adları, veri kaynak isimleri, mantık yürütme adım kimlikleri ve konuşma kimliklerini içerir. Bu verileri işleyen ve depolayan Application Insights kaynağı, kiracınızın coğrafi bölgesi, uyum sınırı veya ulusal bulut örneği dışında olabilir.

Operasyonel meta verilere erişmek için, yapılandırılmış Application Insights kaynağında okuma iznlerine sahip bir role (örneğin Monitoring Reader veya Log Analytics Reader) ihtiyacınız var. Bu erişime sahip kullanıcılar, verileri Application Insights'ta görebilirler. Kullanıcılar ayrıca verileri yapılandırılmış Application Insights kaynağına bağlanan bir Foundry projesi aracılığıyla da görebilirler. Foundry üzerinden erişim, Application Insights kaynağında okuma izinlerinin yanı sıra Foundry projesine (Foundry Kullanıcı veya daha üzeri) rol tabanlı erişim gerektirir. Sadece bir Foundry projesine erişim telemetri verilerine erişimi içermez.

Important

Bu metaveriyi depolayan Application Insights kaynağı, kiracınızın coğrafi bölgesi, uyum sınırı veya ulusal bulut örneği dışında olabilir. Ayarları açık bırakmadan önce veri ikamet ve uyum gereksinimlerinizi gözden geçirin.

İlgili içerik

  • Last updated on