Inventario de agentes de Microsoft Copilot Studio

El inventario de agentes de Copilot Studio ofrece a los administradores de TI y seguridad una vista centralizada de todos los agentes creados en el tenant con Copilot Studio o Agent Builder. El inventario abarca tanto agentes no publicados (borradores) como 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 se implementa, cómo autentica a los usuarios, sus funcionalidades, etc. Los datos de inventario se actualizan automáticamente y los cambios en un agente suelen aparecer en un plazo de 20 minutos.

Los administradores pueden consumir los datos de inventario a través de varios métodos, incluidos el Centro de administración de Power Platform, Power Platform API y Azure Resource Graph. Para obtener la lista completa de los métodos de acceso y los roles necesarios, consulte Inventario de Power Platform.

En este artículo se describen 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 agentes creados con V1 de Copilot Studio (también conocidos como bots clásicos o Power Virtual Agents). Sin embargo, todavía puede ir al Centro de administración de Power Platform y seleccionar Manage>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 funciones de vista previa no están diseñadas para uso en 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 del 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 se publique el agente.

  • La configuración de un agente afecta a los campos que se rellenan. Algunas propiedades pueden depender null de cómo se configura el agente. Por ejemplo, isManaged es null para agentes creados en el Generador de agentes.

Propiedades principales

Ruta del campo de API Tipo de dato Description Example Status
properties.displayName string Nombre para mostrar del agente. Customer support agent Disponible con carácter general
properties.name GUID El identificador del agente en el entorno específico de Dataverse (ID del bot de CDS). aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.createdAt fecha y hora Fecha y hora en que se creó el agente. 2024-12-13T04:00:00Z Disponible con carácter general
properties.createdBy GUID Entra ID del usuario que creó el agente. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.ownerId string El identificador de objeto (Entra ID) del propietario actual del agente. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.environmentId string Identificador del entorno de Power Platform que contiene el recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.lastPublishedAt fecha y hora Fecha y hora en que se publicó por última vez el agente. Vacío/nulo si el agente sigue en borrador. 2026-01-15T10:30:00Z Disponible con carácter general
properties.createdIn string La herramienta de creación donde se creó el agente: Copilot Studio o Microsoft 365 Copilot Agent Builder. Copilot Studio Disponible con carácter general
properties.schemaName string Nombre del esquema de Dataverse. Disponible para agentes de Copilot Studio y agentes de Microsoft 365 Copilot Agent Builder. cr5e3_agentName Disponible con carácter general
properties.isQuarantined booleano Si el agente está actualmente en cuarentena. false Preview
properties.quarantinedAt fecha y hora Fecha y hora en que el agente se puso en cuarentena por última vez. 2026-02-01T08:00:00Z Preview
properties.isManaged booleano Si el agente forma parte de una solución de Dataverse administrada. Null para los agentes creados en el Generador de agentes. false Preview

Propiedades de identidad de Entra

Ruta del campo de API Tipo de dato Description Example Status
properties.botId string Identificador del bot de CDS en el entorno. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.entraAppId string Identificador de registro de la aplicación de Entra asociado al agente, si existe. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.entraAgentId string Identificador de identidad de Entra Agent, si existe. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.entraAgentBlueprintId string ID de blueprint de Entra Agent, si existe. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general

Nota:

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

Para obtener más información sobre los conceptos de identidad de Entra, consulte Aplicación, identidades de agente y autenticación para Copilot Studio.

Propiedades de configuración

