inventář agenta Microsoft Copilot Studio

Inventář agenta Copilot Studio poskytuje správcům IT a zabezpečení centralizované zobrazení všech agentů vytvořených pomocí Copilot Studio nebo Agent Builderu v tenantovi. Seznam zahrnuje nepublikované (návrhy) i publikované agenty. U každého agenta přehled zobrazuje klíčová metadata, například kdo agenta vytvořil, kdy byl naposledy publikován, do jakých kanálů je nasazen, jak ověřuje uživatele, jeho funkce a další. Data o inventáři se automaticky aktualizují a změny u agenta se obvykle projeví do 20 minut.

Správci můžou data inventáře využívat několika způsoby, včetně Centra pro správu Power Platform, rozhraní API power platform a Azure Resource Graph. Úplný seznam metod přístupu a požadovaných rolí najdete v inventáři Power Platform.

Tento článek popisuje pole specifická pro agenty Copilot Studio (microsoft.copilotstudio/agents) v inventáři Power Platform. Informace o sdílených polích dostupných pro všechny typy prostředků najdete v referenčních informacích ke schématu inventáře Power Platform.

Note

Inventář nezahrnuje agenty vytvořené pomocí verze 1 Copilot Studio (označované také jako klasické roboty nebo Power Virtual Agents). Přesto ale můžete přejít do centra pro správu Power Platform a výběrem možnosti Manage>Copilot Studio>Klasické chatboty zobrazit tyto agenty.

Important

Tento článek obsahuje dokumentaci Microsoft Copilot Studio Preview a může se změnit.

Funkce náhledu nejsou určeny pro produkční použití a mohou mít omezenou funkčnost. Jsou to funkce, které jsou poskytnuté před oficiálním vydáním, abyste si je mohli co nejdříve vyzkoušet a napsat nám své názory.

Pokud vytváříte agenta připraveného pro produkční prostředí, přečtěte si Přehled Microsoft Copilot Studio.

Vlastnosti agenta

Inventář poskytuje pro každého agenta následující vlastnosti.

Note

Inventář odráží strukturu publikované verze každého agenta. Pokud má agent nepublikované změny (novější koncept), inventář tyto změny nezobrazí, dokud se agent nepublikuje.
Konfigurace agenta ovlivňuje, která pole se vyplní. Některé vlastnosti můžou záviset null na nastavení agenta. Například isManaged je null pro agenty vytvořené v Agent Builderu.

Základní vlastnosti

Cesta pole rozhraní API	Datový typ	Description	Příklad	Status
`properties.displayName`	řetězec	Zobrazovaný název agenta.	`Customer support agent`	Obecně dostupné
`properties.name`	GUID	ID agenta v konkrétním prostředí Dataverse (ID robota CDS).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.createdAt`	datetime	Datum a čas vytvoření agenta	`2024-12-13T04:00:00Z`	Obecně dostupné
`properties.createdBy`	GUID	Entra ID uživatele, který vytvořil agenta.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.ownerId`	řetězec	ID objektu (Entra ID) současného vlastníka agenta.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.environmentId`	řetězec	Identifikátor prostředí Power Platform, které obsahuje prostředek.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.lastPublishedAt`	datetime	Datum a čas posledního publikování agenta. Pokud je agent stále v konceptu, je prázdný/null.	`2026-01-15T10:30:00Z`	Obecně dostupné
`properties.createdIn`	řetězec	Nástroj pro tvorbu, ve kterém byl agent vytvořen: Copilot Studio nebo Microsoft 365 Copilot Agent Builder.	`Copilot Studio`	Obecně dostupné
`properties.schemaName`	řetězec	Název schématu Dataverse. K dispozici pro agenty Copilot Studio a agenty Microsoft 365 Copilot Agent Builder.	`cr5e3_agentName`	Obecně dostupné
`properties.isQuarantined`	boolean	Určuje, jestli je agent momentálně v karanténě.	`false`	Náhled
`properties.quarantinedAt`	datetime	Datum a čas posledního karantény agenta.	`2026-02-01T08:00:00Z`	Náhled
`properties.isManaged`	boolean	Určuje, jestli je agent součástí spravovaného řešení Dataverse. Hodnota null pro agenty vytvořené pomocí nástroje Agent Builder.	`false`	Náhled

Vlastnosti identity Entra

Cesta pole rozhraní API	Datový typ	Description	Příklad	Status
`properties.botId`	řetězec	ID robota CDS v prostředí.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.entraAppId`	řetězec	ID registrace aplikace Entra přidružené k agentu, pokud existuje.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.entraAgentId`	řetězec	ID agenta Entra, pokud existuje.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné
`properties.entraAgentBlueprintId`	řetězec	ID Blueprintu agenta Entra, pokud existuje.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Obecně dostupné

Note

Ne všechny vlastnosti identity jsou k dispozici pro všechny typy agentů: entraAppId je starší identifikátor, novější agenty používají entraAgentId a entraAgentBlueprintId. Tato pole se vyplní pouze v případě, že je to možné pro konkrétního agenta. Žádná z těchto vlastností identity se nevztahuje na agenty Microsoftu 365 Copilot Agent Builderu.

Více informací o identitách agentů a autentizaci ve Copilot Studio.

Vlastnosti konfigurace

