Esquema de inventario de agentes de Copilot Studio

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. Para obtener información general sobre la característica de inventario, consulte Inventario de Power Platform.

Propiedades principales

Ruta del campo de API Tipo de dato Descripción Ejemplo Situación
properties.ownerId string Identificador de objeto del propietario del recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.environmentId string Identificador del entorno que contiene el recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general
properties.lastPublishedAt datetime Fecha y hora en que se publicó por última vez el agente. Vacío si el agente todavía se encuentra 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 boolean Si el agente está en cuarentena. false Versión preliminar
properties.quarantinedAt datetime Fecha y hora en que el agente se puso en cuarentena por última vez. 2026-02-01T08:00:00Z Versión preliminar
properties.isManaged boolean Si el agente forma parte de una solución administrada. false Versión preliminar

Propiedades de identidad

Ruta del campo de API Tipo de dato Descripción Ejemplo Situación Disponible para
properties.botId string Identificador del bot de CDS en el entorno. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general Agentes de Copilot Studio, agentes de Microsoft 365 Copilot Agent Builder
properties.entraAppId string ID de registro de la aplicación Entra. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general Agentes de Copilot Studio
properties.entraAgentId string ID de identidad del agente Entra. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general Agentes de Copilot Studio
properties.entraAgentBlueprintId string Id. de plano técnico de agente de Entra. aaaa0000-bb11-2222-33cc-444444dddddd Disponible con carácter general Agentes de Copilot Studio

Nota:

El entraAppId campo es un identificador heredado. Los agentes más recientes usan entraAgentId y entraAgentBlueprintId en su lugar. Ninguna de estas propiedades de identidad se aplica a los agentes de Microsoft 365 Copilot Agent Builder.

Propiedades de configuración

Ruta del campo de API Tipo de dato Descripción Ejemplo Situación
properties.orchestration string Modo de orquestación del agente (consulte Modos de orquestación). Generative Versión preliminar
properties.model string El modelo de IA usado por el agente. gpt-4o Versión preliminar
properties.authentication string El modo de autenticación configurado para el agente (consulte 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

Modos de orquestación

Los siguientes valores son posibles para el properties.orchestration campo.

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

Modos de autenticación

Los siguientes valores son posibles para el properties.authentication campo.

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

Limitaciones conocidas

  • No se realiza un seguimiento de los agentes V1. Los agentes creados con el entorno de ejecución de Power Virtual Agents V1 original no se incluyen en el inventario. Solo los agentes V2 (Copilot Studio) son rastreados.
  • 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 han aprovisionado con el modelo de identidad del Agente Entra más reciente. Los agentes más antiguos solo pueden tener entraAppIdy los agentes de Microsoft 365 Copilot Agent Builder no tienen ninguna de estas propiedades de identidad.

Contenido relacionado

  • Last updated on