Тип ресурса agentCollection

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Важно!

Предстоящее изменение API реестра агентов

С мая 2026 г. API реестра агентов в Microsoft Graph будут заменены новыми API реестра агентов на базе Microsoft Agent 365. Это изменение объединяет возможности управления агентами, упрощая наблюдение, управление и защиту всех агентов в клиенте. Мы рекомендуем запланировать переход на новые API на основе Agent 365 при их выпуске. Дополнительные сведения о конвергенции реестра агентов с Microsoft Agent 365.

Представляет коллекцию экземпляров агента в agentRegistry. Коллекции агентов позволяют упорядочивать и группировать связанные экземпляры агента для целей управления и организации.

Коллекции агентов позволяют группировать экземпляры агента в целях организации и управления доступом. Специальными коллекциями являются Global и Quarantined.

Зарезервированные коллекции

Для каждого клиента всегда доступны две коллекции, зарезервированные системой:

Collection ИД Назначение
Глобальные 00000000-0000-0000-0000-000000000001 Пул общедоступных агентов на уровне клиента
Карантин 00000000-0000-0000-0000-000000000002 Область хранения для заблокированных или ожидающих проверки агентов

Основные варианты поведения:

  1. Всегда присутствует: get by reserved ID никогда не возвращает значение 404 (возвращается искусственным путем, если не сохраняется).
  2. Неизменяемость. Вы не можете обновить или удалить зарезервированную коллекцию. В противном случае 403 Forbidden возвращается код ошибки с сообщением collectionImmutable.
  3. Защита от создания. При попытке создать новую коллекцию, displayName которой соответствует зарезервированной, возвращается 409 Conflict код ошибки.

Наследует от сущности.

Методы

Метод Тип возвращаемых данных Описание
Список Коллекция agentCollection Получение списка объектов agentCollection и их свойств.
Создание agentCollection Создайте объект agentCollection.
Получение agentCollection Чтение свойств и связей объекта agentCollection .
Обновление Нет Обновление свойств объекта agentCollection.
Перечисление членов agentCollection Коллекция agentInstance Список объектов agentInstance в коллекции.
Добавление в коллекцию agentInstance Добавьте agentInstance в agentCollection.
Удалить из коллекции Нет Удалите объект agentInstance из agentCollection.

Свойства

Свойство Тип Описание
createdBy String Идентификатор объекта пользователя или приложения, создавшего экземпляр агента.
createdDateTime DateTimeOffset Метка времени создания коллекции агентов.
description String Описание или назначение коллекции.
displayName String Понятное имя коллекции.
id String Уникальный идентификатор для коллекции. Ключ. Наследуется от сущности.
lastModifiedDateTime DateTimeOffset Метка времени последнего обновления.
Managedby String appId (называемый идентификатором приложения (клиента) на Центр администрирования Microsoft Entra) субъекта-службы, управляющего этим агентом.
originatingStore String Исходная система или хранилище, в котором возникла коллекция. Например, Copilot Studio.
ownerIds Коллекция строк Список идентификаторов объектов для владельцев экземпляра агента.

Связи

Связь Тип Описание
members Коллекция agentInstance Список экземпляров агента, являющихся членами этой коллекции. Поддерживает $expand.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.agentCollection",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "displayName": "String",
  "description": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)"
}
  • Last updated on