Compartir a través de

Tipo de recurso agentUser

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 un subtipo especializado de identidad de usuario en Microsoft Entra ID diseñado para aplicaciones con tecnología de inteligencia artificial (agentes) que necesitan funcionar como trabajadores digitales. Los usuarios del agente permiten a los agentes acceder a las API y servicios que requieren específicamente identidades de usuario y reciben tokens con idtyp=user notificaciones. Los usuarios del agente son distintos de los usuarios humanos y solo se interconectan con los usuarios a través de relaciones como propietario, patrocinador y administrador.

Cada usuario del agente mantiene una relación uno a uno con una identidad de agente principal y se autentica a través de las credenciales de ese elemento primario. Los usuarios del agente tienen funcionalidades similares a las de usuario, como agregarse a grupos, licencias asignadas y acceder a características colaborativas como buzones de correo y chat, mientras que funcionan con restricciones de seguridad, como la no autenticación con contraseña, ninguna asignación de roles de administrador con privilegios y permisos similares a los usuarios invitados.

Hereda del usuario.

Este recurso es un tipo abierto que permite propiedades adicionales más allá de las documentadas aquí.

Métodos

Método Tipo de valor devuelto Descripción
List colección agentUser Obtenga una lista de objetos agentUser .
Crear agentUser Cree un nuevo objeto agentUser .
Get agentUser Lee las propiedades y las relaciones del objeto agentUser .
Actualizar agentUser Actualice el objeto agentUser .
Delete Ninguno Elimina el objeto agentUser .
Asignaciones de roles de aplicación
Enumeración de asignaciones de roles de aplicación Colección appRoleAssignment Obtenga las asignaciones de roles de aplicación para este usuario del agente.
Creación de una asignación de roles de aplicación appRoleAssignment Cree una nueva asignación de roles de aplicación para este usuario del agente.
Elementos eliminados
Lista Colección directoryObject Recupere una lista de objetos de usuario del agente eliminados recientemente.
Get directoryObject Recupere las propiedades de un usuario de agente eliminado recientemente.
Restaurar directoryObject Restaure un usuario del agente eliminado recientemente.
Eliminar permanentemente Ninguno Elimine permanentemente un usuario del agente.
Objetos de directorio
Enumerar objetos en propiedad Colección directoryObject Obtenga los objetos de directorio propiedad del usuario del agente.
Relaciones organizativas
Enumerar subordinados Colección directoryObject Obtenga los usuarios y contactos que informan al usuario del agente.
Enumerar administrador directoryObject Obtenga el usuario o contacto que es el administrador del usuario del agente.
Agregar administrador Ninguno Asigne el administrador del usuario del agente.
Quitar administrador Ninguno Quite el administrador del usuario del agente.
Enumerar pertenencias directas Colección directoryObject Obtenga los grupos, roles de directorio y unidades administrativas de los que es miembro el usuario del agente.
Enumeración de pertenencias transitivas Colección directoryObject Obtenga los grupos, roles de directorio y unidades administrativas de los que es miembro el usuario del agente, incluidas las pertenencias a grupos anidados.
Enumerar informes transitivos Colección directoryObject Obtenga los informes transitivos para el usuario del agente.
Patrocinadores
Enumerar patrocinadores Colección directoryObject Obtenga los usuarios y grupos responsables de los privilegios de este usuario del agente.
Incorporación de patrocinadores Ninguno Agregue patrocinadores para el usuario del agente.
Eliminación de patrocinadores Ninguno Quite los patrocinadores del usuario del agente.

Propiedades

Importante

Aunque este recurso hereda del usuario, algunas propiedades no son aplicables y devuelven null o valores predeterminados. Estas propiedades se excluyen de la tabla siguiente.

