Microsoft Copilot Studio Aracısı envanteri

Copilot Studio aracı envanteri, BT ve güvenlik yöneticilerine kiracıda Copilot Studio veya Aracı Oluşturucusu kullanılarak oluşturulan tüm aracıların merkezi bir görünümünü sağlar. Envanter hem yayımlanmamış (taslak) hem de yayımlanmış aracıları kapsar. Her aracı için envanter aracıyı kimin oluşturduğu, en son ne zaman yayımlandığı, dağıtıldığı kanallar, kullanıcıların kimliğinin nasıl doğrulandığı, özellikleri ve daha fazlası gibi önemli meta verileri görüntüler. Envanter verileri otomatik olarak yenilenir ve aracıda yapılan değişiklikler genellikle 20 dakika içinde görünür.

Yöneticiler stok verilerini Power Platform yönetim merkezi, Power Platform API'si ve Azure Kaynak Grafı gibi birden çok yöntemle kullanabilir. Erişim yöntemlerinin ve gerekli rollerin tam listesi için bkz. Power Platform envanteri.

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

Note

Envanter, Copilot Studio V1 ile oluşturulan aracıları (Klasik botlar veya Power Virtual Agents olarak da bilinir) içermez. Ancak yine de Power Platform yönetim merkezine gidip Manage>Copilot Studio>Classic chatbots öğesini seçerek aracıları görebilirsiniz.

Important

Bu makale Microsoft Copilot Studio önizleme belgelerini içerir ve değiştirilebilir.

Ö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 bkz. Microsoft Copilot Studio Overview.

Ajans özellikleri

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

Note

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

  • Ajanın yapılandırması, hangi alanların doldurulacağını etkiler. Bazı özellikler, aracının nasıl ayarlandığına bağlı olarak null olabilir. Örneğin, Agent Builder’da oluşturulan ajanlar için isManaged, null’dir.

Temel özellikler

API alan yolu Veri türü Description Example Statü
properties.displayName string Aracının görünen adı. Customer support agent Genel kullanıma sunuldu
properties.name GUID Temsilcinin belirli Dataverse ortamındaki kimliği (CDS bot kimliği). aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.createdAt datetime Aracının oluşturulduğu tarih ve saat. 2024-12-13T04:00:00Z Genel kullanıma sunuldu
properties.createdBy GUID Aracı oluşturan kullanıcının Entra ID'si. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.ownerId string Aracının mevcut sahibinin nesne kimliği (Entra ID). aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.environmentId string Kaynağı içeren Power Platform ortamının tanımlayıcısı. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.lastPublishedAt datetime 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ıma sunuldu
properties.createdIn string Aracının oluşturulduğu yazma aracı: Copilot Studio veya Microsoft 365 Copilot Agent Builder. Copilot Studio Genel kullanıma sunuldu
properties.schemaName string Dataverse şema adı. Copilot Studio aracıları ve Microsoft 365 Copilot Agent Builder aracıları için kullanılabilir. cr5e3_agentName Genel kullanıma sunuldu
properties.isQuarantined boolean Ajanın şu anda karantinaya alınıp alınmadığı. false Önizle
properties.quarantinedAt datetime Aracının en son karantinaya alındığı tarih ve saat. 2026-02-01T08:00:00Z Önizle
properties.isManaged boolean Aracının yönetilen bir Dataverse çözümünün parçası olup olmadığı. Agent Builder'da oluşturulan aracılar için null. false Önizle

Entra kimlik özellikleri

API alan yolu Veri türü Description Example Statü
properties.botId string Ortamdaki CDS bot kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.entraAppId string Varsa aracıyla ilişkili Entra Uygulaması Kayıt Kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.entraAgentId string Varsa Entra Ajan Kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu
properties.entraAgentBlueprintId string Varsa Entra Aracı Blueprint Kimliği. aaaa0000-bb11-2222-33cc-444444dddddd Genel kullanıma sunuldu

Note

Kimlik özelliklerinin tümü tüm agent türleri için kullanılabilir değildir: entraAppId eski bir tanımlayıcıdır, daha yeni agent'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 Agent Builder aracıları için geçerli değildir.

Copilot Studio'da Ajan kimlikleri ve kimlik doğrulama hakkında daha fazla bilgi edinin.

Yapılandırma özellikleri

