Схема инвентаризации агентов 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.

Примечание

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

Важно

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

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

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

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

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

Примечание

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

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

Путь к полю API	Тип данных	Описание	Пример	Состояние
`properties.displayName`	строка	Отображаемое имя агента.	`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`	строка	Идентификатор объекта (идентификатор Entra) текущего владельца агента.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступная
`properties.environmentId`	строка	Идентификатор среды Power Platform, где размещен ресурс.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Общедоступная
`properties.lastPublishedAt`	datetime	Дата и время последней публикации агента. Пусто/null, если агент еще находится в состоянии черновика.	`2026-01-15T10:30:00Z`	Общедоступная
`properties.createdIn`	строка	Инструмент разработки, в котором был создан агент: Copilot Studio или построитель агентов Microsoft 365 Copilot.	`Copilot Studio`	Общедоступная
`properties.schemaName`	строка	Имя схемы Dataverse. Доступно для агентов Copilot Studio и агентов построителя агентов Microsoft 365 Copilot.	`cr5e3_agentName`	Общедоступная
`properties.isQuarantined`	логическое значение	Находится ли агент в настоящее время на карантине.	`false`	Предварительная версия
`properties.quarantinedAt`	datetime	Дата и время последней постановки агента на карантин.	`2026-02-01T08:00:00Z`	Предварительная версия
`properties.isManaged`	логическое значение	Является ли агент частью управляемого решения Dataverse. null для агентов, созданных в построителе агентов.	`false`	Предварительная версия

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

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

Примечание

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

Чтобы узнать больше о концепциях идентификации Entra, см. раздел Регистрация приложений, идентификаторы агентов и аутентификация для Copilot Studio.

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

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

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

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

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

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

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

Значение	Описание
Не допускается	Аутентификация не требуется.
Microsoft Entra	Аутентификация через Microsoft Entra ID.
Универсальный протокол OAuth 2.0	Аутентификация через универсального поставщика OAuth 2.0.

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

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

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

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

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

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

Свойство	Тип данных	Описание	Состояние
`OperationId`	строка	Идентификатор конкретной операции внутри соединителя; например, `AddRowV2`	Предварительная версия
`createdBy`	GUID	Пользователь, настроивший операцию	Предварительная версия
`isEnabled`	логическое значение	Включена ли операция соединителя в данный момент	Предварительная версия
`usedAs`	строка	Как эта операция используется: `Tool`, если настроен как общий инструмент `Topic Tool`, если настроен как инструмент для конкретной темы `Knowledge`, если соединитель настроен как источник знаний	Предварительная версия
`requiresEndUserConsent`	логическое значение	Требуется ли согласие конечных пользователей, прежде чем агент сможет использовать операцию	Предварительная версия
`whenCanBeUsed`	строка	Когда операция может быть вызвана: `Anytime`, если инструмент доступен агенту без ограничений `ViaDirectReferenceOnly`, если агент использует инструмент только когда создатель явно настроил его в определенных темах `Conditional`, если агент может использовать инструмент согласно заранее заданной логике создателя	Предварительная версия
`connectionProvider`	строка	Кто предоставляет подключение для операции: `User`, если конечный пользователь предоставляет учетные данные во время выполнения `Maker`, если создатель устанавливает соединение на этапе создания	Предварительная версия
`connectionIdSharedByMaker`	GUID	Идентификатор соединения, заполняется только если `connectionProvider = Maker`	Предварительная версия

Пример

{
  "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
    }
  }
}

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

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

Свойство	Тип данных	Описание	Статус
`IsWebSearchEnabledForKnowledge`	логическое значение	Значение true, если агент может использовать веб-поиск как источник знаний	Предварительная версия

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

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

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

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

Last updated on 2026-07-30

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

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

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

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

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

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

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

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

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

Пример

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

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

Связанный контент

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

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