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 de l’agent dans Microsoft Graph seront remplacées par les API du Registre d’agents alimentées par Microsoft Agent 365. Cette modification consolide les expériences de gestion des agents pour faciliter l’observation, la gouvernance et la sécurisation de tous les agents de votre locataire. Nous vous recommandons de planifier la migration vers les nouvelles API Agent 365 lorsqu’elles seront publiées. En savoir plus sur la convergence du registre d’agents avec Microsoft Agent 365.

Représente un instance déployé spécifique d’un agent IA dans le registre de l’agent Microsoft Entra. Un agent instance est associé à 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 la liste des objets agentInstance et 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 Aucune Supprime 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’agent instance. En lecture seule.
createdDateTime DateTimeOffset Horodatage lors de la création de l’instance de l’agent. En lecture seule.
displayName String Nom d’affichage de la instance de l’agent.
id String Identificateur unique de l’agent instance. Clé. Hérité de l’entité.
lastModifiedDateTime DateTimeOffset Horodatage de la dernière modification.
managedBy String appId (appelé ID d’application (client) sur le centre d’administration Microsoft Entra) de l’application qui gère cet agent.
originatingStore String Nom du magasin/du système d’origine de l’agent. Par exemple Copilot Studio.
ownerIds Collection de chaînes Liste des ID d’objet pour les propriétaires de l’agent instance.
preferredTransport String Protocole de transport préféré. Les valeurs possibles sont JSONRPC, GRPC et HTTP+JSON.
Signatures collection agentCardSignature Signatures numériques pour l’agent instance.
sourceAgentId String Identificateur de l’agent dans le système source d’origine.
url Chaîne URL du point de terminaison de l’agent instance.

Relations

Relation Type Description
agentCardManifest agentCardManifest Manifeste carte de l’agent de l’instance de l’agent.
Collections collection agentCollection Regroupements d’agents dont l’agent instance 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