Ruta del campo de API Tipo de dato Description Example Status
properties.orchestration string Modo de orquestación del agente (obtenga más información en Modos de orquestación). Generative Preview
properties.model string El modelo de IA usado por el agente. gpt-4o Preview
properties.authentication string El modo de autenticación configurado para el agente (obtenga más información en Modos de autenticación). Microsoft Entra Preview
properties.channels matriz Los nombres mostrados de los canales en los que se publica el agente. ["Teams","SharePoint"] Preview
properties.sharedWithViewers object Número de usuarios individuales con permisos de visualización (userCount) y grupos con permisos de visualización (groupCount) con los que se comparte el agente. Si un creador ha compartido el agente con toda la organización, entireTenant se establece en true, incluso si un administrador no ha aprobado el uso compartido. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors object Recuento de usuarios de editor individuales (userCount) y grupos de editores (groupCount) con los que se comparte el agente. "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts object Recuento total distinto de cada tipo de funcionalidades configuradas "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Modos de orquestación

El properties.orchestration campo acepta los siguientes valores:

Value Description
Classic El agente utiliza una orquestación tradicional centrada en temas con estructuras de diálogo diseñadas.
Generativo El agente usa la orquestación generativa, donde un modelo de IA selecciona dinámicamente temas y acciones.

Modos de autenticación

El properties.authentication campo acepta los siguientes valores:

Value Description
Ninguno No se requiere autenticación.
Microsoft Entra Autenticación a través de Microsoft Entra ID.
OAuth 2.0 genérico Autenticación a través de un proveedor genérico de OAuth 2.0.

Capacidades del agente

En esta sección se enumeran las funcionalidades (herramientas y conocimientos) del agente. Actualmente, solo muestra datos detallados sobre los conectores usados por el agente y una configuración de conocimiento, como se detalla en las secciones siguientes.

El inventario tiene una limitación de 200 recursos máximos de cada tipo por agente. Obtenga más información en Limitaciones conocidas.

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

Propiedades del conector

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

Property Tipo de dato Description Status
OperationId string Identificador de la operación específica dentro del conector; por ejemplo, AddRowV2 Preview
createdBy GUID Usuario que configuró la operación Preview
isEnabled booleano Si la operación del conector está habilitada actualmente Preview
usedAs string Cómo se usa la operación:
  • Tool si está configurado como una herramienta general
  • Topic Tool si se configura como una herramienta en un tema específico
  • Knowledge si el conector está configurado como origen de conocimiento
 Preview
requiresEndUserConsent booleano Si los usuarios finales deben dar su consentimiento antes de que el agente pueda usar la operación. Preview
whenCanBeUsed string Cuando se puede invocar la operación:
  • Anytime si la herramienta está disponible para el agente sin limitaciones
  • ViaDirectReferenceOnly si el agente usa la herramienta solo cuando el creador lo configuró explícitamente en temas específicos
  • Conditional si el agente puede usar la herramienta según una lógica predefinida por el creador
 Preview
connectionProvider string 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
 Preview
connectionIdSharedByMaker GUID Identificador de conexión, cumplimentado solo cuando connectionProvider = Maker Preview
Example
{
  "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 de conocimiento:

Property Tipo de dato Description Status
IsWebSearchEnabledForKnowledge booleano True si el agente puede usar la búsqueda web como origen de conocimiento Preview

Limitaciones conocidas

  • No se realiza un seguimiento de los agentes V1: el inventario no incluye agentes creados con el entorno de ejecución de Power Virtual Agents V1 original. Solo realiza un seguimiento de los agentes V2 (Copilot Studio).
  • Es posible que las propiedades de identidad no estén disponibles para todos los agentes : los entraAgentId campos y entraAgentBlueprintId solo se rellenan para los agentes que se aprovisionan con el modelo de identidad del agente Entra más reciente. Puede que los agentes más antiguos solo tengan entraAppId y que los agentes de Microsoft 365 Copilot Agent Builder no tengan ninguna de estas propiedades de identidad.
  • Recuento de funcionalidades: el inventario tiene una limitación de 200 recursos máximos de cada tipo por agente. Si un agente tiene más de 200 recursos configurados desde un tipo específico (por ejemplo, conectores de Power Platform), el inventario muestra 200 aleatorios. Los administradores pueden usar el capabilitiesCounts campo para comprender cuántos recursos están configurados en un agente por tipo.

Contenido relacionado

  • Last updated on