Ressourcentyp agentCollection

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Wichtig

Bevorstehende Änderung an den Agent-Registrierungs-APIs

Ab Mai 2026 werden die Agent-Registrierungs-APIs in Microsoft Graph durch die von Microsoft Agent 365 unterstützten Agent-Registrierungs-APIs ersetzt. Diese Änderung konsolidiert die Agent-Verwaltungsfunktionen, um die Beobachtung, Steuerung und Sicherung aller Agents in Ihrem Mandanten zu vereinfachen. Wir empfehlen, die Migration zu den neuen Agent 365-basierten APIs zu planen, sobald sie veröffentlicht werden. Erfahren Sie mehr über die Konvergenz der Agent-Registrierung mit Microsoft Agent 365.

Stellt eine Sammlung von Agent-Instanzen in der agentRegistry dar. Agentsammlungen bieten eine Möglichkeit zum Organisieren und Gruppieren verwandter Agentinstanzen für Verwaltungs- und Organisationszwecke.

Agent-Sammlungen ermöglichen die Gruppierung von Agent-Instanzen für Organisations- und Zugriffssteuerungszwecke. Sondersammlungen sind Global und Quarantined.

Reservierte Sammlungen

Pro Mandant sind immer zwei für das System reservierte Sammlungen verfügbar:

Auflistung ID Zweck
Global 00000000-0000-0000-0000-000000000001 Mandantenweiter Pool von allgemein verfügbaren Agents
Unter Quarantäne gestellt 00000000-0000-0000-0000-000000000002 Wartebereich für blockierte / zur Überprüfung anstehende Agenten

Wichtige Verhaltensweisen:

  1. Always-present: Ein GET by reserved ID gibt niemals 404 zurück (synthetisch zurückgegeben, wenn nicht persistiert).
  2. Unveränderlichkeit: Sie können eine reservierte Sammlung nicht AKTUALISIEREN oder LÖSCHEN, andernfalls wird ein 403 Forbidden Fehlercode mit der Meldung "collectionImmutable" zurückgegeben.
  3. Schutz bei der Erstellung: Der Versuch, eine neue Sammlung zu erstellen, deren displayName mit einer reservierten Sammlung übereinstimmt, gibt einen Fehlercode zurück 409 Conflict .

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List agentCollection-Sammlung Rufen Sie eine Liste der agentCollection-Objekte und ihrer Eigenschaften ab.
Create agentCollection Erstellen Sie ein neues agentCollection-Objekt.
Get agentCollection Lesen Sie die Eigenschaften und Beziehungen des agentCollection-Objekts .
Update Keine Aktualisieren Sie die Eigenschaften eines agentCollection-Objekts.
Mitglieder von agentCollection auflisten agentInstance-Auflistung Liste der agentInstance-Objekte in der Auflistung.
Zur Sammlung hinzufügen agentInstance Fügen Sie der agentCollection eine agentInstance hinzu.
Aus Sammlung entfernen Keine Entfernen Sie ein agentInstance-Objekt aus der agentCollection.

Eigenschaften

Eigenschaft Typ Beschreibung
createdBy Zeichenfolge Objekt-ID des Benutzers oder der App, der bzw. die die Agent-Instance erstellt hat.
createdDateTime DateTimeOffset Zeitstempel beim Erstellen der Agent-Sammlung.
description Zeichenfolge Beschreibung / Zweck der Sammlung.
displayName Zeichenfolge Anzeigename der Sammlung.
id Zeichenfolge Eindeutiger Bezeichner für die Sammlung. Key. Geerbt von entity.
lastModifiedDateTime DateTimeOffset Zeitstempel der letzten Aktualisierung.
managedBy Zeichenfolge appId (im Microsoft Entra Admin Center als Anwendungs-ID (Client-ID) bezeichnet) des Dienstprinzipals, der diesen Agent verwaltet.
originatingStore Zeichenfolge Quellsystem/Speicher, aus dem die Sammlung stammt. Beispiel: Copilot Studio.
ownerIds Zeichenfolgensammlung Liste der Objekt-IDs für die Besitzer der Agent-Instance.

Beziehungen

Beziehung Typ Beschreibung
Elemente agentInstance-Auflistung Liste der Agentinstanzen, die Mitglieder dieser Sammlung sind. Unterstützt $expand.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.agentCollection",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "displayName": "String",
  "description": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)"
}
  • Last updated on