Microsoft Purview'da Copilot Studio etkinliklerini denetleme

Bu makalede, Microsoft Purview portalıı tarafından kaydedilen ve erişilebilir hale getirilen Copilot Studio etkinlikleri listelenir ve açıklanır. Geliştiriciler bu günlüklere Office 365 Management API aracılığıyla da erişebilir.

Bir aracı öğesinin içeriğinde ve ayarlarında yapılan değişiklikler güvenliği ve aracı davranışını etkileyebilir. Bu eylemlerin denetlenmesi hataların azaltılmasına, güvenlik kısıtlaması sistemlerinin bulunmasına, uyumluluk gereksinimlerine uymasına ve güvenlik tehditlerini ele alınmasına yardımcı olur.

Copilot Studio, aracılarla hem yönetimsel hem de üretici ve kullanıcı etkileşimleri ile ilgili etkinlikleri kaydeder.

Copilot Studio, denetim günlüklerini oluşturmak için kullanılan verileri güvenlik ve uyumluluk standartlarına uygun olarak depolar. Daha fazla bilgi için bkz. Microsoft Copilot Studio güvenlik ve uyumluluk.

Note

Microsoft Entra Aracı Kimlikleri olan aracılar için kimlik doğrulama etkinliği, Microsoft Entra ID'ye kaydedilir ve Microsoft Entra yönetim merkezinde görünür. Microsoft Entra Aracı Kimliklerini otomatik olarak oluşturma bölümünde daha fazla bilgi edinin.

Important

Copilot Studio için yönetim etkinlikleri tüm kiracılarda varsayılan olarak etkindir. Etkinlik toplamayı devre dışı bırakamazsınız, ancak Purview'daki denetim günlüklerini devre dışı bırakabilir ve kullanıcı mesaj metni ile yanıt metninin saklanmasını önlemek için saklama politikalarını kullanabilirsiniz.

Prerequisites

Günlüklere erişme

  1. Microsoft Purview portalıında kiracı yöneticisi olarak oturum açın.

  2. Sol menüde Tümünü göster'i seçin.

  3. Çözümler altında Denetim'i seçin.

Yöneticiler, Activities listesindeki Copilot Studio etkinliklerini filtreleyebilir. Etkinlikler, bu makaledeki aşağıdaki tablolarda listelendiği gibi olay türleri ve kategorileriyle eşlenir.

Purview'daki etkinlikler için kolay adları gösteren arama sonuçlarının ekran görüntüsü.

Uyumluluk yöneticileri, CopilotInteraction olaylarının sohbet dökümlerini görüntülemek için AI çözümü için Veri Güvenliği Duruş Yönetimi (DSPM) de kullanabilir. Daha fazla bilgi için bkz. Veri Güvenlik Duruşu Yönetimi (DSPM).

Denetlenen olayları görün (aracı yazarlığı)

Tüm günlükler SDK katmanında gerçekleşir, bu nedenle tek bir eylem birden çok günlüğe kaydedilen olayı tetikleyebilir.

Bu tabloda genellikle Copilot Studio yönetim eylemleriyle ilgili olaylar (örneğin, bir aracıyı silme veya aracının adını, ayrıntılarını veya yapılandırmasını güncelleştirme) listelenir.

Kategori Etkinlik etiketi Olayın açıklaması
Agents BotDeleteCleanup Copilot Studio'de bir aracı silindikten sonra bağımlılıkların temizlenmesi
Agents BotUpdateOperation-BotNameUpdate Copilot Studio'da Ajanın Adını Güncelleme
Agents BotCreate Copilot Studio'da yeni bir ajan oluşturma
Agents BotDelete Copilot Studio'de aracı silme
Agents BotUpdateOperation-BotAuthUpdate Copilot Studio'da bir aracının kimlik doğrulama ayarlarını güncelleştirme
Agents BotUpdateOperation-BotIconUpdate Copilot Studio'da temsilci simgesini güncelleme
Agents BotUpdateOperation-BotPublish Copilot Studio'da aracı yayımlama
Agents BotUpdateOperation-BotShare Copilot Studio'da bir ajanın diğer kullanıcılarla paylaşılması
Agents BotAppInsightsUpdate Copilot Studio'da bir aracının App Insights günlük yapılandırmasını güncelleştirme
Ajan Bileşeni BotComponentCreate Copilot Studio'da bir ajan için bir bileşen (örneğin, konu veya beceri) oluşturma
Ajan Bileşeni BotComponentUpdate Copilot Studio'da bir ajan için bir bileşenin (konu veya beceri gibi) güncellenmesi
Ajan Bileşeni BotComponentDelete Copilot Studio'da bir temsilci için bir bileşenin (örneğin, konu veya beceri) silinmesi
Aracı Bileşen Koleksiyonu BotComponentCollectionCreate Copilot Studio'da bir ajan için bileşen koleksiyonu oluşturulması
Aracı Bileşen Koleksiyonu BotComponentCollectionDelete Copilot Studio'da bir ajan için bileşen koleksiyonunun silinmesi
Aracı Bileşen Koleksiyonu BotComponentCollectionUpdate Copilot Studio'da bir ajan için bileşen koleksiyonunun güncellemesi
Yapay Zeka Eklentisi AIPluginOperationCreate Copilot Studio'de bir aracı için yapay zeka eklentisi oluşturma
Yapay Zeka Eklentisi AIPluginOperationUpdate Copilot Studio'da bir aracı için yapay zeka eklentisini güncelleştirme
Yapay Zeka Eklentisi AIPluginOperationDelete Copilot Studio'da bir ajans için yapay zeka eklentisini kaldırma
Ortam değişkeni EnvironmentVariableCreate Copilot Studio'da bir aracı için ortam değişkeni oluşturma
Ortam değişkeni EnvironmentVariableUpdate Copilot Studio'da bir aracı için ortam değişkenlerini güncelleştirme
Ortam değişkeni EnvironmentVariableDelete Copilot Studio'da bir aracı için ortam değişkenlerini silme

