Схема инвентаризации агентов Microsoft Copilot Studio

Инвентаризация агентов Copilot Studio предоставляет ИТ-специалистам и специалистам по безопасности централизованный обзор всех агентов, созданных с помощью Copilot Studio или построителя агентов в арендаторе. Инвентаризация охватывает как неопубликованные (черновые), так и опубликованные агенты. Для каждого агента инвентаризация отображает ключевые метаданные, такие как кем создан агент, когда он был опубликован в последний раз, на какие каналы он развернут, как он аутентифицирует пользователей, его возможности и другое. Данные инвентаризации обновляются автоматически, и изменения в агенте обычно появляются в течение 20 минут.

Администраторы могут получать доступ к данным инвентаря различными методами, включая центр администрирования Power Platform, API Power Platform и Azure Resource Graph. Для полного списка методов доступа и необходимых ролей см. раздел Инвентаризация Power Platform.

В этой статье описываются поля, относящиеся к агентам Copilot Studio (microsoft.copilotstudio/agents) в инвентаризации Power Platform. Общие поля, доступные во всех типах ресурсов, см. в справочнике по схеме инвентаризации Power Platform.

Note

Инвентарь не включает агентов, созданных с помощью V1 Copilot Studio (также известных как классические боты или Power Virtual Agents). Однако вы все еще можете перейти в центр администрирования Power Platform и выбрать Управление>Copilot Studio>Классические чат-боты, чтобы увидеть эти агенты.

Important

Эта статья содержит документацию по предварительной версии Microsoft Copilot Studio и может быть изменена.

Предварительные версии функций не предназначены для использования в рабочей среде и могут иметь ограниченные функциональные возможности. Они доступны перед официальным выпуском, чтобы вы могли досрочно получить доступ и предоставить отзывы.

Если вы создаете агент, готовый для рабочей среды, см. Обзор Microsoft Copilot Studio.

Свойства агента

Инвентарь содержит следующие свойства для каждого агента.

Note

Инвентарь отражает структуру опубликованной версии каждого агента. Если у агента есть неопубликованные изменения (более новый черновик), эти изменения не отображаются в инвентаре до публикации агента.
Конфигурация агента влияет на то, какие поля заполняются. Некоторые свойства могут быть null в зависимости от того, как настроен агент. Например, isManaged установлен как null для агентов, созданных в построителе агентов.

Ключевые свойства

Путь к полю API	Тип данных	Description	Example	Статус
`properties.harness`	string	Тип шлейки для агента. Узнайте больше в разделе Harnesses in Copilot Studio.	`Standard`	Общедоступно
`properties.displayName`	string	Отображаемое имя агента.	`Customer support agent`	Общедоступно
`properties.name`	GUID	Идентификатор агента в конкретной среде Dataverse (идентификатор бота CDS).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.createdAt`	datetime	Дата и время создания агента.	`2024-12-13T04:00:00Z`	Общедоступно
`properties.createdBy`	GUID	Идентификатор Entra пользователя, создавшего агент.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.ownerId`	string	Идентификатор объекта (идентификатор Entra) текущего владельца агента.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.environmentId`	string	Идентификатор среды Power Platform, где размещен ресурс.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.lastPublishedAt`	datetime	Дата и время последней публикации агента. Пусто/null, если агент еще находится в состоянии черновика.	`2026-01-15T10:30:00Z`	Общедоступно
`properties.createdIn`	string	Средство разработки, в котором был создан агент: Copilot Studio или Microsoft 365 Copilot Agent Builder.	`Copilot Studio`	Общедоступно
`properties.schemaName`	string	Имя схемы Dataverse. Доступно для агентов Copilot Studio и агентов Microsoft 365 Copilot Agent Builder.	`cr5e3_agentName`	Общедоступно
`properties.isQuarantined`	boolean	Находится ли агент в настоящее время на карантине.	`false`	Preview
`properties.quarantinedAt`	datetime	Дата и время последнего карантина агента.	`2026-02-01T08:00:00Z`	Preview
`properties.isManaged`	boolean	Является ли агент частью управляемого решения Dataverse. null для агентов, созданных в построителе агентов.	`false`	Preview

Свойства идентификации Entra

Путь к полю API	Тип данных	Description	Example	Статус
`properties.botId`	string	Идентификатор бота CDS в среде.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.entraAppId`	string	Идентификатор регистрации приложения Entra, связанный с агентом (при наличии).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.entraAgentId`	string	Идентификатор Entra агента, если существует.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно
`properties.entraAgentBlueprintId`	string	Идентификатор Entra схемы агента, если существует.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступно

Note

Не все свойства идентификации доступны для всех типов агентов; entraAppId является устаревшим идентификатором, новые агенты используют entraAgentId и entraAgentBlueprintId. Эти поля заполняются только если применимы к конкретному агенту. Ни одно из этих свойств удостоверения не применяется к агентам платформы Microsoft 365 Copilot Agent Builder.

Узнайте больше о идентичностях агентов и аутентификации в Copilot Studio.

Свойства конфигурации

