Microsoft Copilot Studio Aracı Envanteri

Copilot Studio Aracı Envanteri, BT ve güvenlik yöneticilerine, kiracıda Copilot Studio veya Aracı Oluşturucu kullanılarak oluşturulan tüm aracılar için merkezi bir görünüm sağlar. Envanter, hem yayımlanmamış (taslak) hem de yayımlanmış aracıları kapsar. Envanter; aracıyı kimin oluşturduğu, en son ne zaman yayımlandığı, hangi kanallarda dağıtıldığı, kullanıcıların kimliğini nasıl doğruladığı, yetenekleri ve daha fazlası gibi her aracıya ilişkin önemli meta verileri görüntüler. Envanter verileri otomatik olarak yenilenir ve bir aracıda yapılan değişiklikler genellikle 20 dakika içinde yansır.

Yöneticiler, Power Platform yönetim merkezi, Power Platform API ve Azure Kaynak Grafı dahil olmak üzere çeşitli yöntemlerle envanter verilerini kullanabilirler. Erişim yöntemlerinin ve gerekli rollerin tam listesi için bkz. Power Platform envanteri.

Bu makale, Power Platform envanterindeki Copilot Studio aracılarına (microsoft.copilotstudio/agents) özgü alanları açıklamaktadır. Tüm kaynak türlerinde bulunan paylaşılan alanlar için bkz. Power Platform envanter şeması başvurusu.

Not

Envanter, Copilot Studio'nun V1 sürümüyle oluşturulan (Klasik botlar veya Power Virtual Agents olarak da bilinir) aracıları içermez. Ancak, bu aracıları görmek için yine de Power Platform yönetim merkezine gidip Yönet>Copilot Studio>Klasik sohbet botları yolunu izleyebilirsiniz.

Önemli

Bu madde, Microsoft Copilot Studio önizleme belgelerini içerir ve değişikliğe tabidir.

Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, önceden erişebilmeniz ve geri bildirim sağlamanız amacıyla resmi sürümden önce kullanıma sunulur.

Üretime hazır bir aracı oluşturuyorsanız, Microsoft Copilot Studio Genel Bakış'a bakın.

Aracı özellikleri

Envanter, her bir aracı için aşağıdaki özellikleri içerir.

Not

  • Envanter, her bir aracının yayımlanmış sürümünün yapısını yansıtır. Bir aracının yayınlanmamış değişiklikleri (daha yeni bir taslak) varsa bu değişiklikler aracının yayınlanmasına kadar envanterde görünmez.

  • Bir aracının yapılandırması, hangi alanların doldurulacağını etkiler. Aracın nasıl ayarlandığına bağlı olarak bazı özellikler null olabilir. Örneğin, isManaged, Aracı Oluşturucu'da oluşturulan aracılar için null konumundadır.

Temel özellikler

API alanı yolu Veri türü Açıklama Örnek Durum
properties.displayName dize Aracının görünen adı. Customer support agent Genel kullanılabilir
properties.name GUID Belirli Dataverse ortamındaki aracının kimliği (CDS bot kimliği). aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.createdAt tarih saat Aracının oluşturulduğu tarih ve saat. 2024-12-13T04:00:00Z Genel kullanılabilir
properties.createdBy GUID Aracı oluşturan kullanıcının Entra ID'si. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.ownerId dize Aracının mevcut sahibinin nesne kimliği (Entra ID). aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.environmentId dize Kaynağı içeren Power Platform ortamının tanımlayıcısı. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.lastPublishedAt tarih saat Aracının en son yayınlandığı tarih ve saat. Aracı hâlâ taslak aşamasındaysa boş/null. 2026-01-15T10:30:00Z Genel kullanılabilir
properties.createdIn dize Aracının oluşturulduğu yazma aracı: Copilot Studio veya Microsoft 365 Copilot Aracı Oluşturucu. Copilot Studio Genel kullanılabilir
properties.schemaName dize Dataverse şema adı. Copilot Studio aracıları ve Microsoft 365 Copilot Aracı Oluşturucu aracıları için kullanılabilir. cr5e3_agentName Genel kullanılabilir
properties.isQuarantined boolean Aracının şu anda karantinaya alınıp alınmadığı. false Önizleme
properties.quarantinedAt tarih saat Aracının en son karantinaya alındığı tarih ve saat. 2026-02-01T08:00:00Z Önizleme
properties.isManaged boolean Aracının yönetilen bir Dataverse çözümünün parçası olup olmadığı. Aracı Oluşturucu'da oluşturulan aracılar için null. false Önizleme

