Type de ressource agentCollection

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente une collection d’instances d’agent dans agentRegistry. Les collections d’agents permettent d’organiser et de regrouper les instances d’agent associées à des fins de gestion et d’organisation.

Les collections d’agents permettent le regroupement d’instances d’agent à des fins de contrôle d’organisation et d’accès. Les collections spéciales sont Global et Quarantined.

Collections réservées

Deux collections réservées par système sont toujours disponibles par locataire :

Collection	ID	Objectif
Global	00000000-0000-0000-0000-000000000001	Pool d’agents en disponibilité générale à l’échelle du locataire
Quarantaine	00000000-0000-0000-0000-000000000002	Zone de conservation pour les agents bloqués/en attente de révision

Comportements clés :

1. Toujours présent : un ID réservé GET par ne retourne jamais 404 (retourné synthétique s’il n’est pas persistant).
2. Immuabilité : vous ne pouvez pas METTRE À JOUR ou SUPPRIMER une collection réservée. Sinon, un 403 Forbidden code d’erreur avec le message « collectionImmutable » est retourné.
3. Protections de création : la tentative de création d’une collection dont displayName correspond à une collection réservée retourne 409 Conflict le code d’erreur.

Hérite de l’entité.

Méthodes

Méthode	Type de retour	Description
List	collection agentCollection	Obtenez la liste des objets agentCollection et leurs propriétés.
Create	agentCollection	Créez un objet agentCollection.
Obtenir	agentCollection	Lisez les propriétés et les relations de l’objet agentCollection .
Mettre à jour	Aucun	Mettez à jour les propriétés d’un objet agentCollection.
Répertorier les membres de agentCollection	collection agentInstance	Liste des objets agentInstance dans la collection.
Ajouter à la collection	agentInstance	Ajoutez un agentInstance à agentCollection.
Supprimer de la collection	Aucun	Supprimez un objet agentInstance de l’objet agentCollection.

Propriétés

Propriété	Type	Description
createdBy	String	ID d’objet de l’utilisateur ou de l’application qui a créé l’agent instance.
createdDateTime	DateTimeOffset	Horodatage de la création d’une collection d’agents.
description	String	Description/objectif de la collection.
displayName	String	Nom convivial de la collection.
id	String	Identificateur unique de la collection. Clé. Hérité de l’entité.
lastModifiedDateTime	DateTimeOffset	Horodatage de la dernière mise à jour.
managedBy	String	appId (appelé ID d’application (client) sur le centre d’administration Microsoft Entra) du principal de service qui gère cet agent.
originatingStore	String	Système/magasin source d’où provient la collection. Par exemple Copilot Studio.
ownerIds	String collection	Liste des ID d’objet pour les propriétaires de l’agent instance.

Relations

Relation	Type	Description
members	collection agentInstance	Liste des instances d’agent qui sont membres de cette collection. Prend en charge $expand.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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