API alan yolu Veri türü Description Example Statü
properties.orchestration string Aracının orkestrasyon modu (Orkestrasyon modları bölümünde daha fazla bilgi bulabilirsiniz). Generative Önizle
properties.model string Aracı tarafından kullanılan yapay zeka modeli. gpt-4o Önizle
properties.authentication string Aracı için yapılandırılan kimlik doğrulama modu ( Kimlik doğrulama modları bölümünde daha fazla bilgi edinin). Microsoft Entra Önizle
properties.channels Dizi Aracının yayınlandığı kanalların görünen adları. ["Teams","SharePoint"] Önizle
properties.sharedWithViewers Obje 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ıyı kiracının tamamıyla paylaştıysa, yönetici paylaşımı onaylamamış olsa bile entireTenant, true olarak ayarlanır. "groupCount": 0, "userCount": 0, "entireTenant": false Önizle
properties.sharedWithEditors Obje 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 Önizle
properties.capabilitiesCounts Obje Yapılandırılmış her bir yetenek türünün toplam benzersiz sayısı "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Önizle

Düzenleme modları

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

Değer Description
Classic Ajan, hazırlanan diyalog ağaçlarıyla klasik konu tabanlı orkestrasyon kullanır.
Generatif Ajan, bir yapay zeka modelinin konuları ve araçları dinamik olarak seçtiği üretken orkestrasyon kullanır.

Kimlik doğrulama modları

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

Değer Description
Hiçbiri Kimlik doğrulaması gerekmez.
Microsoft Entra Microsoft Entra Kimliği aracılığıyla kimlik doğrulaması.
Genel OAuth 2.0 Genel bir OAuth 2.0 sağlayıcısı aracılığıyla kimlik doğrulaması.

Aracı özellikleri

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

Envanter, ajan başına her türden en fazla 200 kaynakla sınırlıdır. Bilinen sınırlamalar bölümünde daha fazla bilgi edinin.

Envanter, aynı yapılandırmaya sahip bir aracıda iki kez yapılandırdığınız 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ı kendi connectorId tarafından tanımlanır (bağlayıcının kaynak kimliğini içeren bir dize; örneğin, shared_excelonlinebusiness). 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:

Property Veri türü Description Statü
OperationId string Bağlayıcı içindeki belirli işlemin kimliği; örneğin, AddRowV2 Önizle
createdBy GUID İşlemi yapılandıran kullanıcı Önizle
isEnabled boolean Bağlayıcı işleminin şu anda etkin olup olmadığı Önizle
usedAs string İşlem nasıl kullanılır:
  • Tool genel bir araç olarak yapılandırıldıysa
  • Topic Tool belirli bir konuda araç olarak yapılandırıldıysa
  • Knowledge bağlayıcı bilgi kaynağı olarak yapılandırıldıysa
 Önizle
requiresEndUserConsent boolean Aracının işlemi gerçekleştirebilmesi için son kullanıcıların önceden onay vermesi gerekip gerekmediği Önizle
whenCanBeUsed string İşlem ne zaman çağrılabilir:
  • Anytime araç, temsilci tarafından herhangi bir sınırlama olmaksızın kullanılabiliyorsa
  • 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
 Önizle
connectionProvider string İşlem için bağlantıyı sağlayan kişi:
  • User son kullanıcı çalışma zamanında kimlik bilgilerini sağlıyorsa
  • Maker oluşturucu, bağlantıyı yazma zamanında ayarlarsa
 Önizle
connectionIdSharedByMaker GUID Bağlantı kimliği, yalnızca connectionProvider = Maker olduğunda doldurulur Önizle
Example
{
  "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:

Property Veri türü Description Statü
IsWebSearchEnabledForKnowledge boolean Aracı web aramasını bilgi kaynağı olarak kullanabiliyorsa true Önizle

Bilinen sınırlamalar

  • V1 aracıları izlenmez - Envanter, özgün Power Virtual Agents V1 çalışma zamanıyla 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 özelliğine sahip olabilir ve Microsoft 365 Copilot Agent Builder 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ının belirli bir türden (örneğin, Power Platform bağlayıcıları) 200’den fazla yapılandırılmış kaynağı varsa, envanter bunlardan rastgele 200 tanesini görüntüler. Yöneticiler, bir aracıda capabilitiesCounts tür başına kaç kaynak yapılandırıldığını anlamak için alanını kullanabilir.

İlgili içerik

  • Last updated on