Entra kimlik özellikleri

API alanı yolu Veri türü Açıklama Örnek Durum
properties.botId dize Ortamdaki CDS bot kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.entraAppId dize Varsa aracıyla ilişkili Entra Uygulaması Kayıt Kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.entraAgentId dize Mevcut olduğunda Entra Aracı Kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir
properties.entraAgentBlueprintId dize Varsa Entra Agent Blueprint Kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanılabilir

Not

Tüm kimlik özellikleri her aracı türü için kullanılamaz: entraAppId, eski bir tanımlayıcıdır; daha yeni aracılar entraAgentId ve entraAgentBlueprintId kullanır. Bu alanlar, yalnızca ilgili aracı için geçerli olduğunda doldurulur. Bu kimlik özelliklerinin hiçbiri Microsoft 365 Copilot Aracı Oluşturucu aracıları için geçerli değildir.

Entra kimlik kavramları hakkında daha fazla bilgi edinmek için Copilot Studio için uygulama kaydı, aracı kimlikleri ve kimlik doğrulama bölümüne bakın.

Yapılandırma özellikleri

API alanı yolu Veri türü Açıklama Örnek Durum
properties.orchestration dize Aracının düzenleme modu (Düzenleme modları hakkında daha fazla bilgi edinin). Generative Önizleme
properties.model dize Aracı tarafından kullanılan yapay zeka modeli. gpt-4o Önizleme
properties.authentication dize Aracı için yapılandırılmış kimlik doğrulama modu (Kimlik doğrulama modları hakkında daha fazla bilgi edinin). Microsoft Entra Önizleme
properties.channels dizi Aracının yayınlandığı kanalların görünen adları. ["Teams","SharePoint"] Önizleme
properties.sharedWithViewers nesne Aracının paylaşıldığı tek tek izleyici kullanıcılarının (userCount) ve izleyici gruplarının (groupCount) sayısı. Bir oluşturucu aracı tüm kiracı ile paylaştıysa bir yönetici paylaşımı onaylamamış olsa bile entireTenant değeri true olarak ayarlanır. "groupCount": 0, "userCount": 0, "entireTenant": false Önizleme
properties.sharedWithEditors nesne Aracının paylaşıldığı tek tek düzenleyici kullanıcılarının (userCount) ve düzenleyici gruplarının (groupCount) sayısı. "groupCount": 0, "userCount": 0 Önizleme
properties.capabilitiesCounts nesne Yapılandırılmış her bir yetenek türünün toplam benzersiz sayısı "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Önizleme

Düzenleme modları

properties.orchestration alanı şu değerleri kabul eder:

Value Açıklama
Klasik Aracı, oluşturulmuş diyalog ağaçlarıyla klasik konu tabanlı düzenleme kullanır.
Üretici Aracı, bir yapay zeka modelinin konuları ve eylemleri dinamik olarak seçtiği üretici düzenleme kullanır.

Kimlik doğrulama modları

properties.authentication alanı şu değerleri kabul eder:

Value Açıklama
Hiçbiri Kimlik doğrulaması gerekmez.
Microsoft Entra Microsoft Entra ID aracılığıyla kimlik doğrulama.
Genel OAuth 2.0 Genel bir OAuth 2.0 sağlayıcısı aracılığıyla kimlik doğrulama.

Aracı özellikleri

Bu bölüm, aracının yeteneklerini (araçlar ve bilgi) listeler. Şu anda, yalnızca aracı tarafından kullanılan bağlayıcılar ve aşağıdaki bölümlerde ayrıntılı olarak açıklanan bilgi yapılandırması hakkında ayrıntılı verileri görüntüler.

