Microsoft Copilot Studio-Agentbestand

Der Copilot Studio Agentbestand stellt IT- und Sicherheitsadministratoren eine zentrale Ansicht aller Agents bereit, die mit Copilot Studio oder Agent Builder im Mandanten erstellt wurden. Das Inventar umfasst sowohl unveröffentlichte (Entwürfe) als auch veröffentlichte Agenten. Für jeden Agenten werden in der Übersicht wichtige Metadaten angezeigt, z. B. wer den Agenten erstellt hat, wann er zuletzt veröffentlicht wurde, über welche Kanäle er bereitgestellt wird, wie er Benutzer authentifiziert, seine Fähigkeiten und vieles mehr. Bestandsdaten werden automatisch aktualisiert, und Änderungen an einem Agent werden in der Regel innerhalb von 20 Minuten angezeigt.

Administratoren können die Bestandsdaten über mehrere Methoden nutzen, einschließlich des Power Platform Admin Centers, der Power Platform-API und Azure Resource Graph. Eine vollständige Liste der Zugriffsmethoden und erforderlichen Rollen finden Sie unter Power Platform-Inventar.

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.

Hinweis

Das Inventar enthält keine Agents, die mit V1 von Copilot Studio erstellt wurden (auch als klassische Bots oder Power Virtual Agents bezeichnet). Sie können jedoch weiterhin zum Power Platform Admin Center wechseln und Manage>Copilot Studio>Classic Chatbots auswählen, um diese Agents anzuzeigen.

Von Bedeutung

Dieser Artikel enthält die Vorschaudokumentation von Microsoft Copilot Studio und kann geändert werden.

Vorschaufunktionen sind nicht für den Produktionsgebrauch gedacht und verfügen möglicherweise über eingeschränkte Funktionalität. Diese Funktionen stehen vor dem offiziellen Release zur Verfügung, damit Sie früher Zugriff darauf erhalten und Feedback geben können.

Wenn Sie einen produktionsreifen Agenten erstellen, finden Sie weitere Informationen unter Übersicht über Microsoft Copilot Studio.

Agenteigenschaften

Der Bestand stellt die folgenden Eigenschaften für jeden Agent bereit.

Hinweis

  • Das Inventar spiegelt die Struktur der veröffentlichten Version jedes Agenten wider. Wenn ein Agent unveröffentlichte Änderungen hat (einen neueren Entwurf), zeigt das Inventar diese Änderungen erst an, wenn der Agent veröffentlicht wird.

  • Die Konfiguration eines Agents wirkt sich auf die aufgefüllten Felder aus. Einige Eigenschaften können abhängig davon sein null , wie der Agent eingerichtet ist. Beispielsweise ist isManagednull für Agenten, die im Agent Builder erstellt wurden.

Kerneigenschaften

API-Feldpfad Datentyp Description Beispiel Der Status
properties.displayName Schnur Der Anzeigename des Agenten. Customer support agent Allgemein verfügbar
properties.name GUID Die ID des Agents in der spezifischen Dataverse-Umgebung (CDS-Bot-ID). aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.createdAt Datum/Uhrzeit Datum und Uhrzeit der Erstellung des Agents. 2024-12-13T04:00:00Z Allgemein verfügbar
properties.createdBy GUID Entra ID des Benutzers, der den Agent erstellt hat. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.ownerId Schnur Die Objekt-ID (Entra ID) des aktuellen Besitzers des Agents. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.environmentId Schnur Der Bezeichner der Power Platform-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/null, wenn sich der Agent noch im Entwurfsstatus befindet. 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 derzeit unter Quarantäne gestellt wird. false Vorschau
properties.quarantinedAt Datum/Uhrzeit Das Datum und die Uhrzeit, zu der der Agent zuletzt unter Quarantäne gestellt wurde. 2026-02-01T08:00:00Z Vorschau
properties.isManaged Boolescher Wert Gibt an, ob der Agent Teil einer verwalteten Dataverse-Lösung ist. Null für Agents, die im Agent Builder erstellt wurden. false Vorschau

Entra-Identitätseigenschaften

API-Feldpfad Datentyp Description Beispiel Der Status
properties.botId Schnur Die CDS-Bot-ID in der Umgebung. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.entraAppId Schnur Entra App-Registrierungs-ID, die dem Agent zugeordnet ist, wenn vorhanden. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.entraAgentId Schnur Entra Agent Identity-ID, sofern vorhanden. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar
properties.entraAgentBlueprintId Schnur Entra Agent Blueprint ID, wenn vorhanden. aaaa0000-bb11-2222-33cc-444444dddddd Allgemein verfügbar

Hinweis

Nicht alle Identitätseigenschaften sind für alle Agenttypen verfügbar: entraAppId ist ein Legacybezeichner, neuere Agents verwenden entraAgentId und entraAgentBlueprintId. Diese Felder werden nur aufgefüllt, wenn sie für den jeweiligen Agent gelten. Keine dieser Identitätseigenschaften gilt für Microsoft 365 Copilot Agent Builder-Agents.

Weitere Informationen zu Entra-Identitätskonzepten finden Sie unter App-Registrierung, Agentidentitäten und Authentifizierung für Copilot Studio.

Konfigurationseigenschaften

