Agentlager i Microsoft Copilot Studio

Copilot Studios agentinventarie ger IT- och säkerhetsadministratörer en centraliserad översikt över alla agenter skapade i Copilot Studio eller Agent Builder i klientorganisationen. Översikten omfattar både opublicerade (utkast) och publicerade agenter. För varje agent visar inventariet viktig metadata, såsom vem som skapade agenten, när den senast publicerades, vilka kanaler den distribueras till, hur den autentiserar användare, dess funktioner och mer. Inventariedata uppdateras automatiskt och ändringar i en agent visas vanligtvis inom 20 minuter.

Administratörer kan använda inventariedata via flera metoder, inklusive Power Platform-administrationscentret, Power Platform API och Azure Resource Graph. För hela listan över åtkomstmetoder och nödvändiga roller, se Power Platform-inventarie.

Den här artikeln beskriver fälten som är specifika för Copilot Studio-agenter (microsoft.copilotstudio/agents) i Power Platform-inventariet. För gemensamma fält som är tillgängliga för alla resurstyper, se Power Platform inventory schema reference.

Kommentar

Inventariet inkluderar inte agenter skapade med V1 av Copilot Studio (även kända som klassiska robotar eller Power Virtual Agents). Du kan dock fortfarande gå till Power Platforms admincenter och välja Hantera>Copilot Studio Classic-chattbotar> för att se dessa agenter.

Viktigt

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 skapar en produktionsklar agent, se översikten över Microsoft Copilot Studio.

Agentegenskaper

Inventariet visar följande egenskaper för varje agent.

Kommentar

Inventariet speglar strukturen för den publicerade versionen av varje agent. Om en agent har opublicerade ändringar (ett nyare utkast) visas dessa ändringar inte i lagret förrän agenten har publicerats.
En agents konfiguration påverkar vilka fält som fylls i. Vissa egenskaper kan vara null beroende på hur agenten är konfigurerad. Exempelvis, isManaged är null för agenter skapade i Agent Builder.

Grundläggande egenskaper