Propiedad Tipo Descripción
accountEnabled Boolean true si la cuenta está habilitada; en caso contrario, false. Esta propiedad es necesaria al crear el objeto . Se hereda del usuario.
assignedLicenses Colección assignedLicense Las licencias que se asignan al usuario del agente, incluidas las licencias heredadas (basadas en grupos). Esta propiedad no diferencia entre las licencias asignadas directamente y las heredadas. Use la propiedad licenseAssignmentStates para identificar las licencias asignadas y heredadas directamente. No admite valores NULL. Se hereda del usuario.
assignedPlans Colección assignedPlan Planes asignados al usuario del agente. Solo lectura. No admite valores NULL. Se hereda del usuario.
businessPhones Colección string Números de teléfono para el usuario del agente. Para esta propiedad sólo se puede establecer un número. Solo lectura para los usuarios sincronizados desde un directorio local. Se hereda del usuario.
city Cadena Ciudad donde se encuentra el usuario del agente. La longitud máxima es de 128 caracteres. Se hereda del usuario.
cloudRealtimeCommunicationInfo cloudRealtimeCommunicationInfo Información de comunicación en tiempo real de Microsoft relacionada con el usuario del agente. Se hereda del usuario.
CompanyName String Nombre de la empresa a la que está asociado el usuario del agente. Esta propiedad puede ser útil para describir la empresa de la que procede un usuario externo. La longitud máxima es de 64 caracteres. Se hereda del usuario.
country Cadena País o región donde se encuentra el usuario del agente; por ejemplo, US o UK. La longitud máxima es de 128 caracteres. Se hereda del usuario.
createdDateTime DateTimeOffset Fecha y hora en que se creó el usuario del agente en formato ISO 8601 y UTC. El valor no puede modificarse y se rellena automáticamente al crear la entidad. Admite valores NULL. Para los usuarios locales, el valor representa cuándo se crearon por primera vez en Microsoft Entra ID. La propiedad es null para algunos usuarios creados antes de junio de 2018 y los usuarios locales sincronizados con Microsoft Entra ID antes de junio de 2018. Solo lectura. Se hereda del usuario.
creationType Cadena Solo lectura. Nulo. Se hereda del usuario.
customSecurityAttributes customSecurityAttributeValue Un tipo complejo abierto que contiene el valor de un atributo de seguridad personalizado que se asigna a un objeto de directorio. Admite un valor NULL. Se hereda del usuario.
deletedDateTime DateTimeOffset Fecha y hora en que se eliminó el usuario. Heredado de directoryObject.
department Cadena Nombre del departamento donde trabaja el usuario. La longitud máxima es de 64 caracteres. Se hereda del usuario.
displayName Cadena Nombre del usuario que aparece en la libreta de direcciones. El valor suele ser la combinación del nombre del usuario, la inicial del segundo nombre y el apellido. Esta propiedad es necesaria cuando se crea un usuario y no se puede borrar durante las actualizaciones. La longitud máxima es de 256 caracteres. Se hereda del usuario.
employeeHireDate DateTimeOffset La fecha y hora en que se contrató al usuario o comenzará a trabajar si hay una contratación futura. Se hereda del usuario.
employeeId Cadena El identificador de empleado asignado al usuario en la organización. La longitud máxima es de 16 caracteres. Se hereda del usuario.
employeeLeaveDateTime DateTimeOffset Fecha y hora en que el usuario se fue o dejará la organización. Para leer esta propiedad, a la aplicación que realiza la llamada se le debe asignar el permiso User-LifeCycleInfo.Read.All . Para escribir esta propiedad, a la aplicación que realiza la llamada se le deben asignar los permisos User.Read.All y User-LifeCycleInfo.ReadWrite.All . Para leer esta propiedad en escenarios delegados, el administrador necesita al menos uno de los siguientes roles de Microsoft Entra: Administrador de flujos de vida (privilegios mínimos), Lector global. Para escribir esta propiedad en escenarios delegados, el administrador necesita el rol Administrador global . Para obtener más información, vea Configurar la propiedad employeeLeaveDateTime para un usuario. Se hereda del usuario.
employeeOrgData employeeOrgData Representa los datos de la organización (por ejemplo, la división y costCenter) asociados a un usuario. Se hereda del usuario.
employeeType Cadena Es para capturar el tipo de trabajador de la empresa. Por ejemplo, Employee, Contractor, Consultant o Vendor. Se hereda del usuario.
faxNumber Cadena El número de fax del usuario. Se hereda del usuario.
givenName Cadena El nombre (nombre de pila) del usuario. La longitud máxima es de 64 caracteres. Se hereda del usuario.
id String El identificador único del usuario. Debe tratarse como un identificador opaco. Heredado de directoryObject. No admite valores NULL. Solo lectura. Hereda de la entidad
identityParentId Cadena Hace referencia al identificador de objeto de la identidad del agente asociado. Esta propiedad es necesaria al crear el objeto y no se puede borrar durante las actualizaciones. Se hereda del usuario.
imAddresses Colección string Las direcciones del protocolo de inicio de sesión (SIP) de ip de voz a través de mensajes instantáneos (VOIP) para el usuario. Solo lectura. Se hereda del usuario.
infoCatalogs Colección de cadenas Identifica los segmentos de información asignados al usuario. Se hereda del usuario.
isLicenseReconciliationNeeded Booleano Indica si el usuario está pendiente de una asignación de licencia de buzón de Exchange. Solo lectura. Se hereda del usuario.
isManagementRestricted Booleano true si el usuario es miembro de una unidad administrativa de administración restringida. Si no se establece, el valor predeterminado es null y el comportamiento predeterminado es false. Solo lectura. Para administrar un usuario que es miembro de una unidad administrativa de administración restringida, al administrador o a la aplicación de llamada se le debe asignar un rol de Microsoft Entra en el ámbito de la unidad administrativa de administración restringida. Se hereda del usuario.
isResourceAccount Booleano No se utiliza. Reservado para uso posterior. Se hereda del usuario.
jobTitle String Puesto del usuario. La longitud máxima es de 128 caracteres. Se hereda del usuario.
licenseAssignmentStates Colección licenseAssignmentState Estado de asignaciones de licencia para este usuario. También indica las licencias que se asignan directamente y las que el usuario hereda a través de pertenencias a grupos. Solo lectura. Se hereda del usuario.
mail Cadena La dirección SMTP del usuario (por ejemplo, la dirección admin@contoso.com). Los cambios en esta propiedad también actualizan la colección proxyAddresses del usuario para incluir el valor como una dirección SMTP. Esta propiedad no puede contener caracteres de énfasis. NOTA: No se recomienda actualizar esta propiedad para Azure perfiles de usuario de AD B2C. Use la propiedad otherMails en su lugar. Se hereda del usuario.
mailNickname Cadena El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. La longitud máxima es de 64 caracteres. Se hereda del usuario.
mobilePhone String El número de teléfono móvil principal del usuario. Solo lectura para los usuarios sincronizados desde el directorio local. Se hereda del usuario.
officeLocation String La ubicación de la oficina del lugar de trabajo del usuario. La longitud máxima es de 128 caracteres. Se hereda del usuario.
otherMails Colección string Una lista de direcciones de correo electrónico adicionales para el usuario. Por ejemplo: ["bob@contoso.com", "Robert@fabrikam.com"]. Puede almacenar hasta 250 valores, cada uno con un límite de 250 caracteres. NOTA: Esta propiedad no puede contener caracteres de énfasis. Se hereda del usuario.
postalCode String El código postal de la dirección del usuario. El código postal es específico del país o de la región del usuario. En Estados Unidos, este atributo contiene el código postal. La longitud máxima es de 40 caracteres. Se hereda del usuario.
preferredDataLocation Cadena La ubicación de datos preferida para el usuario. Para obtener más información, vea OneDrive Online Multi-Geo. Se hereda del usuario.
preferredLanguage String Idioma preferido del usuario. El formato de idioma preferido se basa en RFC 4646. El nombre combina un código de referencia cultural en minúsculas iso 639 de dos letras asociado al idioma y un código de subcultura en mayúsculas iso 3166 de dos letras asociado al país o región. Ejemplo: "en-US" o "es-ES". Se hereda del usuario.
provisionedPlans colección provisionedPlan Planes que han sido provisionados para el usuario. Solo lectura. No admite valores NULL. Se hereda del usuario.
proxyAddresses Colección string Por ejemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Los cambios en la propiedad mail también actualizan esta colección para incluir el valor como una dirección SMTP. Para obtener más información, consulte propiedades mail y proxyAddresses. La dirección de proxy con SMTP el prefijo (con mayúsculas) es la dirección de proxy principal, mientras que las que tienen smtp el prefijo son las direcciones proxy secundarias. Para Azure cuentas de AD B2C, esta propiedad tiene un límite de 10 direcciones únicas. Solo lectura en Microsoft Graph; puede actualizar esta propiedad solo a través del Centro de administración de Microsoft 365. No admite valores NULL. Se hereda del usuario.
refreshTokensValidFromDateTime DateTimeOffset Los tokens de actualización o los tokens de sesiones (cookies de sesión) emitidos antes de este momento no son válidos y las aplicaciones reciben un error al usar un token de actualización o sesiones no válido para adquirir un token de acceso delegado (para acceder a las API como Microsoft Graph). Si sucede, la aplicación debe adquirir un nuevo token de actualización solicitando el punto de conexión autorizado. Solo lectura. Use invalidateAllRefreshTokens para restablecer. Se hereda del usuario.
securityIdentifier Cadena Identificador de seguridad (SID) del usuario, que se usa en escenarios de Windows. Solo lectura. Se devuelve de forma predeterminada. Se hereda del usuario.
showInAddressList Boolean No usar en Microsoft Graph. Administre esta propiedad a través de la Centro de administración de Microsoft 365 en su lugar. Representa si el usuario del agente debe incluirse en la lista global de direcciones de Outlook. Consulte Problema conocido. Se hereda del usuario.
signInSessionsValidFromDateTime DateTimeOffset Los tokens de actualización o los tokens de sesiones (cookies de sesión) emitidos antes de este momento no son válidos y las aplicaciones reciben un error al usar un token de actualización o sesiones no válido para adquirir un token de acceso delegado (para acceder a las API como Microsoft Graph). Si esto ocurre, la aplicación debe adquirir un nuevo token de actualización solicitando el punto de conexión autorizado. Solo lectura. Use revokeSignInSessions para restablecer. Se hereda del usuario.
state Cadena Estado o provincia en la dirección del usuario del agente. La longitud máxima es de 128 caracteres. Se hereda del usuario.
streetAddress String Dirección postal del lugar de trabajo del usuario del agente. La longitud máxima es de 1024 caracteres. Se hereda del usuario.
surname Cadena El apellido (o apellidos) del usuario. La longitud máxima es de 64 caracteres. Se hereda del usuario.
usageLocation String Código de país de dos letras (norma ISO 3166). Requerido para los usuarios del agente a los que se les asignan licencias debido a los requisitos legales para comprobar la disponibilidad de los servicios en los países. Algunos ejemplos son: USJP y GB. No admite valores NULL. Se hereda del usuario.
userPrincipalName Cadena Nombre principal de usuario (UPN) del usuario del agente. El UPN es un nombre de inicio de sesión de estilo Internet para el usuario basado en la RFC 822 estándar de Internet. Por convención, debe asignarse al nombre de correo electrónico del usuario del agente. El formato general es alias@domain, donde el dominio debe estar presente en la colección de dominios verificada del inquilino. Esta propiedad es necesaria cuando se crea un usuario. Se puede acceder a los dominios verificados del inquilino desde la propiedad verifiedDomains en organización. NOTA: Esta propiedad no puede contener caracteres de énfasis. Los caracteres siguientes no están permitidos A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Para obtener la lista completa de caracteres permitidos, vea directivas de nombre de usuario. Se hereda del usuario.
userType Cadena Valor string que se puede usar para clasificar los tipos de usuario del agente en el directorio. Los valores posibles son Member y Guest. NOTA: Para obtener más información sobre los permisos para los usuarios invitados y miembros, consulte ¿Cuáles son los permisos de usuario predeterminados en Microsoft Entra ID? Se hereda del usuario.