Cesta pole rozhraní API	Datový typ	Description	Příklad	Status
`properties.orchestration`	řetězec	Režim orchestrace agenta (další informace najdete v režimech orchestrace).	`Generative`	Náhled
`properties.model`	řetězec	Model AI používaný agentem.	`gpt-4o`	Náhled
`properties.authentication`	řetězec	Režim ověřování nakonfigurovaný pro agenta (další informace najdete v režimech ověřování).	`Microsoft Entra`	Náhled
`properties.channels`	pole	Zobrazované názvy kanálů, do kterých se agent publikuje.	`["Teams","SharePoint"]`	Náhled
`properties.sharedWithViewers`	objekt	Počet uživatelů jednotlivých prohlížečů (`userCount`) a skupin prohlížečů (`groupCount`) se s agentem sdílí. Pokud tvůrce sdílel agenta s celým tenantem, `entireTenant` se nastaví na `true`, i když správce sdílení neschválil.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Náhled
`properties.sharedWithEditors`	objekt	Počet jednotlivých uživatelů editoru () a skupin editoru (`userCountgroupCount`), se kterými se agent sdílí.	`"groupCount": 0, "userCount": 0`	Náhled
`properties.capabilitiesCounts`	objekt	Celkový počet jedinečných hodnot jednotlivých typů nakonfigurovaných funkcí	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Náhled

Režimy orchestrace

Pole properties.orchestration přijímá následující hodnoty:

Value	Description
Classic	Agent používá klasickou orchestraci založenou na tématu s stromy dialogových oken vytvořených autory.
Generativní	Agent používá generativní orchestraci, kdy AI model dynamicky vybírá témata a nástroje.

Režimy ověřování

Pole properties.authentication přijímá následující hodnoty:

Value	Description
None	Nevyžaduje se žádné ověřování.
Microsoft Entra	Ověřování prostřednictvím MICROSOFT Entra ID.
Obecný OAuth 2.0	Ověřování prostřednictvím obecného zprostředkovatele OAuth 2.0

Možnosti agenta

Tato část obsahuje seznam možností (nástrojů a znalostí) agenta. V současné době zobrazuje pouze podrobná data o konektorech používaných agentem a konfiguraci znalostí, jak je podrobně popsáno v následujících částech.

Inventář má omezení maximálně 200 prostředků každého typu na agenta. Přečtěte si další informace o známých omezeních.

Inventář automaticky odebere duplicitní prostředky, například konektor Power Platform, který jste nakonfigurovali dvakrát v agentu se stejnou konfigurací.

Vlastnosti spojnice

Inventář obsahuje pole s názvem powerPlatformConnectors, které obsahuje konektory Power Platform nakonfigurované v agentu. Každý konektor je identifikován svým connectorId (řetězec obsahující ID prostředku konektoru; například shared_excelonlinebusiness). U každého nakonfigurovaného konektoru existuje seznam nakonfigurovaných operations. Seznam obsahuje následující vlastnosti:

Property	Datový typ	Description	Status
`OperationId`	řetězec	ID konkrétní operace v rámci konektoru; Například: `AddRowV2`	Náhled
`createdBy`	GUID	Uživatel, který operaci nakonfiguroval	Náhled
`isEnabled`	boolean	Jestli je operace konektoru aktuálně povolená	Náhled
`usedAs`	řetězec	Jak se operace používá: `Tool` pokud je nakonfigurovaný jako obecný nástroj `Topic Tool` pokud je nakonfigurovaný jako nástroj v konkrétním tématu `Knowledge` Pokud je konektor nakonfigurovaný jako zdroj znalostí	Náhled
`requiresEndUserConsent`	boolean	Jestli koncoví uživatelé musí odsouhlasit, než může agent tuto operaci použít	Náhled
`whenCanBeUsed`	řetězec	Kdy lze operaci vyvolat: `Anytime` pokud je nástroj dostupný pro agenta bez omezení `ViaDirectReferenceOnly` pokud agent nástroj používá pouze v případě, že ho tvůrce explicitně nakonfiguroval v konkrétních tématech `Conditional` pokud agent může nástroj používat podle předdefinované logiky tvůrcem	Náhled
`connectionProvider`	řetězec	Kdo poskytuje připojení pro operaci: `User` Pokud koncový uživatel za běhu poskytne přihlašovací údaje `Maker` Pokud tvůrce nastaví připojení při vytváření	Náhled
`connectionIdSharedByMaker`	GUID	ID připojení, vyplněné pouze v případě, že `connectionProvider = Maker`	Náhled

Příklad

{
  "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
    }
  }
}

Vlastnosti znalostí

Inventář obsahuje následující vlastnost pro znalosti:

Property	Datový typ	Description	Status
`IsWebSearchEnabledForKnowledge`	boolean	True, pokud agent může použít vyhledávání na webu jako zdroj znalostí	Náhled

Známá omezení

Agenti V1 nejsou sledováni – Inventář nezahrnuje agenty vytvořené s původním modulem runtime Power Virtual Agents V1. Sleduje pouze agenty V2 (Copilot Studio).
Vlastnosti identity nemusí být dostupné u všech agentů – Pole entraAgentId a entraAgentBlueprintId jsou vyplněna pouze u agentů, kteří byli nasazeni s novějším modelem ID agenta Entra. Starší agenti můžou mít jenom entraAppId a agenti Agent Builderu Microsoft 365 Copilot nemají žádné z těchto vlastností identity.
Počet schopností – Inventář má omezení maximálně 200 prostředků každého typu na agenta. Pokud má agent více než 200 nakonfigurovaných prostředků z určitého typu (například konektorů Power Platform), inventář zobrazí náhodných 200. Správci můžou pomocí capabilitiesCounts pole zjistit, kolik prostředků je nakonfigurovaných v agentu podle typu.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-08-27

inventář agenta Microsoft Copilot Studio

Vlastnosti agenta

Základní vlastnosti

Vlastnosti identity Entra

Vlastnosti konfigurace

Režimy orchestrace

Režimy ověřování

Možnosti agenta

Vlastnosti spojnice

Příklad

Vlastnosti znalostí

Známá omezení

Související obsah

Váš názor

Další materiály