Microsoft Copilot Studio Agentinventering

Den Copilot Studio agentinventeringen ger IT- och säkerhetsadministratörer en centraliserad vy över alla agenter som skapats med Copilot Studio eller Agent Builder i klientorganisationen. Inventeringen omfattar både opublicerade (utkast) och publicerade agenter. För varje agent visar inventeringen viktiga metadata, till exempel vem som skapade agenten, när den senast publicerades, vilka kanaler den distribueras till, hur den autentiserar användare, dess funktioner med mera. Inventeringsdata uppdateras automatiskt och ändringar i en agent visas vanligtvis inom 20 minuter.

Administratörer kan använda inventeringsdata via flera metoder, inklusive administrationscentret för Power Platform, Power Platform-API:et och Azure Resource Graph. En fullständig lista över åtkomstmetoder och nödvändiga roller finns i Power Platform-inventering.

Den här artikeln beskriver de fält som är specifika för Copilot Studio-agenter (microsoft.copilotstudio/agents) i Power Platform-inventeringen. Information om delade fält som är tillgängliga för alla resurstyper finns i Schemareferens för Power Platform-inventering.

Anmärkning

Inventeringen innehåller inte agenter som skapats med V1 av Copilot Studio (även kallade klassiska robotar eller Power Virtual Agents). Du kan dock fortfarande gå till administrationscentret för Power Platform och välja Manage>Copilot Studio>Classic chatbots för att se dessa agenter.

Important

Den här artikeln innehåller dokumentation om förhandsversionen av Microsoft Copilot Studio och kan ändras.

Förhandsgranskningsfunktioner ska inte användas i produktion, och funktionerna kan vara begränsade. Funktionerna är tillgängliga före den officiella publiceringen så att du kan få tidig tillgång och ge feedback.

Om du bygger en produktionsklar agent, se Översikt över Microsoft Copilot Studio.

Agentegenskaper

Inventeringen innehåller följande egenskaper för varje agent.

Anmärkning

  • Inventeringen återspeglar strukturen för den publicerade versionen av varje agent. Om en agent har opublicerade ändringar (ett nyare utkast) visas dessa ändringar inte i inventariet förrän agenten har publicerats.

  • En agent konfiguration påverkar vilka fält som fylls i. Vissa egenskaper kan bero null på hur agenten har konfigurerats. Till exempel är isManagednull för agenter som skapats i Agent Builder.

Kärnegenskaper

API-fältväg Datatyp Description Exempel Status
properties.displayName snöre Agentens visningsnamn. Customer support agent Allmänt tillgängligt
properties.name GUID Agentens ID i den specifika Dataverse-miljön (CDS-robot-ID). aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.createdAt datum och tid Datum och tid då agenten skapades. 2024-12-13T04:00:00Z Allmänt tillgängligt
properties.createdBy GUID Entra ID för användaren som skapade agenten. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.ownerId snöre Objekt-ID (Entra ID) för agentens aktuella ägare. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.environmentId snöre Identifieraren för Den Power Platform-miljö som innehåller resursen. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.lastPublishedAt datum och tid Datum och tid då agenten senast publicerades. Tom/null om agenten fortfarande är i utkast. 2026-01-15T10:30:00Z Allmänt tillgängligt
properties.createdIn snöre Redigeringsverktyget där agenten skapades: Copilot Studio eller Microsoft 365 Copilot Agent Builder. Copilot Studio Allmänt tillgängligt
properties.schemaName snöre Dataverse-schemanamnet. Tillgänglig för Copilot Studio-agenter och Microsoft 365 Copilot Agent Builder-agenter. cr5e3_agentName Allmänt tillgängligt
properties.isQuarantined boolean Om agenten för närvarande är i karantän. false Preview
properties.quarantinedAt datum och tid Datum och tid då agenten senast sattes i karantän. 2026-02-01T08:00:00Z Preview
properties.isManaged boolean Om agenten är en del av en hanterad Dataverse-lösning. Null för agenter som skapats i Agent Builder. false Preview

Egenskaper för Entra-identitet

API-fältväg Datatyp Description Exempel Status
properties.botId snöre CDS-robot-ID:t i miljön. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.entraAppId snöre Entra appregistrerings-ID som är kopplat till agenten, om det finns. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.entraAgentId snöre Identitets-ID för Entra-agent när det finns. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.entraAgentBlueprintId snöre Entra Agent-Blueprint-ID, om det finns. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt

Anmärkning

Alla identitetsegenskaper är inte tillgängliga för alla agenttyper: entraAppId är en äldre identifierare, nyare agenter använder entraAgentId och entraAgentBlueprintId. Dessa fält fylls endast i när det är tillämpligt för den specifika agenten. Ingen av dessa identitetsegenskaper gäller för Microsoft 365 Copilot Agent Builder-agenter.

Mer information om Entra-identitetsbegrepp finns i Appregistrering, agentidentiteter och autentisering för Copilot Studio.

Konfigurationsegenskaper

