type de ressource agentInstance

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 une instance déployée spécifique d’un agent IA dans le registre d’agents Microsoft Entra. Une instance d’agent est associée à un agentCardManifest qui définit ses fonctionnalités, ses compétences et ses métadonnées. Les instances d’agent peuvent être organisées en collections et sont gérées via agentRegistry.

Hérite de l’entité.

Méthodes

Méthode Type de retour Description
List collection agentInstance Obtenez une liste des objets agentInstance et de leurs propriétés.
Create agentInstance Créez un objet agentInstance.
Obtenir agentInstance Lisez les propriétés et les relations de l’objet agentInstance .
Mettre à jour agentInstance Mettez à jour les propriétés d’un objet agentInstance.
Supprimer Aucun Supprimez un objet agentInstance.

Propriétés

Propriété Type Description
additionalInterfaces collection agentInterface Interfaces/transports supplémentaires pris en charge par l’agent.
agentIdentityBlueprintId String ID d’objet de l’objet agentIdentityBlueprint .
agentIdentityId String ID d’objet de l’objet agentIdentity .
agentUserId String ID d’objet de l’agentUser associé à l’agent. En lecture seule.
createdBy String ID d’objet de l’utilisateur ou de l’application qui a créé l’instance d’agent. En lecture seule.
createdDateTime DateTimeOffset Horodatage de la création de l’instance d’agent. En lecture seule.
displayName String Nom complet de l’instance de l’agent.
id String Identificateur unique de l’instance de l’agent. Clé. Hérité de l’entité.
lastModifiedDateTime DateTimeOffset Horodatage de la dernière modification.
managedBy String appId (appelé ID d’application (client) dans le centre dʼadministration Microsoft Entra) de l’application gérant cet agent.
originatingStore String Nom du magasin/système d’où provient l’agent. Par exemple Copilot Studio.
ownerIds String collection Liste des ID d’objet pour les propriétaires de l’instance d’agent.
préféréTransport String Protocole de transport préféré. Les valeurs possibles sont JSONRPC, GRPC et HTTP+JSON.
signatures numériques collection agentCardSignature Signatures numériques pour l’instance de l’agent.
sourceAgentId String Identifiant de l’agent dans le système source d’origine.
url Chaîne URL de point de terminaison de l’instance de l’agent.

Relations

Relation Type Description
agentCardManifest agentCardManifest Manifeste de la carte d’agent de l’instance de l’agent.
de recouvrements Collection de l’agentCollection Collections d’agents dont l’instance de l’agent est membre.

Représentation JSON

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

{
  "@odata.type": "#microsoft.graph.agentInstance",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "displayName": "String",
  "sourceAgentId": "String",
  "agentIdentityBlueprintId": "String",
  "agentIdentityId": "String",
  "agentUserId": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "url": "String",
  "preferredTransport": "String",
  "additionalInterfaces": [
    {
      "@odata.type": "microsoft.graph.agentInterface"
    }
  ],
  "signatures": [
    {
      "@odata.type": "microsoft.graph.agentCardSignature"
    }
  ]
}
  • Last updated on