agentCollection-Ressourcentyp

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.

Stellt eine Auflistung von Agent-Instanzen in der agentRegistry dar. Agent-Sammlungen 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. Spezielle Auflistungen sind Global und Quarantined.

Reservierte Sammlungen

Pro Mandant sind immer zwei vom System reservierte Sammlungen verfügbar:

Auflistung	ID	Zweck
Global	00000000-0000-0000-0000-000000000001	Mandantenweiter Pool allgemein verfügbarer Agents
Unter Quarantäne gestellt	00000000-0000-0000-0000-000000000002	Haltebereich für blockierte/ausstehende Agents

Wichtige Verhaltensweisen:

1. Immer präsent: Eine GET by reserved ID gibt niemals 404 zurück (synthetische Rückgabe, wenn sie nicht beibehalten wird).
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. Erstellungsschutz: Beim Versuch, eine neue Sammlung zu erstellen, deren displayName mit einer reservierten Auflistung übereinstimmt, wird der Fehlercode zurückgegeben 409 Conflict .

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
List	agentCollection-Sammlung	Ruft eine Liste der agentCollection-Objekte und deren Eigenschaften ab.
Create	agentCollection	Erstellen Sie ein neues agentCollection-Objekt.
Get	agentCollection	Lesen der Eigenschaften und Beziehungen des agentCollection-Objekts .
Update	Keine	Aktualisieren sie die Eigenschaften eines agentCollection-Objekts.
Mitglieder von agentCollection auflisten	agentInstance-Sammlung	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 den 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 (auf der 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	String collection	Liste der Objekt-IDs für die Besitzer des Agent-instance.

Beziehungen

Beziehung	Typ	Beschreibung
Elemente	agentInstance-Sammlung	Liste der Agent-Instanzen, 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)"
}