Envanterde, her bir aracı için her türden en fazla 200 kaynak sınırı bulunmaktadır. Bilinen sınırlamalar hakkında daha fazla bilgi edinin.

Envanter, bir aracı içinde aynı yapılandırmayla iki kez yapılandırdığınız bir Power Platform bağlayıcısı gibi yinelenen kaynakları otomatik olarak kaldırır.

Bağlayıcı özellikleri

Envanter, bir aracıda yapılandırılmış Power Platform bağlayıcılarını içeren powerPlatformConnectors adlı bir dizi içerir. Her bağlayıcı, connectorId (bağlayıcının kaynak kimliğini içeren bir dize; örneğin shared_excelonlinebusiness) ile tanımlanır. Yapılandırılmış her konektör için yapılandırılmış bir operations listesi bulunmaktadır. Liste aşağıdaki özellikleri içerir:

Özellik Veri türü Açıklama Durum
OperationId dize Bağlayıcı içindeki belirli işlemin kimliği; örneğin, AddRowV2 Önizleme
createdBy GUID İşlemi yapılandıran kullanıcı Önizleme
isEnabled boolean Bağlayıcı işleminin şu anda etkinleştirilip etkinleştirilmediği Önizleme
usedAs dize İşlemin kullanımı:
  • Tool genel bir araç olarak yapılandırılmışsa
  • Topic Tool belirli bir konu içinde bir araç olarak yapılandırıldıysa
  • Knowledge bağlayıcı bir bilgi kaynağı olarak yapılandırılmışsa
 Önizleme
requiresEndUserConsent boolean Aracının işlemi gerçekleştirebilmesi için son kullanıcıların önceden onay vermesi gerekip gerekmediği Önizleme
whenCanBeUsed dize İşlem ne zaman çağrılabilir:
  • Anytime aracın aracı için hiçbir kısıtlama olmaksızın kullanılabilir olması durumunda
  • Aracı, yapımcı belirli konularda açıkça yapılandırmışsa kullanıyorsa ViaDirectReferenceOnly
  • Aracı, üretici tarafından önceden tanımlanmış bir mantığa göre kullanabiliyorsa Conditional
 Önizleme
connectionProvider dize İşlem için bağlantıyı kim sağlıyor:
  • User son kullanıcı çalışma zamanında kimlik bilgileri sağlarsa
  • Maker eğer oluşturucu bağlantıyı tasarım zamanında ayarlarsa
 Önizleme
connectionIdSharedByMaker GUID Bağlantı Kimliği, yalnızca connectionProvider = Maker olduğunda doldurulur Önizleme
Örnek
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Bilgi özellikleri

Envanter, bilgi için aşağıdaki özelliği içerir:

Özellik Veri türü Açıklama Çalıştırma Durumu
IsWebSearchEnabledForKnowledge boolean Aracının bir bilgi kaynağı olarak web aramasını kullanıp kullanamayacağını belirten değer Önizleme

Bilinen sınırlamalar

  • V1 aracılar izlenmez - Envanter, orijinal Power Virtual Agents V1 çalışma zamanı ile oluşturulan aracıları içermez. Yalnızca V2 (Copilot Studio) aracılarını izler.
  • Kimlik özellikleri tüm aracılar için kullanılamayabilir - entraAgentId ve entraAgentBlueprintId alanları, yalnızca daha yeni Entra aracı kimliği modeliyle sağlanan aracılar için doldurulur. Eski aracılar yalnızca entraAppId öğesine sahip olabilir ve Microsoft 365 Copilot Aracı Oluşturucu aracıları bu kimlik özelliklerinin hiçbirine sahip değildir.
  • Özellik sayısı: Envanterde, her bir aracı için her türden en fazla 200 kaynak sınırı bulunmaktadır. Bir aracı, belirli bir türden (örneğin Power Platform bağlayıcıları) 200'den fazla yapılandırılmış kaynağa sahipse, envanter rastgele 200 tanesini görüntüler. Yöneticiler, her tür başına bir aracıda kaç kaynağın yapılandırıldığını anlamak için capabilitiesCounts alanını kullanabilirler.

İlgili içerik

  • Last updated on