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 .

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	Aucun	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	String collection	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"
    }
  ]
}