Sökväg för API-fält	Datatyp	beskrivning	Exempel	Tillstånd
`properties.displayName`	sträng	Visningsnamn för agent.	`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`	datetime	Datum och tid när 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`	sträng	Objekt-ID (Entra-ID) för agentens nuvarande ägare.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allmänt tillgängligt
`properties.environmentId`	sträng	Identifieraren för Power Platform-miljön som innehåller resursen.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allmänt tillgängligt
`properties.lastPublishedAt`	datetime	Datum och tid då agenten senast publicerades. Tom/null om agenten fortfarande är ett utkast.	`2026-01-15T10:30:00Z`	Allmänt tillgängligt
`properties.createdIn`	sträng	Författarverktyget där agenten skapades: Copilot Studio eller Microsoft 365 Copilot Agent Builder.	`Copilot Studio`	Allmänt tillgängligt
`properties.schemaName`	sträng	Dataverse-schemanamnet. Tillgänglig för Copilot Studio-agenter och agenter för Microsoft 365 Copilot Agent Builder agents.	`cr5e3_agentName`	Allmänt tillgängligt
`properties.isQuarantined`	boolesk	Huruvida agenten för närvarande är i karantän.	`false`	Förhandsversion
`properties.quarantinedAt`	datetime	Datum och tid då agenten senast sattes i karantän.	`2026-02-01T08:00:00Z`	Förhandsversion
`properties.isManaged`	boolesk	Om agenten är en del av en hanterad Dataverse-lösning. Null för agenter skapade i Agent Builder.	`false`	Förhandsversion

Entra-identitetsegenskaper

Sökväg för API-fält	Datatyp	beskrivning	Exempel	Tillstånd
`properties.botId`	sträng	CDS-robot-ID i miljön.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allmänt tillgängligt
`properties.entraAppId`	sträng	Entra App-registrerings-ID kopplat till agenten, om det finns.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allmänt tillgängligt
`properties.entraAgentId`	sträng	Entra Agent Identity ID, om det finns.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allmänt tillgängligt
`properties.entraAgentBlueprintId`	sträng	Entra Agent Blueprint ID, om det finns.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allmänt tillgängligt

Kommentar

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 de är tillämpliga på den specifika agenten. Ingen av dessa identitetsegenskaper gäller för Microsoft 365 Copilot Agent Builder-agenter.

För att lära dig mer om Entra-identitetsbegrepp, se Appregistrering, agentidentiteter och autentisering för Copilot Studio.

Konfigurationsegenskaper

Sökväg för API-fält	Datatyp	beskrivning	Exempel	Tillstånd
`properties.orchestration`	sträng	Agentens orkestreringsläge (läs mer i Orkestreringslägen).	`Generative`	Förhandsversion
`properties.model`	sträng	AI-modellen som agenten använder.	`gpt-4o`	Förhandsversion
`properties.authentication`	sträng	Det autentiseringsläge som är konfigurerat för agenten (läs mer i Autentiseringslägen).	`Microsoft Entra`	Förhandsversion
`properties.channels`	matris	Visningsnamnen för de kanaler som agenten publiceras i.	`["Teams","SharePoint"]`	Förhandsversion
`properties.sharedWithViewers`	objekt	Antal individuella användare av visningsprogrgam (`userCount`) och visningsprogrammgrupper (`groupCount`) som agenten delas med Om en skapare har delat agenten med hela tenant, sätts `entireTenant` till `true`, även om en administratör inte har godkänt delningen.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Förhandsversion
`properties.sharedWithEditors`	objekt	Antal redigeringsanvändare (`userCount`) och redigeringsgrupper (`groupCount`) som agenten delas med	`"groupCount": 0, "userCount": 0`	Förhandsversion
`properties.capabilitiesCounts`	objekt	Total distinkt antal av varje typ av konfigurerade funktioner	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Förhandsversion

Orkestreringslägen

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

Value	beskrivning
Klassisk	Agenten använder klassisk ämnesbaserad orkestrering med författade dialogträd.
Generativ	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	beskrivning
Ingen	Ingen autentisering krävs.
Microsoft Entra	Autentisering via Microsoft Entra ID.
Allmän OAuth 2.0	Autentisering via en generisk OAuth 2.0-leverantör.

Agentfunktioner

Detta avsnitt listar agentens förmågor (verktyg och kunskap). För närvarande visar den endast detaljerad data om anslutningsprogram som används av agenten och en kunskapskonfiguration som beskrivs i följande avsnitt.

Inventariet har en begränsning på maximalt 200 resurser av varje typ per agent. Läs mer i Kända begränsningar.

Inventariet tar automatiskt bort dubbletter av resurser, såsom ett Power Platform-anslutningsprogram som du har konfigurerat två gånger i en agent med samma konfiguration.

Egenskaper för anslutningsprogram

Inventariet innehåller en array kallad powerPlatformConnectors, som innehåller de Power Platform-anslutningsprogram som är konfigurerade i en agent. Varje anslutningsprogram identifieras av sitt connectorId (en sträng som innehåller anslutningsprograms resurs-ID; till exempel shared_excelonlinebusiness). För varje konfigurerat anslutningsprogram finns det en lista med konfigurerade operations. Listan inkluderar följande egenskaper:

Egenskap	Datatyp	beskrivning	Tillstånd
`OperationId`	sträng	ID:t för den specifika åtgärden i anslutningsprogrammet – till exempel `AddRowV2`	Förhandsversion
`createdBy`	GUID	Användaren som konfigurerade operationen	Förhandsversion
`isEnabled`	boolesk	Om kontaktfunktionen för närvarande är aktiverad	Förhandsversion
`usedAs`	sträng	Hur operationen används: `Tool` om det är konfigurerat som ett allmänt verktyg `Topic Tool` om det är konfigurerat som ett verktyg inom ett specifikt ämne `Knowledge` om anslutningsprogrammet är konfigurerat som en kunskapskälla	Förhandsversion
`requiresEndUserConsent`	boolesk	Om slutanvändare måste samtycka innan agenten kan använda operationen	Förhandsversion
`whenCanBeUsed`	sträng	När operationen kan anropas: `Anytime` om verktyget är tillgängligt för agenten utan begränsningar `ViaDirectReferenceOnly` om agenten använder verktyget endast när tillverkaren uttryckligen konfigurerat det i specifika ämnen `Conditional` om agenten kan använda verktyget enligt en fördefinierad logik av tillverkaren	Förhandsversion
`connectionProvider`	sträng	Vem tillhandahåller anslutningen för åtgärden: `User` om slutanvändaren tillhandahåller inloggningsuppgifter under körning `Maker` om tillverkare anger anslutningen vid skapandet	Förhandsversion
`connectionIdSharedByMaker`	GUID	Anslutnings-ID, anges endast när `connectionProvider = Maker`	Förhandsversion

Exempel

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

Egenskaper för kunskap

Inventeringen inkluderar följande egenskap för kunskap:

Egenskap	Datatyp	beskrivning	Status
`IsWebSearchEnabledForKnowledge`	boolesk	Indikerar om agenten kan använda webbsökning som kunskapskälla	Förhandsversion

Kända begränsningar

V1 agenter spåras inte - Inventariet inkluderar inte agenter skapade med den ursprungliga Power Virtual Agents V1-runtimen. Den spårar bara V2 (Copilot Studio)-agenter.
Identitetsegenskaper kanske inte är tillgängliga för alla agenter – entraAgentId och entraAgentBlueprintId fälten fylls endast i för agenter som är provisionerade med den nyare Entra-agentidentitetsmodellen. Äldre agenter kan endast ha entraAppId, och Microsoft 365 Copilot Agent Builder-agenter har inga 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-anslutningsprogram), visar inventeringen ett slumpmässigt urval av 200. Administratörer kan använda capabilitiesCounts-fältet för att förstå hur många resurser som är konfigurerade i en agent per typ.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-07-30

Agentlager i Microsoft Copilot Studio

Agentegenskaper

Grundläggande egenskaper

Entra-identitetsegenskaper

Konfigurationsegenskaper

Orkestreringslägen

Autentiseringslägen

Agentfunktioner

Egenskaper för anslutningsprogram

Exempel

Egenskaper för kunskap

Kända begränsningar

Relaterat innehåll

Feedback

Ytterligare resurser