Inventář agenta v nástroji Microsoft Copilot Studio

Inventář agentů Copilot Studio poskytuje IT a bezpečnostním administrátorům centralizovaný přehled všech agentů vytvořených pomocí Copilot Studio nebo Agent Builderu v rámci klienta. Inventář zahrnuje jak agenty ve stavu návrhu (nepublikované), tak publikované agenty. U každého agenta inventář zobrazuje klíčová metadata, jako je kdo agenta vytvořil, kdy byl naposledy publikován, na jaké kanály je nasazen, jak autentizuje uživatele, jeho schopnosti a další. Data inventáře se automaticky obnovují a změny u agenta se obvykle objeví do 20 minut.

Administrátoři mohou přistupovat k datům inventáře několika způsoby, včetně administrátorského centra Power Platform, Power Platform API a Azure Resource Graph. Pro úplný seznam přístupových metod a požadovaných rolí viz inventář Power Platform.

Tento článek popisuje pole specifická pro agenty Copilot Studio (microsoft.copilotstudio/agents) v inventáři Power Platform. Pro sdílená pole dostupná pro všechny typy zdrojů viz referenční schéma inventáře Power Platform.

Poznámka

Inventář nezahrnuje agenty vytvořené ve verzi V1 Copilot Studio (také známé jako klasičtí roboti nebo Power Virtual Agents). Nicméně stále můžete přejít do administračního centra Power Platform a vybrat Spravovat>Copilot Studio>Classic chatboti, abyste tyto agenty viděli.

Důležité

Tento článek obsahuje dokumentaci k funkcím Preview v řešení Microsoft Copilot Studio a může se změnit.

Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. 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 do provozního prostředí, podívejte se do tématu Přehled řešení Microsoft Copilot Studio.

Vlastnosti agenta

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

Poznámka

  • Inventář odráží strukturu publikované verze každého agenta. Pokud má agent nepublikované změny (novější koncept), v přehledu se tyto změny nezobrazí, dokud nebude agent publikován.

  • Konfigurace agenta ovlivňuje, která pole jsou vyplněna. Některé vlastnosti mohou být null v závislosti na tom, jak je agent nastavený. Například isManaged má hodnotu null pro agenty vytvořené v Agent Builderu.

Základní vlastnosti

Cesta pole API Datový typ Description Příklad Průběh
properties.displayName string Zobrazovaný název agenta. Customer support agent Obecně dostupné
properties.name GUID ID agenta v konkrétním prostředí Dataverse (CDS robot ID). aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.createdAt datetime Datum a čas, kdy byl agent vytvořen. 2024-12-13T04:00:00Z Obecně dostupné
properties.createdBy GUID Entra ID uživatele, který agenta vytvořil. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.ownerId string ID objektu (Entra ID) aktuálního vlastníka agenta. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.environmentId string Identifikátor prostředí Power Platform, ve kterém se tento zdroj nachází. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.lastPublishedAt datetime Datum a čas, kdy byl agent naposledy publikován. Prázdné nebo null, pokud je agent stále v konceptu. 2026-01-15T10:30:00Z Obecně dostupné
properties.createdIn string Nástroj pro tvorbu agenta, ve kterém byl agent vytvořen: Copilot Studio nebo Microsoft 365 Copilot Agent Builder. Copilot Studio Obecně dostupné
properties.schemaName string Název schématu Dataverse. Dostupné pro agenty Copilot Studio a agenty Microsoft 365 Copilot Agent Builder. cr5e3_agentName Obecně dostupné
properties.isQuarantined logická hodnota Zda je agent aktuálně v karanténě. false Preview
properties.quarantinedAt datetime Datum a čas, kdy byl agent naposledy v karanténě. 2026-02-01T08:00:00Z Preview
properties.isManaged logická hodnota Jestli je agent součástí spravovaného řešení Dataverse. Null pro agenty vytvořené v Agent Builderu. false Preview

Vlastnosti identity Entra

Cesta pole API Datový typ Description Příklad Průběh
properties.botId string ID CDS robota v prostředí. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.entraAppId string ID registrace aplikace v systému Entra přidružené k agentovi, pokud existuje. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.entraAgentId string ID identity agenta v Entra, pokud existuje. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné
properties.entraAgentBlueprintId string ID konceptu agenta v Entra, pokud existuje. aaaa0000-bb11-2222-33cc-444444dddddd Obecně dostupné

Poznámka

Ne všechny vlastnosti identity jsou dostupné pro všechny typy agentů: entraAppId je starší identifikátor, novější agenti používají entraAgentId a entraAgentBlueprintId. Tato pole jsou vyplněna pouze pokud se vztahují na konkrétního agenta. Žádné z těchto vlastností identity se nevztahují na agenty v nástroji Microsoft 365 Copilot Agent Builder.

