Häufig gestellte Fragen zu Agent-Bestand in Microsoft Copilot Studio

Das Copilot Studio Agenteninventar bietet IT- und Sicherheitsadministratoren eine zentrale Übersicht aller mit Copilot Studio oder Agent Builder im Mandant erstellten Agenten. Das Inventar umfasst sowohl unveröffentlichte (Entwurfs-) als auch veröffentlichte Agenten. Für jeden Agenten zeigt das Inventar wichtige Metadaten an, wie zum Beispiel, wer den Agenten erstellt hat, wann er zuletzt veröffentlicht wurde, auf welche Kanäle er bereitgestellt wurde, wie er Nutzer authentifiziert, seine Fähigkeiten und mehr. Inventardaten werden automatisch aktualisiert, und Änderungen an einem Agenten erscheinen in der Regel innerhalb von 20 Minuten.

Administratoren können auf die Inventardaten über verschiedene Methoden zugreifen, einschließlich des Power Platform Admin Center, der Power Platform API und des Azure Resource Graph. Für die vollständige Liste der Zugriffsmethoden und erforderlichen Rollen siehe Power Platform Inventar.

In diesem Artikel werden die spezifischen Felder für Copilot Studio-Agenten (microsoft.copilotstudio/agents) im Power Platform-Inventar beschrieben. Für Felder, die für alle Ressourcentypen verfügbar sind, finden Sie unter Power Platform Inventory Schema Reference.

Anmerkung

Das Inventar enthält keine Agenten, die mit V1 von Copilot Studio (auch bekannt als Classic Bots oder Power Virtual Agents) erstellt wurden. Sie können aber immer noch zum Power Platform Admin Center gehen und Verwalten>Copilot Studio>Klassischer Chatbot auswählen, um diese Agenten zu sehen.

Wichtig

Dieser Artikel enthält Dokumentation zur Vorschauversion von Microsoft Copilot Studio und kann noch geändert werden.

Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor dem offiziellen Release zur Verfügung, damit Sie früher Zugriff darauf erhalten und Feedback geben können.

Weitere Informationen zur Erstellung eines produktionsbereiten Agenten finden Sie unter Übersicht über Microsoft Copilot Studio.

Agent-Eigenschaften

Das Inventar stellt die folgenden Eigenschaften für jeden Agent bereit.

Anmerkung

Das Inventar spiegelt die Struktur der veröffentlichten Version jedes Agenten wider. Wenn ein Agent unveröffentlichte Änderungen hat (ein neuerer Entwurf), zeigt das Inventar diese Änderungen erst an, wenn der Agent veröffentlicht ist.
Die Konfiguration eines Agenten bestimmt, welche Felder befüllt werden. Einige Eigenschaften können null sein, abhängig davon, wie der Agent eingerichtet ist. Zum Beispiel ist es für Agenten, isManaged die in Agent Builder erstellt wurden null .

Kerneigenschaften

API-Feldpfad	Datentyp	Beschreibung	Beispiel	Status
`properties.displayName`	string	Anzeigename des Agents.	`Customer support agent`	Allgemein verfügbar
`properties.name`	GUID	Die ID des Agenten in der spezifischen Dataverse-Umgebung (CDS-Bot-ID).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar
`properties.createdAt`	DateTime	Datum und Uhrzeit der Agenterstellung.	`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`	string	Die Objekt-ID (Entra-ID) des aktuellen Besitzers des Agenten.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar
`properties.environmentId`	string	Die Kennung der Power Platform-Umgebung, in der sich die Ressource befindet.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar
`properties.lastPublishedAt`	DateTime	Datum und Uhrzeit der letzten Veröffentlichung des Agents. Leer/null, wenn sich der Agent noch im Entwurf befindet.	`2026-01-15T10:30:00Z`	Allgemein verfügbar
`properties.createdIn`	string	Das Authoring-Tool, in dem der Agent erstellt wurde: Copilot Studio oder Microsoft 365 Copilot Agent Builder.	`Copilot Studio`	Allgemein verfügbar
`properties.schemaName`	string	Name des Dataverse-Schemas Verfügbar für Copilot Studio-Agenten und Microsoft 365 Copilot Agent Builder-Agenten.	`cr5e3_agentName`	Allgemein verfügbar
`properties.isQuarantined`	boolesch	Ob der Agent derzeit unter Quarantäne steht.	`false`	Vorschauversion
`properties.quarantinedAt`	DateTime	Datum und Uhrzeit der letzten Quarantäne des Agents.	`2026-02-01T08:00:00Z`	Vorschauversion
`properties.isManaged`	boolesch	Gibt an, ob der Agent Teil einer verwalteten Dataverse Lösung ist. Null für Agenten, die im Agent Builder erstellt wurden.	`false`	Vorschauversion

