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.

Importante

Próximo cambio en las API del registro de agentes

A partir de mayo de 2026, las API del Registro de agentes en Microsoft Graph se reemplazarán por las API del Registro de agentes con tecnología de Microsoft Agent 365. Este cambio consolida las experiencias de administración de agentes para que sea más fácil observar, gobernar y proteger a todos los agentes de su inquilino. Le recomendamos que planee migrar a las nuevas API basadas en Agent 365 cuando se publiquen. Obtenga más información sobre la convergencia del Registro de agentes con Microsoft Agent 365.

Representa una instancia implementada específica de un agente de IA en el Registro de agentes de Microsoft Entra. Una instancia de agente está asociada a un agentCardManifest que define sus capacidades, habilidades y metadatos. Las instancias de 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 Crea un nuevo objeto agentInstance.
Get agentInstance Lee las propiedades y relaciones del objeto agentInstance .
Actualizar agentInstance Actualice las propiedades de un objeto agentInstance.
Delete Ninguno Eliminar un objeto agentInstance.

Propiedades

Propiedad Tipo Descripción
additionalInterfaces Colección agentInterface Interfaces o transportes adicionales compatibles con el agente.
agentIdentityBlueprintId Cadena Id. 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 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 id. de aplicación (cliente) en el Centro de administración de Microsoft Entra de 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 digitales. 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 extremo para la instancia del agente.

Relaciones

Relación Tipo Descripción
agentCardManifest agentCardManifest Manifiesto de la tarjeta de agente de la instancia de agente.
Colecciones colección agentCollection Las colecciones 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"
    }
  ]
}
  • Last updated on