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 .

Importante

Modification à venir des API du registre de l’agent

À compter de mai 2026, les API du registre des agents dans Microsoft Graph seront remplacées par les API du registre des agents optimisées par Microsoft Agent 365. Ce changement consolide les expériences de gestion des agents pour faciliter l’observation, la gouvernance et la sécurisation de tous les agents de votre client. Nous vous recommandons de planifier la migration vers les nouvelles API basées sur l’Agent 365 dès leur publication. En savoir plus sur la convergence du registre d’agents avec Microsoft Agent 365.

Représente un ensemble d’instances d’agent dans le registre agentRegistry. Les collections d’agents permettent d’organiser et de regrouper des instances d’agent connexes à des fins de gestion et d’organisation.

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

Collections réservées

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

Collection ID Objectif
Global 00000000-0000-0000-0000-000000000001 Pool d’agents généralement disponibles au niveau du client
En quarantaine 00000000-0000-0000-0000-000000000002 Zone d’attente pour les agents bloqués / en attente de révision

Comportements clés :

  1. Toujours présent : un GET par ID réservé ne renvoie jamais 404 (synthétique renvoyé 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 renvoyé.
  3. Protections de création : la tentative de création d’une collection dont le nom d’affichage correspond à une collection réservée retourne un 409 Conflict code d’erreur.

Hérite de l’entité.

Méthodes

Méthode Type de retour Description
List Collection de l’agentCollection Obtenir la liste des objets agentCollection et de 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.
Lister les membres d’agentCollection collection agentInstance Liste des objets agentInstance dans la collection.
Ajouter à la collection agentInstance Ajoutez une agentInstance à agentCollection.
Supprimer de la collection Aucun Supprimez un objet agentInstance de l’agentCollection.

Propriétés

Propriété Type Description
createdBy String ID d’objet de l’utilisateur ou de l’application qui a créé l’instance d’agent.
createdDateTime DateTimeOffset Horodatage de la création de la collection de l’agent.
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) dans le centre dʼadministration Microsoft Entra) du principal du service gérant 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’instance d’agent.

Relations

Relation Type Description
members collection agentInstance Liste des instances d’agent 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)"
}
  • Last updated on