Entra-Identitätseigenschaften

API-Feldpfad	Datentyp	Beschreibung	Beispiel	Status
`properties.botId`	string	Die CDS-Bot-ID in der Umgebung.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar
`properties.entraAppId`	string	Entra App Registrierungs-ID, die mit dem Agenten verknüpft ist, sofern vorhanden.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar
`properties.entraAgentId`	string	Entra Agent Identitäts-ID, wenn vorhanden.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar
`properties.entraAgentBlueprintId`	string	Entra Agent Blueprint -ID, wenn vorhanden.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Allgemein verfügbar

Anmerkung

Nicht alle Identitätseigenschaften sind für alle Agententypen verfügbar: entraAppId ist ein Legacy-Identifikator, neuere Agenten verwenden entraAgentId und entraAgentBlueprintId. Diese Felder werden nur dann ausgefüllt, wenn sie auf den jeweiligen Agenten zutreffen. Keine dieser Identitätseigenschaften gilt für Microsoft 365 Copilot Agent Builder-Agents.

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

Konfigurationseigenschaften

API-Feldpfad	Datentyp	Beschreibung	Beispiel	Status
`properties.orchestration`	string	Der Orchestrierungsmodus des Agenten (Erfahren Sie mehr unter Orchestrierungsmodi).	`Generative`	Vorschauversion
`properties.model`	string	Das vom Agenten verwendete KI-Modell.	`gpt-4o`	Vorschauversion
`properties.authentication`	string	Der für den Agenten konfigurierte Authentifizierungsmodus (weitere Informationen unter Authentifizierungsmodi).	`Microsoft Entra`	Vorschauversion
`properties.channels`	array	Die Anzeigenamen der Kanäle, in denen der Agent veröffentlicht wird.	`["Teams","SharePoint"]`	Vorschauversion
`properties.sharedWithViewers`	object	Anzahl der einzelnen Benutzer (`userCount`) und Betrachtergruppen (`groupCount`), mit denen der Agent geteilt ist. Wenn ein Erstellender den Agent mandantenweit freigegeben hat, ist `entireTenant` auf `true` festgelegt, auch wenn kein Admin die Freigabe genehmigt hat.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Vorschauversion
`properties.sharedWithEditors`	object	Anzahl der einzelnen Editor-Benutzer (`userCount`) und Editor-Gruppen (`groupCount`), mit denen der Agent geteilt ist.	`"groupCount": 0, "userCount": 0`	Vorschauversion
`properties.capabilitiesCounts`	object	Direkte Gesamtanzahl der einzelnen konfigurierten Funktionen	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Vorschauversion

Orchestrierungsmodi

Das Feld properties.orchestration akzeptiert die folgenden Werte:

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

Authentifizierungsmodi

Das Feld properties.authentication akzeptiert die folgenden Werte:

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

Agent-Funktionen

In diesem Abschnitt werden die Fähigkeiten (Tools und Wissen) des Agenten aufgelistet. Derzeit werden nur detaillierte Daten zu den vom Agenten verwendeten Connectors und eine Wissenskonfiguration angezeigt, wie in den folgenden Abschnitten beschrieben.

Das Inventar hat eine Begrenzung von maximal 200 Ressourcen pro Typ und Agent. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

Das Inventar entfernt automatisch doppelte Ressourcen, wie zum Beispiel einen Power Platform Connector, den Sie mit derselben Konfiguration zweimal in einem Agenten eingerichtet haben.

Konnektor-Eigenschaften