API-fältväg Datatyp Description Exempel Status
properties.orchestration snöre Orkestreringsläget för agenten (läs mer i Orkestreringslägen). Generative Preview
properties.model snöre AI-modellen som används av agenten. gpt-4o Preview
properties.authentication snöre Autentiseringsläget som konfigurerats för agenten (läs mer i autentiseringslägen). Microsoft Entra Preview
properties.channels matris Visningsnamnen för de kanaler som agenten publiceras till. ["Teams","SharePoint"] Preview
properties.sharedWithViewers object Antal enskilda användare med visningsbehörighet (userCount) och grupper med visningsbehörighet (groupCount) som agenten delas med. Om en skapare delade agenten med hela klientorganisationen, ställs entireTenant in på true, även om en administratör inte godkände delningen. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors object Antal enskilda redigeraranvändare (userCount) och redigeringsgrupper (groupCount) som agenten delas med. "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts object Totalt distinkt antal av varje typ av konfigurerade funktioner "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Orkestreringslägen

Fältet properties.orchestration accepterar följande värden:

Value Description
Classic Agenten använder klassisk ämnesbaserad orkestrering med författade dialogträd.
Generativa Agenten använder generativ orkestrering, där en AI-modell dynamiskt väljer ämnen och åtgärder.

Autentiseringslägen

Fältet properties.authentication accepterar följande värden:

Value Description
None Ingen autentisering krävs.
Microsoft Entra Autentisering via Microsoft Entra-ID.
Generisk OAuth 2.0 Autentisering via en allmän OAuth 2.0-provider.

Agentfunktioner

I det här avsnittet visas agentens funktioner (verktyg och kunskap). För närvarande visas endast detaljerad information om de anslutningar som används av agenten samt om kunskapskonfigurationen, såsom beskrivs i följande avsnitt.

Lagret har en begränsning på högst 200 resurser av varje typ per agent. Läs mer i Kända begränsningar.

Inventeringen tar automatiskt bort dubblettresurser, till exempel en Power Platform-anslutning som du har konfigurerat två gånger i en agent med samma konfiguration.

Anslutningsegenskaper

Inventariet innehåller en array som heter powerPlatformConnectors, som innehåller de Power Platform-anslutningar som har konfigurerats i en agent. Varje anslutningsapp identifieras av dess connectorId (en sträng som innehåller anslutningsappens resurs-ID, till exempel shared_excelonlinebusiness). För varje konfigurerad anslutning finns det en lista med konfigurerade operations. Listan innehåller följande egenskaper:

Fastighet Datatyp Description Status
OperationId snöre ID:t för den specifika åtgärden i anslutningsprogrammet; till exempel AddRowV2 Preview
createdBy GUID Användaren som konfigurerade åtgärden Preview
isEnabled boolean Om anslutningsåtgärden är aktiverad för närvarande Preview
usedAs snöre Så här används åtgärden:
  • Tool om det är konfigurerat som ett allmänt verktyg
  • Topic Tool om det är konfigurerat som ett verktyg i ett specifikt ämne
  • Knowledge om anslutningsappen har konfigurerats som en kunskapskälla
 Preview
requiresEndUserConsent boolean Om slutanvändarna måste samtycka innan agenten kan använda åtgärden Preview
whenCanBeUsed snöre När åtgärden kan anropas:
  • Anytime om verktyget är tillgängligt för agenten utan begränsningar
  • ViaDirectReferenceOnly om agenten endast använder verktyget när tillverkaren uttryckligen konfigurerade det i specifika ämnen
  • Conditional om agenten kan använda verktyget enligt en fördefinierad logik av tillverkaren
 Preview
connectionProvider snöre Vem tillhandahåller anslutningen för åtgärden:
  • User om slutanvändaren tillhandahåller autentiseringsuppgifter under körning
  • Maker om tillverkaren anger anslutningen vid redigeringstillfället
 Preview
connectionIdSharedByMaker GUID Anslutnings-ID, fylls endast i när connectionProvider = Maker Preview

Kunskapsegenskaper

Inventeringen innehåller följande egenskap för kunskap:

Fastighet Datatyp Description Status
IsWebSearchEnabledForKnowledge boolean Sant om agenten kan använda webbsökning som kunskapskälla Preview

Kända begränsningar

  • V1-agenter spåras inte – Lagret innehåller inte agenter som skapats med den ursprungliga Power Virtual Agents V1-körningen. Den spårar bara V2-agenter (Copilot Studio).
  • Identitetsegenskaper kanske inte är tillgängliga för alla agenter – fälten entraAgentId och entraAgentBlueprintId fylls endast i för agenter som har etablerats med den nyare Entra-agentidentitetsmodellen. Äldre agenter kanske bara har entraAppId och Microsoft 365 Copilot Agent Builder-agenter inte har någon av dessa identitetsegenskaper.
  • Antal funktioner – Inventeringen har en begränsning på högst 200 resurser av varje typ per agent. Om en agent har fler än 200 konfigurerade resurser av en viss typ (till exempel Power Platform-anslutningar) visar inventeringen 200 slumpmässigt valda resurser. Administratörer kan använda fältet capabilitiesCounts för att förstå hur många resurser som konfigureras i en agent per typ.

Relaterat innehåll

  • Last updated on