Inventario de agentes de Microsoft Copilot Studio

El inventario de agentes de Copilot Studio ofrece a los administradores de TI y de seguridad una visión centralizada de todos los agentes creados mediante Copilot Studio o Agent Builder en el inquilino. El inventario cubre tanto los agentes no publicados (borrador) como los publicados. Para cada agente, el inventario muestra metadatos clave, como quién creó el agente, cuándo se publicó por última vez, en qué canales está desplegado, cómo autentica a los usuarios, sus capacidades y más. Los datos del inventario se actualizan automáticamente y los cambios en un agente suelen aparecer dentro de 20 minutos.

Los administradores pueden consumir los datos de inventario a través de múltiples métodos, incluyendo el centro de administración de Power Platform, la API de Power Platform y Azure Resource Graph. Para la lista completa de métodos de acceso y roles requeridos, consulte Inventario de Power Platform.

Este artículo describe los campos específicos de los agentes de Copilot Studio (microsoft.copilotstudio/agents) en el inventario de Power Platform. Para los campos compartidos disponibles en todos los tipos de recursos, consulte Referencia del esquema de inventario de Power Platform.

Nota

El inventario no incluye los agentes creados con V1 de Copilot Studio (también conocidos como bots clásicos o Power Virtual Agents). Sin embargo, aún puede ir al Centro de administración de Power Platform y seleccionar Administrar>Copilot Studio>Bots de chat clásicos para ver esos agentes.

Importante

Este artículo contiene la documentación de la versión preliminar de Microsoft Copilot Studio y está sujeto a modificaciones.

Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que pueda tener acceso anticipado y proporcionar comentarios.

Si está creando un agente listo para producción, consulte Información general sobre Microsoft Copilot Studio.

Propiedades de agente

El inventario proporciona las siguientes propiedades para cada agente.

Nota

  • El inventario refleja la estructura de la versión publicada de cada agente. Si un agente tiene cambios no publicados (un borrador más reciente), el inventario no muestra esos cambios hasta que el agente está publicado.

  • La configuración de un agente determina qué campos se completan. Algunas propiedades pueden tener el valor null dependiendo de cómo esté configurado el agente. Por ejemplo, isManaged es null para agentes creados en Agent Builder.

Propiedades básicas

Ruta del campo de la API Tipo de datos Descripción Ejemplo Estado
properties.displayName cadena El nombre para mostrar del agente. Customer support agent Disponibilidad general
properties.name GUID El Id. del agente en el ambiente específico de Dataverse (Id. de bot CDS). aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.createdAt datetime Fecha y hora en que se creó el agente. 2024-12-13T04:00:00Z Disponibilidad general
properties.createdBy GUID Introduzca el Id. del usuario que creó el agente. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.ownerId cadena El identificador de objeto (Entra ID) del propietario actual del agente. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.environmentId cadena El identificador del entorno Power Platform que contiene el recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.lastPublishedAt datetime La fecha y la hora de la última publicación del agente. Vacío/nulo si el agente todavía se encuentra en borrador. 2026-01-15T10:30:00Z Disponibilidad general
properties.createdIn cadena La herramienta de autoría donde se creó el agente: Copilot Studio o Microsoft 365 Copilot Agent Builder. Copilot Studio Disponibilidad general
properties.schemaName cadena El nombre del esquema de Dataverse. Disponible para agentes de Copilot Studio y agentes de Microsoft 365 Copilot Agent Builder. cr5e3_agentName Disponibilidad general
properties.isQuarantined booleano Si el agente está actualmente en cuarentena. false Versión preliminar
properties.quarantinedAt datetime La fecha y la hora de la última cuarentena del agente. 2026-02-01T08:00:00Z Versión preliminar
properties.isManaged booleano Si el agente forma parte de una solución Dataverse gestionada. Null para los agentes creados en el Generador de agentes. false Versión preliminar

Propiedades de identidad de Entra

Ruta del campo de la API Tipo de datos Descripción Ejemplo Estado
properties.botId cadena El Id. del bot CDS en el entorno. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.entraAppId cadena Id. de registro de la aplicación Entra asociado al agente, si existe. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.entraAgentId cadena Id. de identidad del agente de Entra, si existe. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general
properties.entraAgentBlueprintId cadena Id. de Entra Agent Blueprint, si existe. aaaa0000-bb11-2222-33cc-444444dddddd Disponibilidad general

Nota

No todas las propiedades de identidad están disponibles para todos los tipos de agentes: entraAppId es un identificador heredado, los agentes más recientes usan entraAgentId y entraAgentBlueprintId. Estos campos se completan únicamente cuando son aplicables al agente específico. Ninguna de estas propiedades de identidad se aplica a los agentes de Microsoft 365 Copilot Agent Builder.

Para saber más sobre los conceptos de identidad de Entra, consulte Registro de aplicaciones, identidades de agentes y autenticación para Copilot Studio.

Propiedades de configuración