Pro více informací o konceptech identity Entra viz Registrace aplikací, identity agentů a autentizace pro Copilot Studio.

Vlastnosti konfigurace

Cesta pole API Datový typ Description Příklad Průběh
properties.orchestration string Režim orchestrace agenta (více informací v režimech orchestrace). Generative Preview
properties.model string AI model používaný agentem. gpt-4o Preview
properties.authentication string Autentizační režim nastavený pro agenta (více informací v Autentizačních režimech). Microsoft Entra Preview
properties.channels pole Zobrazované názvy kanálů, do kterých se agent publikuje. ["Teams","SharePoint"] Preview
properties.sharedWithViewers objekt Počet jednotlivých uživatelů v roli prohlížečů (userCount) a skupin prohlížečů (groupCount), se kterými je agent sdílen Pokud tvůrce sdílel agenta s celým klientem, vlastnost entireTenant je nastavena na true, a to i v případě, že správce toto sdílení neschválil. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors objekt Počet jednotlivých editorů (userCount) a skupin editorů (groupCount), se kterými je agent sdílen "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts objekt Celkový počet jedinečných výskytů každého typu nakonfigurovaných funkcí "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Režimy orchestrace

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

Hodnota Popis
Klasický Agent používá klasickou orchestraci založenou na tématu s vytvořenými stromy dialogových oken.
Generativní Agent používá generativní orchestraci, kdy AI model dynamicky vybírá témata a akce.

Režimy ověřování

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

Hodnota Popis
Žádné Nevyžaduje se žádné ověření.
Microsoft Entra Ověřování pomocí Microsoft Entra ID.
Obecné OAuth 2.0 Ověřování prostřednictvím obecného poskytovatele OAuth 2.0.

Možnosti agenta

Tato sekce uvádí schopnosti (nástroje a znalosti) agenta. V současnosti zobrazuje pouze podrobná data o konektorech používaných agentem a konfiguraci znalostí, jak je podrobně popsáno v následujících sekcích.

Inventář má omezení maximálně 200 zdrojů každého typu pro každého agenta. Další informace v Známá omezení.

Inventář automaticky odstraňuje duplicitní zdroje, například konektor Power Platform, který jste konfigurovali dvakrát v agentu se stejnou konfigurací.

Vlastnosti konektorů

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

Vlastnost Datový typ Popis Průběh
OperationId string ID konkrétní operace uvnitř konektoru; například AddRowV2 Preview
createdBy GUID Uživatel, který operaci konfiguroval Preview
isEnabled logická hodnota Zda je operace konektoru aktuálně povolena Preview
usedAs string Jak se operace používá:
  • Tool pokud je nakonfigurován jako obecný nástroj
  • Topic Tool pokud je nakonfigurován jako nástroj v konkrétním tématu
  • Knowledge pokud je konektor nakonfigurován jako zdroj znalostí
 Preview
requiresEndUserConsent logická hodnota Zda musí koncoví uživatelé souhlasit, než agent může operaci použít Preview
whenCanBeUsed string Když lze operaci vyvolat:
  • Anytime Pokud je nástroj agentovi dostupný bez omezení
  • ViaDirectReferenceOnly pokud agent používá nástroj pouze tehdy, když jej tvůrce výslovně nakonfiguroval v konkrétních tématech
  • Conditional pokud agent může použít nástroj podle předem definované logiky tvůrce
 Preview
connectionProvider string Kdo poskytuje spojení pro operaci:
  • User pokud koncový uživatel zadává přihlašovací údaje za běhu
  • Maker, pokud tvůrce nastaví připojení při vytváření
 Preview
connectionIdSharedByMaker GUID ID připojení, je vyplněno pouze tehdy, když connectionProvider = Maker Preview
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í

Přehled obsahuje následující vlastnost pro znalosti:

Vlastnost Datový typ Popis Stav
IsWebSearchEnabledForKnowledge logická hodnota Pravda, pokud agent může použít webové vyhledávání jako zdroj vědomostí Preview

Známá omezení

  • Agenti V1 nejsou sledováni – Inventář nezahrnuje agenty vytvořené s původním běhovým prostředím 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 identity agenta Entra. Starší agenti mohou mít pouze entraAppId, zatímco agenti Microsoft 365 Copilot Agent Builder nemají žádné z těchto vlastností identity.
  • Počet schopností - Inventář má omezení maximálně 200 zdrojů každého typu pro každého agenta. Pokud má agent více než 200 nakonfigurovaných zdrojů určitého typu (například konektory Power Platform), inventář zobrazí náhodných 200. Administrátoři mohou použít pole capabilitiesCounts k pochopení, kolik zdrojů je v agentu konfigurováno podle typu.

Související obsah

  • Last updated on