Denetlenen olayları görüntüleme (ajan kullanımı)

Note

Tüm günlükler SDK katmanında gerçekleşir, bu nedenle tek bir eylem birden çok günlüğe kaydedilen olayı tetikleyebilir.

Bazı kanallar günlük kaydından hariç tutulur. Purview'daki Denetim çözümünde listelenen olaylar için, denetlenen olayın CopilotEventData JSON alanı değeri olarak AppHost kanalı içerir. Yapay zeka için DSPM çözümünde kanal, uygulamada erişilen uygulama alanında görünür.

Bu tabloda, soru sorma ve yanıtları görüntüleme gibi Copilot Studio Copilot aracılarıyla kullanıcı etkileşimleri olan olaylar listelenir. Denetlenen olay, bu etkinlik için tarih ve saat, kuruluş, kullanıcı ve kaynak kimlikleri ve transkript iş parçacığı kimliği gibi meta verileri içerir.

Copilot Studio sohbet metnini (transkript) Purview'daki denetlenen olaydan ayrı olarak kaydeder. Transkripti, AI için Veri Güvenliği Duruş Yönetimi (DSPM) çözümünde gösterildiği gibi, günlüğe kaydedilen olaydan doğrudan görebilir veya erişebilirsiniz.

Important

Denetim çözümündeki denetim günlükleri, kullanıcı ve aracı arasındaki etkileşimlerin tam metnini veya transkriptini içermez, yalnızca transkript iş parçacığı kimliğini içerir. Yapay Zeka için Veri Güvenliği Durum Yönetimi (DSPM) çözümü, olayla ilgili sohbet metnini, kaydedilen olayın bir parçası olarak erişilen kaynaklara bağlantılar ile birlikte almaya çalışır.

Kategori Etkinlik etiketi Olayın açıklaması
Users CopilotInteraction Copilot Studio oluşturulan bir Copilot aracısı ile kullanıcı etkileşimleri( soru sorma ve yanıtları görüntüleme gibi)

Microsoft 365'teki Copilot etkileşim olayları hakkında daha fazla bilgi edinmek için Copilot etkileşim olaylarına genel bakış bölümüne bakın.

Şema denetim alanları

Şemalar, Microsoft Purview portalıına hangi aracı alanlarının gönderileceğini tanımlar. Bazı alanlar, denetim verilerini Microsoft Purview gönderen tüm uygulamalar için ortakken, diğerleri Copilot Studio'ya özeldir. Aşağıdaki alanlar Power Platform için ortaktır.

Alan adı görüntüsü Mantıksal ad Type Zorunlu Description
Date CreationTime Edm.Date Hayır Kaydın oluşturulduğu tarih ve saat (UTC).
Id ID Edm.Guid Hayır Kaydedilen her satır için benzersiz GUID.
Sonuç Durumu ResultStatus Edm.String Hayır Kaydedilen satırın durumu.
Organizasyon Kimliği OrganizationId Edm.Guid Evet Günlüğün oluşturulduğu kuruluşun benzersiz tanımlayıcısı.
Operation Operation Edm.String Hayır Olay etiketi de dahil olmak üzere işlemin adı.
User UserKey Edm.String Hayır Microsoft Entra ID'deki kullanıcının benzersiz tanımlayıcısı.
Kullanıcı türü UserType Self.UserType Hayır Denetim türü (yönetici, normal veya sistem).

Copilot Studio denetim alanları

Copilot Studio, Power Platform yönetici etkinliklerinde ortak olan alanlara ek olarak aşağıdaki alanları içerir.

Name Type Zorunlu Description
BotId Edm.String Hayır Ajanın benzersiz tanımlayıcısı
BotSchemaName Edm.String Hayır Temsilciyi tanımlayan benzersiz bir dize
BotUpdateDetails Edm.ComplexType (Koleksiyon) Hayır Ajanda güncellenen özelliklerin ayrıntıları
BotComponentId Edm.String Hayır Konular veya varlıklar gibi aracı bileşenlerinin benzersiz tanımlayıcısı
BotComponentSchemaName Edm.String Hayır Konular veya varlıklar gibi bir aracı bileşenlerini tanımlayan benzersiz bir dize
BotComponentType Edm.String Hayır Aracı bileşenin türü, konular veya varlıklar gibi
BotComponentUpdateDetails Edm.ComplexType (Koleksiyon) Hayır Güncellenmiş ajan bileşeni özelliklerinin detayları
AIPluginOperationId Edm.String Hayır Yapay zeka eklentisi ile yapılan işlem için benzersiz kimlik tanımlayıcısı
AIPluginOperationName Edm.String Hayır AI eklentisi ile yapılan işlemin adı
EnvironmentVariableDefinitionSchemaName Edm.String Hayır Aracı ile ilişkili ortam değişkeni tanımının şema adı
EnvironmentVariableDefinitionId Edm.String Hayır Aracı ile ilişkilendirilmiş ortam değişkeni tanımı için benzersiz bir tanımlayıcı

Denetim günlüğünü devre dışı bırak

Purview'daki kiracınızdaki tüm denetim olaylarının olay günlüğünü devre dışı bırakabilirsiniz.

Kullanıcı ve aracı metninin saklanmasını önlemek için Purview'da, Copilot Deneyimleri için 0 günlük bir bekletme ilkesi ayarlayan bir Veri Yaşam Döngüsü Yönetimi ilkesi oluşturabilirsiniz.

Saklama politikaları oluşturma ve yapılandırma bölümünde daha fazla bilgi edinebilirsiniz.