Relaciones

Importante

Aunque este tipo de recurso hereda todas las relaciones del tipo de recurso de usuario , algunas relaciones no son aplicables a los usuarios del agente y siempre devolverán null o valores predeterminados. Estas relaciones se excluyen de la tabla siguiente para mayor claridad.

Relación Tipo Description
appRoleAssignments Colección appRoleAssignment Representa los roles de aplicación que se han concedido a un usuario del agente para una aplicación. Heredado del usuario
directReports Colección directoryObject Los usuarios y contactos que informan al usuario del agente. (Los usuarios y los contactos con su propiedad de administrador establecida en este usuario). Solo lectura. Admite valores NULL. Heredado del usuario
manager directoryObject El usuario o contacto que es el administrador del usuario del agente. Solo lectura. Heredado del usuario
memberOf Colección directoryObject Grupos, roles de directorio y unidades administrativas de los que es miembro el usuario del agente. Solo lectura. Admite valores NULL. Heredado del usuario
ownedObjects Colección directoryObject Objetos de directorio propiedad del usuario del agente. Solo lectura. Admite valores NULL. Heredado del usuario
Patrocinadores Colección directoryObject Los usuarios y grupos responsables de los privilegios de este usuario del agente en el inquilino y mantienen actualizada la información y el acceso del usuario del agente. (Métodos HTTP: GET, POST, DELETE). Heredado del usuario
transitiveMemberOf Colección directoryObject Los grupos, incluidos los grupos anidados y los roles de directorio de los que es miembro el usuario del agente. Admite valores NULL. Heredado del usuario
transitiveReports Colección directoryObject Informes transitivos para un usuario del agente. Solo lectura. Heredado del usuario

