Inventeringsschema för Copilot Studio-agenter

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. En översikt över inventeringsfunktionen finns i Power Platform-inventering.

Kärnegenskaper

API-fältväg Datatyp Beskrivning Example Status
properties.ownerId snöre Resursägarens objekt-ID. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.environmentId snöre Identifieraren för miljön som innehåller resursen. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt
properties.lastPublishedAt tidpunkt Datum och tid då agenten senast publicerades. Tom 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 är i karantän. false Preview
properties.quarantinedAt tidpunkt 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 lösning. false Preview

Identitetsegenskaper

API-fältväg Datatyp Beskrivning Example Status Tillgänglig för
properties.botId snöre CDS-robot-ID:t i miljön. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt Copilot Studio-agenter, Microsoft 365 Copilot Agent Builder-agenter
properties.entraAppId snöre Registrerings-ID:t för Entra-appen. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt Copilot Studio agenter
properties.entraAgentId snöre Identitets-ID:t för Entra-agenten. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt Copilot Studio agenter
properties.entraAgentBlueprintId snöre Skiss-ID:t för Entra-agenten. aaaa0000-bb11-2222-33cc-444444dddddd Allmänt tillgängligt Copilot Studio agenter

Anmärkning

Fältet entraAppId är en äldre identifierare. Nyare agenter använder entraAgentId och entraAgentBlueprintId i stället. Ingen av dessa identitetsegenskaper gäller för Microsoft 365 Copilot Agent Builder-agenter.

Konfigurationsegenskaper

API-fältväg Datatyp Beskrivning Example Status
properties.orchestration snöre Orkestreringsläget för agenten (se 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 (se Autentiseringslägen). Microsoft Entra Preview
properties.channels array Visningsnamnen för de kanaler som agenten publiceras till. ["Teams","SharePoint"] Preview

Orkestreringslägen

Följande värden är möjliga för fältet properties.orchestration .

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

Autentiseringslägen

Följande värden är möjliga för fältet properties.authentication .

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

Kända begränsningar

  • V1-agenter spåras inte. Agenter som skapats med den ursprungliga Power Virtual Agents V1-körmiljön tas inte med i inventeringen. Endast V2-agenter (Copilot Studio) spåras.
  • 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 har inte någon av dessa identitetsegenskaper.