Compartir a través de


Tipo de recurso agentInstance

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una instancia implementada específica de un agente de inteligencia artificial en el Registro de agentes de Microsoft Entra. Una instancia de agente está asociada a un agentCardManifest que define sus capacidades, aptitudes y metadatos. Las instancias del agente se pueden organizar en colecciones y se administran a través de agentRegistry.

Hereda de la entidad.

Methods

Método Tipo devuelto Descripción
List Colección agentInstance Obtenga una lista de los objetos agentInstance y sus propiedades.
Crear agentInstance Cree un nuevo objeto agentInstance.
Get agentInstance Lea las propiedades y relaciones del objeto agentInstance .
Actualizar agentInstance Actualice las propiedades de un objeto agentInstance.
Delete Ninguno Elimine un objeto agentInstance.

Propiedades

Propiedad Tipo Description
additionalInterfaces colección agentInterface Interfaces o transportes adicionales admitidos por el agente.
agentIdentityBlueprintId Cadena Identificador de objeto del objeto agentIdentityBlueprint .
agentIdentityId Cadena Id. de objeto del objeto agentIdentity .
agentUserId Cadena Id. de objeto del agentUser asociado al agente. Solo lectura.
createdBy String Id. de objeto del usuario o la aplicación que creó la instancia del agente. Solo lectura.
createdDateTime DateTimeOffset Marca de tiempo cuando se creó la instancia del agente. Solo lectura.
displayName Cadena Nombre para mostrar de la instancia del agente.
id Cadena Identificador único de la instancia del agente. Clave. Heredado de la entidad.
lastModifiedDateTime DateTimeOffset Marca de tiempo de la última modificación.
managedBy Cadena appId (denominado identificador de aplicación (cliente) en el Centro de administración Microsoft Entra) de la aplicación que administra este agente.
originatingStore Cadena Nombre del almacén o sistema donde se originó el agente. Por ejemplo, Copilot Studio.
ownerIds Colección string Lista de identificadores de objeto para los propietarios de la instancia del agente.
preferredTransport Cadena Protocolo de transporte preferido. Los valores posibles son JSONRPC, GRPC y HTTP+JSON.
Firmas colección agentCardSignature Firmas digitales para la instancia del agente.
sourceAgentId Cadena Identificador del agente en el sistema de origen original.
URL Cadena Dirección URL del punto de conexión de la instancia del agente.

Relaciones

Relación Tipo Description
agentCardManifest agentCardManifest Manifiesto de la tarjeta del agente de la instancia del agente.
colecciones colección agentCollection Recopilaciones de agentes de las que es miembro la instancia del agente.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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