Das Inventar enthält ein Array namens powerPlatformConnectors, das die in einem Agenten konfigurierten Power Platform Connectors enthält. Jeder Connector wird durch seine connectorId identifiziert (eine Zeichenkette, die die Ressourcen-ID des Connectors enthält; zum Beispiel shared_excelonlinebusiness). Für jeden konfigurierten Konnektor gibt es eine Liste der konfigurierten operations. Die Liste umfasst die folgenden Eigenschaften:

Eigenschaften	Datentyp	BESCHREIBUNG	Status
`OperationId`	string	Die ID der spezifischen Vorgangs innerhalb des Connectors; zum Beispiel `AddRowV2`	Vorschauversion
`createdBy`	GUID	Der Benutzer, der den Vorgang konfiguriert hat	Vorschauversion
`isEnabled`	boolesch	Ob der Connector-Vorgang derzeit aktiviert ist	Vorschauversion
`usedAs`	string	Wie werden die Vorgänge verwendet: `Tool` wenn er als allgemeines Werkzeug konfiguriert ist `Topic Tool` wenn er als Werkzeug in einem bestimmten Thema konfiguriert ist `Knowledge` wenn der Connector als Wissensquelle konfiguriert ist	Vorschauversion
`requiresEndUserConsent`	boolesch	Ob Endnutzer zustimmen müssen, bevor der Agent den Vorgang nutzen darf	Vorschauversion
`whenCanBeUsed`	string	Wenn der Vorgang aufgerufen werden kann: `Anytime` wenn das Tool dem Agent ohne Einschränkungen zur Verfügung steht `ViaDirectReferenceOnly` wenn der Agent das Tool nur verwendet, wenn der Ersteller es explizit in bestimmten Themen konfiguriert hat `Conditional` wenn der Agent das Tool gemäß einer vom Ersteller vordefinierten Logik verwenden kann	Vorschauversion
`connectionProvider`	string	Wer stellt die Verbindung für den Vorgang her: `User` wenn der Endbenutzer während der Laufzeit Zugangsdaten bereitstellt `Maker` wenn der Erstellende die Verbindung beim Erstellen festlegt	Vorschauversion
`connectionIdSharedByMaker`	GUID	Verbindungs-ID, wird nur gesetzt, wenn `connectionProvider = Maker`	Vorschauversion

Beispiel

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

Wissenseigenschaften

Das Inventar enthält folgende Wissenseigenschaft:

Eigenschaften	Datentyp	BESCHREIBUNG	Status
`IsWebSearchEnabledForKnowledge`	boolesch	Wahr, wenn der Agent die Websuche als Wissensquelle nutzen kann	Vorschauversion

Bekannte Einschränkungen

V1-Agenten werden nicht erfasst – das Inventar enthält keine Agenten, die mit der ursprünglichen Power Virtual Agents V1-Laufzeit erstellt wurden. Es werden ausschließlich V2 (Copilot Studio) Agenten verfolgt.
Identitätseigenschaften sind möglicherweise nicht für alle Agenten verfügbar – Die Felder entraAgentId und entraAgentBlueprintId werden ausschließlich für Agenten ausgefüllt, die mit dem neueren Entra-Agenten-Identitätsmodell provisioniert werden. Ältere Agenten verfügen möglicherweise nur über entraAppId, und Microsoft 365 Copilot Agent Builder-Agenten haben keine dieser Identitätseigenschaften.
Anzahl der Funktionen – Das Inventar hat eine Begrenzung von maximal 200 Ressourcen je Typ und Agent. Wenn ein Agent mehr als 200 konfigurierte Ressourcen eines bestimmten Typs besitzt (z. B. Power Platform Connectors), zeigt das Inventar eine zufällige Auswahl von 200 an. Admins können das capabilitiesCounts-Feld verwenden, um zu bestimmen, wie viele Ressourcen von jedem Typ in einem Agenten konfiguriert wurden.

Feedback

War diese Seite hilfreich?

Last updated on 2026-07-30

Häufig gestellte Fragen zu Agent-Bestand in Microsoft Copilot Studio

Agent-Eigenschaften

Kerneigenschaften

Entra-Identitätseigenschaften

Konfigurationseigenschaften

Orchestrierungsmodi

Authentifizierungsmodi

Agent-Funktionen

Konnektor-Eigenschaften

Beispiel

Wissenseigenschaften

Bekannte Einschränkungen

Zugehöriger Inhalt

Feedback

Zusätzliche Ressourcen