Тип ресурса agentInstance

Пространство имен: 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.

Представляет конкретный развернутый экземпляр агента ИИ в реестре агентов Microsoft Entra. Экземпляр агента связан с agentCardManifest , который определяет его возможности, навыки и метаданные. Экземпляры агента можно упорядочить в коллекции и управлять ими с помощью agentRegistry.

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

Методы

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

Свойства

Свойство	Тип	Описание
additionalInterfaces	коллекция agentInterface	Дополнительные интерфейсы и транспорты, поддерживаемые агентом.
agentIdentityBlueprintId	String	Идентификатор объекта agentIdentityBlueprint .
agentIdentityId	String	Идентификатор объекта agentIdentity .
agentUserId	String	Идентификатор объекта agentUser, связанного с агентом. Только для чтения.
createdBy	String	Идентификатор объекта пользователя или приложения, создавшего экземпляр агента. Только для чтения.
createdDateTime	DateTimeOffset	Метка времени создания экземпляра агента. Только для чтения.
displayName	String	Отображаемое имя экземпляра агента.
id	String	Уникальный идентификатор экземпляра агента. Ключ. Наследуется от сущности.
lastModifiedDateTime	DateTimeOffset	Метка времени последнего изменения.
Managedby	String	appId (называемый идентификатором приложения (клиента) на Центр администрирования Microsoft Entra) приложения, управляющего этим агентом.
originatingStore	String	Имя хранилища или системы, в которой был создан агент. Например, Copilot Studio.
ownerIds	Коллекция строк	Список идентификаторов объектов для владельцев экземпляра агента.
preferredTransport	String	Предпочтительный транспортный протокол. Возможные значения: JSONRPC, GRPC и HTTP+JSON.
Подписи	коллекция agentCardSignature	Цифровые подписи для экземпляра агента.
sourceAgentId	String	Идентификатор агента в исходной исходной системе.
url	String	URL-адрес конечной точки для экземпляра агента.

Связи

Связь	Тип	Описание
agentCardManifest	agentCardManifest	Агент карта манифест экземпляра агента.
Коллекции	Коллекция agentCollection	Коллекции агентов, в которые входит экземпляр агента.

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

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

{
  "@odata.type": "#microsoft.graph.agentInstance",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "displayName": "String",
  "sourceAgentId": "String",
  "agentIdentityBlueprintId": "String",
  "agentIdentityId": "String",
  "agentUserId": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "url": "String",
  "preferredTransport": "String",
  "additionalInterfaces": [
    {
      "@odata.type": "microsoft.graph.agentInterface"
    }
  ],
  "signatures": [
    {
      "@odata.type": "microsoft.graph.agentCardSignature"
    }
  ]
}