Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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"
}
]
}