Ruta del campo de la API Tipo de datos Descripción Ejemplo Estado
properties.orchestration cadena El modo de orquestación del agente (para obtener más información, consulte Modos de orquestación). Generative Versión preliminar
properties.model cadena El modelo de IA que utiliza el agente. gpt-4o Versión preliminar
properties.authentication cadena El modo de autenticación configurado para el agente (más información en Modos de autenticación). Microsoft Entra Versión preliminar
properties.channels array Los nombres para mostrar de los canales en los que se publica el agente. ["Teams","SharePoint"] Versión preliminar
properties.sharedWithViewers objeto Recuento de usuarios espectadores individuales (userCount) y grupos de espectadores (groupCount) con los que se ha compartido el agente. Si un creador ha compartido el agente con todo el inquilino, entireTenant se establece en true, incluso si un administrador no ha aprobado el uso compartido. "groupCount": 0, "userCount": 0, "entireTenant": false Versión preliminar
properties.sharedWithEditors objeto Recuento de usuarios editores individuales (userCount) y grupos de editores (groupCount) con los que se comparte el agente. "groupCount": 0, "userCount": 0 Versión preliminar
properties.capabilitiesCounts objeto Cantidad total de cada tipo diferente de capacidades configuradas "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Versión preliminar

Modos de orquestación

El campo properties.orchestration acepta los valores siguientes:

Valor Description
Clásico El agente utiliza una orquestación clásica basada en temas con árboles de diálogo creados.
Generativa El agente utiliza orquestación generativa, donde un modelo de IA selecciona dinámicamente temas y acciones.

Modos de autenticación

El campo properties.authentication acepta los valores siguientes:

Valor Descripción
Ninguna No se requiere autenticación.
Microsoft Entra Autenticación mediante Microsoft Entra ID.
OAuth 2.0 genérico Autenticación mediante un proveedor genérico de OAuth 2.0.

Capacidades del agente

Esta sección enumera las capacidades (herramientas y conocimientos) del agente. Actualmente, solo muestra datos detallados sobre los conectores utilizados por el agente y una configuración de conocimiento, la cual se describe en las siguientes secciones.

El inventario está limitado a un máximo de 200 recursos de cada tipo por agente. Más información en Limitaciones conocidas.

El inventario elimina automáticamente los recursos duplicados, como un conector de Power Platform que ha configurado dos veces en un agente con la misma configuración.

Propiedades del conector

El inventario incluye una matriz llamada powerPlatformConnectors, que contiene los conectores de Power Platform configurados en un agente. Cada conector se identifica por su connectorId (una cadena que contiene el ID de recurso del conector; por ejemplo, shared_excelonlinebusiness). Para cada conector configurado, hay una lista de las operations configuradas. La lista incluye las siguientes propiedades:

Propiedad Tipo de datos Descripción Estado
OperationId cadena El Id. de la operación específica dentro del conector; por ejemplo, AddRowV2 Versión preliminar
createdBy GUID El usuario que configuró la operación Versión preliminar
isEnabled booleano Indica si la operación del conector está habilitada actualmente Versión preliminar
usedAs cadena Cómo se utiliza la operación:
  • Tool si se configura como una herramienta general
  • Topic Tool si está configurado como una herramienta en un tema específico
  • Knowledge si el conector está configurado como fuente de conocimientos
 Versión preliminar
requiresEndUserConsent booleano Si los usuarios finales deben consentir antes de que el agente pueda utilizar la operación Versión preliminar
whenCanBeUsed cadena Cuando se puede invocar la operación:
  • Anytime si la herramienta está disponible para el agente sin limitaciones
  • ViaDirectReferenceOnly si el agente utiliza la herramienta solo cuando el creador la ha configurado explícitamente en temas específicos
  • Conditional si el agente puede usar la herramienta según una lógica predefinida por el creador
 Versión preliminar
connectionProvider cadena Quién proporciona la conexión para la operación:
  • User si el usuario final proporciona credenciales en tiempo de ejecución
  • Maker si el creador establece la conexión en tiempo de creación
 Versión preliminar
connectionIdSharedByMaker GUID Id. de conexión, completado solo cuando connectionProvider = Maker Versión preliminar
Ejemplo
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Propiedades de conocimiento

El inventario incluye la siguiente propiedad del conocimiento:

Propiedad Tipo de datos Descripción Estado
IsWebSearchEnabledForKnowledge booleano Verdadero si el agente puede usar la búsqueda web como fuente de conocimientos Versión preliminar

Limitaciones conocidas

  • Los agentes V1 no se rastrean - El inventario no incluye los agentes creados con el runtime original de Power Virtual Agents V1. Solo rastrea los agentes de V2 (Copilot Studio).
  • Es posible que las propiedades de identidad no estén disponibles para todos los agentes - Los campos entraAgentId y entraAgentBlueprintId solo se rellenan para los agentes que se aprovisionan con el modelo de identidad de Entra más reciente. Los agentes antiguos pueden tener solo entraAppId y los agentes de Microsoft 365 Copilot Agent Builder no tienen ninguna de estas propiedades de identidad.
  • Conteo de capacidades: el inventario tiene una limitación de 200 recursos de cada tipo por agente. Si un agente tiene más de 200 recursos configurados de un tipo específico (por ejemplo, conectores de Power Platform), el inventario muestra 200 recursos aleatorios. Los administradores pueden consultar el campo capabilitiesCounts para conocer cuántos recursos están configurados en un agente por tipo.

Contenido relacionado

  • Last updated on