Dela via


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 Exempel 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 datetime Datum och tid då agenten senast publicerades. Tom om agenten fortfarande är ett 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 boolesk Om agenten är i karantän. false Preview
properties.quarantinedAt datetime Datum och tid då agenten senast sattes i karantän. 2026-02-01T08:00:00Z Preview
properties.isManaged boolesk Om agenten är en del av en hanterad lösning. false Preview

Identitetsegenskaper

API-fältväg Datatyp Beskrivning Exempel 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, agenter för Agentbyggaren i Microsoft 365 Copilot
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 för Entra-agent. 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 Exempel 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 matris Visningsnamnen för de kanaler som agenten publiceras i. ["Teams","SharePoint"] Preview

Orkestreringslägen

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

Värde 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 .

Värde 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.