Representación JSON

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

{
  "@odata.type": "#microsoft.graph.agentUser",
  "id": "String (identifier)",
  "deletedDateTime": "String (timestamp)",
  "accountEnabled": "Boolean",
  "assignedLicenses": [
    {
      "@odata.type": "microsoft.graph.assignedLicense"
    }
  ],
  "assignedPlans": [
    {
      "@odata.type": "microsoft.graph.assignedPlan"
    }
  ],
  "businessPhones": [
    "String"
  ],
  "city": "String",
  "cloudRealtimeCommunicationInfo": {
    "@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo"
  },
  "companyName": "String",
  "country": "String",
  "countryCode": "Integer",
  "createdDateTime": "String (timestamp)",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "String (timestamp)",
  "employeeId": "String",
  "employeeOrgData": {
    "@odata.type": "microsoft.graph.employeeOrgData"
  },
  "employeeType": "String",
  "employeeLeaveDateTime": "String (timestamp)",
  "faxNumber": "String",
  "givenName": "String",
  "imAddresses": [
    "String"
  ],
  "infoCatalogs": [
    "String"
  ],
  "isLicenseReconciliationNeeded": "Boolean",
  "isManagementRestricted": "Boolean",
  "isResourceAccount": "Boolean",
  "jobTitle": "String",
  "licenseAssignmentStates": [
    {
      "@odata.type": "microsoft.graph.licenseAssignmentState"
    }
  ],
  "mail": "String",
  "mailNickname": "String",
  "mobilePhone": "String",
  "otherMails": [
    "String"
  ],
  "officeLocation": "String",
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "provisionedPlans": [
    {
      "@odata.type": "microsoft.graph.provisionedPlan"
    }
  ],
  "proxyAddresses": [
    "String"
  ],
  "refreshTokensValidFromDateTime": "String (timestamp)",
  "securityIdentifier": "String",
  "showInAddressList": "Boolean",
  "signInSessionsValidFromDateTime": "String (timestamp)",
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",
  "identityParentId": "String"
}
  • Last updated on