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.

Agenteigenschaften

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

Kerneigenschaften

Entra-Identitätseigenschaften

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

Konfigurationseigenschaften

Orchestrierungsmodi

Das properties.orchestration Feld akzeptiert die folgenden Werte:

Authentifizierungsmodi

Das properties.authentication Feld akzeptiert die folgenden Werte:

Agent-Funktionen

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:

Example

{
  "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 die folgende Eigenschaft für Wissen:

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

• Power Platform-Bestand
• Schemareferenz für Power Platform-Inventar
• Power Platform-Bestands-API