API-Feldpfad Datentyp Description Beispiel Der Status
properties.orchestration Schnur Der Orchestrierungsmodus des Agents (erfahren Sie mehr im Orchestrationsmodus). Generative Vorschau
properties.model Schnur Das vom Agent verwendete KI-Modell. gpt-4o Vorschau
properties.authentication Schnur Der für den Agent konfigurierte Authentifizierungsmodus (weitere Informationen finden Sie im Authentifizierungsmodus). Microsoft Entra Vorschau
properties.channels array Die Anzeigenamen der Kanäle, in die der Agent veröffentlicht wird. ["Teams","SharePoint"] Vorschau
properties.sharedWithViewers Objekt Anzahl der einzelnen Benutzer (userCount) und Betrachtergruppen (groupCount), mit denen der Agent geteilt ist. Wenn ein Ersteller den Agent mandantenweit freigegeben hat, ist entireTenant auf true festgelegt, auch wenn ein Administrator die Freigabe nicht genehmigt hat. "groupCount": 0, "userCount": 0, "entireTenant": false Vorschau
properties.sharedWithEditors Objekt Anzahl einzelner Editorbenutzer (userCount) und Editorgruppen (groupCount) für die der Agent freigegeben wird. "groupCount": 0, "userCount": 0 Vorschau
properties.capabilitiesCounts Objekt Gesamtanzahl der einzelnen konfigurierten Funktionen "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Vorschau

Orchestrierungsmodi

Das properties.orchestration Feld akzeptiert die folgenden Werte:

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

Authentifizierungsmodi

Das properties.authentication Feld akzeptiert die folgenden Werte:

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

Agentenfähigkeiten

In diesem Abschnitt werden die Funktionen (Tools und Kenntnisse) des Agents aufgeführt. Derzeit werden nur detaillierte Daten zu den vom Agenten verwendeten Konnektoren und zu einer Wissenskonfiguration angezeigt, wie in den folgenden Abschnitten beschrieben.

Der Bestand hat eine Beschränkung von maximal 200 Ressourcen jedes Typs pro Agent. Weitere Informationen zu bekannten Einschränkungen.

Der Bestand entfernt automatisch doppelte Ressourcen, z. B. einen Power Platform-Connector, den Sie zweimal in einem Agent mit derselben Konfiguration konfiguriert haben.

Connectoreigenschaften

Das Inventar enthält ein Array namens powerPlatformConnectors, das die in einem Agent konfigurierten Power Platform-Connectors enthält. Jeder Connector wird durch seine connectorId (eine Zeichenfolge mit der Ressourcen-ID des Connectors, z. B. ) shared_excelonlinebusinessidentifiziert. Für jeden konfigurierten Konnektor gibt es eine Liste der konfigurierten operations. Die Liste enthält die folgenden Eigenschaften:

Eigentum Datentyp Description Der Status
OperationId Schnur Die ID des spezifischen Vorgangs innerhalb des Verbinders; Zum Beispiel AddRowV2 Vorschau
createdBy GUID Der Benutzer, der den Vorgang konfiguriert hat Vorschau
isEnabled Boolescher Wert Gibt an, ob der Connector-Vorgang zurzeit aktiviert ist. Vorschau
usedAs Schnur Wie der Vorgang verwendet wird:
  • Tool wenn als allgemeines Tool konfiguriert
  • Topic Tool wenn sie als Tool in einem bestimmten Thema konfiguriert ist
  • Knowledge wenn der Connector als Wissensquelle konfiguriert ist
 Vorschau
requiresEndUserConsent Boolescher Wert Gibt an, ob Endbenutzer zustimmen müssen, bevor der Agent den Vorgang verwenden kann. Vorschau
whenCanBeUsed Schnur Wenn der Vorgang aufgerufen werden kann:
  • Anytime wenn das Tool für den Agent ohne Einschränkungen verfügbar ist
  • ViaDirectReferenceOnly wenn der Agent das Tool nur verwendet, wenn Maker es für bestimmte Themen explizit konfiguriert hat
  • Conditional wenn der Agent das Tool gemäß einer vordefinierten Logik des Herstellers verwenden kann
 Vorschau
connectionProvider Schnur Wer stellt die Verbindung für den Vorgang bereit:
  • User wenn der Endbenutzer zur Laufzeit Anmeldeinformationen bereitstellt
  • Maker wenn der Hersteller die Verbindung beim Erstellen festlegt
 Vorschau
connectionIdSharedByMaker GUID Verbindungs-ID, nur ausgefüllt, wenn connectionProvider = Maker Vorschau

Wissenseigenschaften

Das Inventar enthält die folgende Eigenschaft für Wissen:

Eigentum Datentyp Description Der Status
IsWebSearchEnabledForKnowledge Boolescher Wert True, wenn der Agent die Websuche als Wissensquelle verwenden kann Vorschau

Bekannte Einschränkungen

  • V1-Agents werden nicht nachverfolgt – Das Inventar enthält keine Agents, die mit der ursprünglichen Power Virtual Agents V1-Laufzeit erstellt wurden. Es verfolgt nur V2-Agenten (Copilot Studio).
  • Identitätseigenschaften sind möglicherweise nicht für alle Agents verfügbar – Die entraAgentId Felder entraAgentBlueprintId werden nur für Agents aufgefüllt, die mit dem neueren Entra-Agent-Identitätsmodell bereitgestellt werden. Ältere Agents verfügen möglicherweise nur über entraAppId, und Microsoft 365 Copilot Agent Builder-Agents verfügen nicht über eine dieser Identitätseigenschaften.
  • Anzahl der Fähigkeiten – Das Inventar ist pro Agent auf maximal 200 Ressourcen jedes Typs begrenzt. Wenn ein Agent über mehr als 200 konfigurierte Ressourcen aus einem bestimmten Typ verfügt (z. B. Power Platform-Connectors), zeigt der Bestand zufällige 200 an. Administratoren können das capabilitiesCounts Feld verwenden, um zu verstehen, wie viele Ressourcen in einem Agent pro Typ konfiguriert sind.

Verwandte Inhalte

  • Last updated on