Copilot Studio-Agenteninventarschema

In diesem Artikel werden die für Copilot Studio-Agents (microsoft.copilotstudio/agents) spezifischen Felder im Power Platform-Bestand beschrieben. Informationen zu freigegebenen Feldern, die für alle Ressourcentypen verfügbar sind, finden Sie unter Power Platform-Bestandsschemareferenz. Eine Übersicht über das Inventarfeature finden Sie unter Power Platform-Bestand.

Kerneigenschaften

API-Feldpfad Datentyp Description Beispiel Status
properties.ownerId Schnur Die Objekt-ID des Ressourcenbesitzers. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.environmentId Schnur Der Bezeichner der Umgebung, die die Ressource enthält. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.lastPublishedAt Datum/Uhrzeit Datum und Uhrzeit der letzten Veröffentlichung des Agents. Leer, wenn der Agent noch im Entwurf ist. 2026-01-15T10:30:00Z Allgemein verfügbar
properties.createdIn Schnur Das Erstellungstool, in dem der Agent erstellt wurde: Copilot Studio oder Microsoft 365 Copilot Agent Builder. Copilot Studio Allgemein verfügbar
properties.schemaName Schnur Der Name des Dataverse-Schemas. Verfügbar für Copilot Studio-Agents und Microsoft 365 Copilot Agent Builder-Agents. cr5e3_agentName Allgemein verfügbar
properties.isQuarantined Boolescher Wert Gibt an, ob der Agent unter Quarantäne gestellt wird. false Preview
properties.quarantinedAt Datum/Uhrzeit Das Datum und die Uhrzeit, zu der der Agent zuletzt unter Quarantäne gestellt wurde. 2026-02-01T08:00:00Z Preview
properties.isManaged Boolescher Wert Gibt an, ob der Agent Teil einer verwalteten Lösung ist. false Preview

Identitätseigenschaften

API-Feldpfad Datentyp Description Beispiel Status Verfügbar für
properties.botId Schnur Die CDS-Bot-ID in der Umgebung. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar Copilot Studio-Agenten, Microsoft 365 Copilot Agent Builder-Agenten
properties.entraAppId Schnur Die Entra App-Registrierungs-ID. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar Copilot Studio-Agenten
properties.entraAgentId Schnur Die Entra-Agent-Identitäts-ID. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar Copilot Studio-Agenten
properties.entraAgentBlueprintId Schnur Die Entra-Agent-Blueprint-ID. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar Copilot Studio-Agenten

Note

Das entraAppId Feld ist ein Legacy-Bezeichner. Neuere Agents verwenden entraAgentId und entraAgentBlueprintId stattdessen. Keine dieser Identitätseigenschaften gilt für Microsoft 365 Copilot Agent Builder-Agents.

Konfigurationseigenschaften

API-Feldpfad Datentyp Description Beispiel Status
properties.orchestration Schnur Der Orchestrierungsmodus des Agents (siehe Orchestrationsmodi). Generative Preview
properties.model Schnur Das vom Agent verwendete KI-Modell. gpt-4o Preview
properties.authentication Schnur Der für den Agent konfigurierte Authentifizierungsmodus (siehe Authentifizierungsmodi). Microsoft Entra Preview
properties.channels array Die Anzeigenamen der Kanäle, in die der Agent veröffentlicht wird. ["Teams","SharePoint"] Preview

Orchestrierungsmodi

Die folgenden Werte sind für das properties.orchestration Feld möglich.

Wert Description
Classic Der Agent verwendet klassische, themenbasierte Orchestrierung mit erstellten Dialogbäumen.
Generative Der Agent verwendet generative Orchestrierung, bei der ein KI-Modell Themen und Aktionen dynamisch auswählt.

Authentifizierungsmodi

Die folgenden Werte sind für das properties.authentication Feld möglich.

Wert Description
None Keine Authentifizierung erforderlich.
Microsoft Entra Authentifizierung über Microsoft Entra ID.
Generic OAuth 2.0 Authentifizierung über einen generischen OAuth 2.0-Anbieter.

Bekannte Einschränkungen

  • V1-Agenten werden nicht nachverfolgt. Agents, die mit der ursprünglichen Power Virtual Agents V1-Laufzeit erstellt wurden, sind nicht im Bestand enthalten. Nur V2(Copilot Studio)-Agents werden nachverfolgt.
  • Identitätseigenschaften sind möglicherweise nicht für alle Agents verfügbar. Die Felder entraAgentId und entraAgentBlueprintId werden nur für Agenten aufgefüllt, die mit dem neueren Entra-Agenten-Identitätsmodell bereitgestellt wurden. Ältere Agents haben möglicherweise nur entraAppId, und Microsoft 365 Copilot Agent Builder-Agents verfügen über keine dieser Identitätseigenschaften.