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.
Los metadatos del agente sirven como base para la detectabilidad del agente en el Registro de Agente de Microsoft Entra. Los metadatos que proporcione determina cómo otros agentes, aplicaciones y usuarios pueden encontrar e interactuar con el agente. Comprender el esquema de metadatos y su relación con el modelo de recopilaciones garantiza que el público previsto pueda detectar los agentes mientras mantiene los límites de seguridad adecuados.
Esquema de metadatos del agente
El esquema de metadatos del agente define la estructura de información necesaria para la detección e interacción del agente. Este esquema permite la colaboración del agente a través de protocolos estándar al ampliarlo con funcionalidades específicas de Microsoft Entra para mejorar la seguridad.
Información básica del agente
Los metadatos fundamentales incluyen la identificación esencial y la información de contacto del agente.
| Campo | Description |
|---|---|
id |
Identificador único del manifiesto del agente. Necesario para todos los registros de agente. |
displayName |
Identificador legible para humanos que aparece en los resultados del descubrimiento. Debe indicar claramente el propósito del agente, como "Asistente de soporte al cliente" o "Agente de procesamiento de facturas". |
description |
Detalles completos sobre el propósito y las funcionalidades del agente. Incluya palabras clave relevantes que el público de destino usaría naturalmente al buscar este tipo de agente, lo que afecta directamente a la detectabilidad. |
iconUrl |
URL de la imagen del icono del agente, lo que ofrece una identificación visual en los resultados de búsqueda e interfaces de usuario. |
version |
Versión de la implementación del agente, lo que permite el seguimiento de las actualizaciones del agente y las consideraciones de compatibilidad para escenarios de integración. |
documentationUrl |
Dirección URL de la documentación del agente. Incluya enlaces a la documentación detallada de la API, ejemplos de uso y guías de solución de problemas para facilitar la adopción exitosa del agente. |
protocolVersion |
Versión del protocolo compatible con el agente, lo que garantiza la compatibilidad con los clientes y otros agentes durante la comunicación. |
provider |
Información sobre la organización que proporciona el agente, incluido el nombre de la organización y la dirección URL de contacto. Ayuda a identificar el origen de los agentes durante la detección y proporciona puntos de comprobación para la autenticidad del agente. |
managedBy |
Identificador de aplicación que gestiona este manifiesto, estableciendo una clara propiedad y responsabilidad sobre el ciclo de vida y la configuración del agente. |
originatingStore |
Nombre del almacén o sistema donde se originó el agente, lo que ayuda a realizar un seguimiento de los orígenes del agente y el linaje dentro del registro. |
Metadatos de aptitudes y funcionalidades
La funcionalidad principal y las funcionalidades de interacción que proporciona el agente.
| Campo | Description |
|---|---|
skills |
Funcionalidad básica que proporciona el agente. Cada aptitud requiere un identificador único, un nombre descriptivo y una descripción detallada que explique lo que logra la aptitud. Determina directamente la detectabilidad en las búsquedas basadas en funcionalidades. |
defaultInputModes |
Modos de entrada predeterminados admitidos por el agente. Use especificaciones de tipo MIME coherentes, como "text/plain", "application/json" o "image/png" para garantizar la coincidencia adecuada con las aplicaciones cliente. |
defaultOutputModes |
Modos de salida predeterminados admitidos por el agente. Especifique los formatos de datos que genera el agente, lo que permite la comprobación automática de compatibilidad durante la detección del agente. |
capabilities |
Características técnicas que admite el agente para los protocolos de integración. |
capabilities.extensions |
Funcionalidades de extensión que contienen propiedades como URI, descripción, estado necesario y parámetros. Afecta a cómo interactúan otros agentes y aplicaciones con el agente durante escenarios de federación. |
Información de seguridad y proveedor
Requisitos de seguridad y autenticación que afectan a las directivas de detectabilidad, confianza y acceso. La información de seguridad y del proveedor afecta directamente a cómo el Registro de Agente de Microsoft Entra aplica políticas de asignación y descubrimiento de colecciones a su agente, haciendo que estos campos sean fundamentales para una gestión y cumplimiento correcto.
| Campo | Description |
|---|---|
securitySchemes |
Diccionario de definiciones de esquema de seguridad clave por nombre de esquema, especificando los métodos de autenticación que admite tu agente. Garantiza que el agente aparezca en los resultados de búsqueda solo para los clientes que puedan cumplir los requisitos de autenticación necesarios. |
security |
Matriz de referencias de esquema de seguridad que se aplican a diferentes operaciones. Define los requisitos de seguridad que impiden los intentos de integración con errores y mejoran la experiencia del usuario filtrando coincidencias incompatibles durante la detección. |
signatures |
Firmas digitales para el manifiesto, incluido contenido protegido, valores de firma e información de encabezado para comprobar la integridad y la autenticidad del manifiesto. |
supportsAuthenticatedExtendedCard |
Indica si el agente proporciona más metadatos para los autores de llamadas autenticados. Permite la divulgación progresiva de información, donde las funcionalidades básicas son detectables públicamente, mientras que la información operativa detallada requiere autenticación. |
ownerIds |
Lista de identificadores de propietario que tienen autoridad sobre el manifiesto del agente. |
Recopilaciones y detectabilidad
Las colecciones determinan qué agentes pueden detectarse entre sí y establecer canales de comunicación. Los administradores o las directivas organizativas definidas deben asignar explícitamente a los agentes a las recopilaciones. No hay asignaciones automáticas basadas en etiquetas de metadatos ni características del agente. Este modelo de asignación explícito garantiza la gobernanza y los controles de seguridad adecuados sobre los patrones de detección e interacción del agente.
Para obtener información completa sobre los tipos de recopilación, las reglas de asignación y las directivas de detección, consulte Recopilaciones del Registro del agente.