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.

Propiedades del agente

El inventario proporciona las siguientes propiedades para cada agente.

Propiedades principales

Propiedades de identidad de Entra

Aprende más sobre identidades de agentes y autenticación en Copilot Studio.

Propiedades de configuración

Modos de orquestación

El properties.orchestration campo acepta los siguientes valores:

Modos de autenticación

El properties.authentication campo acepta los siguientes valores:

Funcionalidades 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:

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 de conocimiento:

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 campos entraAgentId y entraAgentBlueprintId solo se rellenan para los agentes que se aprovisionan con el modelo de id. de agente de 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

• Inventario de Power Platform
• Referencia del esquema de inventario de Power Platform
• API de inventario de Power Platform