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

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

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

Путь к полю API Тип данных Description Example Статус
properties.ownerId string Идентификатор объекта владельца ресурса. aaaa0000-bb11-2222-33cc-444444dddddd Общедоступно
properties.environmentId string Идентификатор среды, содержащей ресурс. aaaa0000-bb11-2222-33cc-444444dddddd Общедоступно
properties.lastPublishedAt datetime Дата и время последней публикации агента. Пусто, если агент еще находится в состоянии черновика. 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 Является ли агент частью управляемого решения. false Preview

Свойства идентичности

Путь к полю API Тип данных Description Example Статус Доступно для
properties.botId string Идентификатор бота CDS в среде. aaaa0000-bb11-2222-33cc-444444dddddd Общедоступно Агенты Copilot Studio и Microsoft 365 Copilot Agent Builder
properties.entraAppId string Идентификатор регистрации приложения Entra. aaaa0000-bb11-2222-33cc-444444dddddd Общедоступно агенты Copilot Studio
properties.entraAgentId string Идентификатор удостоверения агента Entra. aaaa0000-bb11-2222-33cc-444444dddddd Общедоступно агенты Copilot Studio
properties.entraAgentBlueprintId string ИД схемы агента Entra. aaaa0000-bb11-2222-33cc-444444dddddd Общедоступно агенты Copilot Studio

Замечание

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

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

Путь к полю 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.orchestration.

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

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

Возможны следующие значения для поля properties.authentication.

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

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

  • Агенты версии 1 не отслеживаются. Агенты, созданные с помощью исходной среды выполнения Power Virtual Agents версии 1, не включаются в инвентаризацию. Отслеживаются только агенты версии 2 (Copilot Studio).
  • Свойства идентичности могут быть недоступны для всех агентов. Поля entraAgentId и entraAgentBlueprintId заполняются только для агентов, которые были подготовлены с использованием новой модели удостоверения агента Entra. У более старых агентов может быть только entraAppId, а у агентов Microsoft 365 Copilot Agent Builder нет никаких из этих идентификационных свойств.