Путь к полю API	Тип данных	Description	Example	Статус
`properties.orchestration`	string	Режим оркестрации агента (подробнее см. Режимы оркестрации).	`Generative`	Preview
`properties.model`	string	Модель ИИ, используемая агентом.	`gpt-4o`	Preview
`properties.authentication`	string	Режим аутентификации, настроенный для агента (подробнее см. в разделе Режимы аутентификации).	`Microsoft Entra`	Preview
`properties.channels`	массив	Отображаемые имена каналов, в которые публикуется агент.	`["Teams","SharePoint"]`	Preview
`properties.sharedWithViewers`	object	Количество отдельных пользователей с правами просмотра (`userCount`) и групп с правами просмотра (`groupCount`), которым предоставлен доступ к агенту. Если создатель поделился агентом со всем арендатором, `entireTenant` устанавливается равным `true`, даже если администратор не одобрил совместное использование.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Preview
`properties.sharedWithEditors`	object	Количество отдельных пользователей с правами редактирования (`userCount`) и групп с правами редактирования (`groupCount`), которым предоставлен доступ к агенту.	`"groupCount": 0, "userCount": 0`	Preview
`properties.capabilitiesCounts`	object	Общее число уникальных объектов каждого типа настроенных возможностей	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Preview

Режимы оркестрации

Поле properties.orchestration принимает следующие значения:

Value	Description
Classic	Агент использует классическую оркестрацию на основе тем с разработанными диалоговыми деревьями.
Генеративные	Агент использует генеративную оркестрацию, при которой модель ИИ динамически выбирает темы и инструменты.

Режимы проверки подлинности

Поле properties.authentication принимает следующие значения:

Value	Description
None	Проверка подлинности не требуется.
Microsoft Entra	Проверка подлинности с помощью идентификатора Microsoft Entra.
Универсальный протокол OAuth 2.0	Проверка подлинности через универсальный поставщик OAuth 2.0.

Возможности агента

В этом разделе перечислены возможности (инструменты и знания) агента. В настоящее время он отображает только подробные данные о соединителях, используемых агентом, и конфигурацию знаний, как подробно описано в следующих разделах.

Инвентарь ограничен максимум 200 ресурсами каждого типа для каждого агента. Дополнительные сведения см. в разделе Известные ограничения.

Инвентаризация автоматически удаляет дублирующиеся ресурсы, такие как соединитель Power Platform, который вы настроили дважды в агенте с одинаковой конфигурацией.

Свойства соединителя

В инвентаризации представлен массив с именем powerPlatformConnectors, который содержит соединители Power Platform, настроенные в агенте. Каждый соединитель идентифицируется с помощью connectorId (строки, содержащей идентификатор ресурса соединителя; например, shared_excelonlinebusiness). Для каждого настроенного соединителя есть список настроенных operations. Список включен следующие свойства:

Property	Тип данных	Description	Статус
`OperationId`	string	Идентификатор конкретной операции внутри соединителя; например, `AddRowV2`	Preview
`createdBy`	GUID	Пользователь, настроивший операцию	Preview
`isEnabled`	boolean	Включена ли операция соединителя в данный момент	Preview
`usedAs`	string	Как эта операция используется: `Tool`, если настроен как общий инструмент `Topic Tool`, если настроен как инструмент для конкретной темы `Knowledge`, если соединитель настроен как источник знаний	Preview
`requiresEndUserConsent`	boolean	Требуется ли согласие конечных пользователей, прежде чем агент сможет использовать операцию	Preview
`whenCanBeUsed`	string	Когда операция может быть вызвана: `Anytime`, если инструмент доступен агенту без ограничений `ViaDirectReferenceOnly`, если агент использует инструмент только когда создатель явно настроил его в определенных темах `Conditional`, если агент может использовать инструмент согласно заранее заданной логике создателя	Preview
`connectionProvider`	string	Кто предоставляет подключение для операции: `User`, если конечный пользователь предоставляет учетные данные во время выполнения `Maker`, если создатель устанавливает соединение на этапе создания	Preview
`connectionIdSharedByMaker`	GUID	Идентификатор соединения, заполняется только если `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
    }
  }
}

Свойства знаний

Инвентаризация включает следующее свойство для знаний:

Property	Тип данных	Description	Статус
`IsWebSearchEnabledForKnowledge`	boolean	Значение true, если агент может использовать веб-поиск как источник знаний	Preview

Известные ограничения

V1-агенты не отслеживаются — инвентаризация не включает агенты, созданные с помощью оригинальной среда выполнения Power Virtual Agents V1. Она отслеживает только агенты V2 (Copilot Studio).
Свойства идентификатора могут быть недоступны для всех агентов — поля entraAgentId и entraAgentBlueprintId заполняются только для агентов, созданных с использованием новой модели идентификатора агента Entra. У более старых агентов может быть только entraAppId, а у агентов построителя агентов Microsoft 365 Copilot нет никаких из этих идентификационных свойств.
Число возможностей — реестр ограничен максимум 200 ресурсами каждого типа на одного агента. Если у агента настроено более 200 ресурсов одного типа (например, соединители Power Platform), реестр отображает случайные 200. Администраторы могут воспользоваться полем capabilitiesCounts, чтобы узнать, сколько ресурсов каждого типа настроено в агенте.

Обратная связь

Были ли сведения на этой странице полезными?

Последнее обновление: 2026-08-27

Схема инвентаризации агентов Microsoft Copilot Studio

Свойства агента

Ключевые свойства

Свойства идентификации Entra

Свойства конфигурации

Режимы оркестрации

Режимы проверки подлинности

Возможности агента

Свойства соединителя

Example

Свойства знаний

Известные ограничения

Связанные материалы

Обратная связь

Дополнительные ресурсы