Обновление agentCardManifest

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

Обновите свойства объекта agentCardManifest .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) AgentCardManifest.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение AgentCardManifest.ReadWrite.All AgentCardManifest.ReadWrite.ManagedBy

Важно!

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

Администратор реестра агентов — это наименее привилегированная роль, поддерживаемая для этой операции.

HTTP-запрос

PATCH /agentRegistry/agentCardManifests/{agentCardManifestId}

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

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

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
displayName String Отображаемое имя агента. Необязательный параметр.
description String Описание назначения агента. Необязательный параметр.
iconUrl String URL-адрес изображения значка агента. Необязательный параметр.
protocolVersion String Версия протокола, поддерживаемая агентом. Необязательный параметр.
version String Версия реализации агента. Необязательный параметр.
DocumentationUrl String URL-адрес документации агента. Необязательный параметр.
defaultInputModes Коллекция строк Поддерживаемые режимы ввода по умолчанию. Необязательный параметр.
defaultOutputModes Коллекция строк Поддерживаемые режимы вывода по умолчанию. Необязательный параметр.
Поставщика agentProvider Сведения об организации, предоставляющей агент. Необязательный параметр.
securitySchemes securitySchemes Словарь определений схем безопасности с ключом по имени схемы. Необязательный параметр.
Безопасности коллекция securityRequirement Требования к безопасности — массив ссылок на схемы безопасности. Необязательный параметр.
capabilities agentCapabilities Определенные возможности, поддерживаемые агентом. Необязательный параметр.
skills. Коллекция agentSkill Навыки и возможности, которые может выполнять агент. Необязательный параметр.
supportsAuthenticatedExtendedCard Логический Поддерживает ли агент расширенный карта получение с проверкой подлинности. Необязательный параметр.
ownerIds Коллекция строк Список идентификаторов владельца для карта манифеста агента может быть пользователем или субъектами-службами. Необязательный параметр.
Managedby String Идентификатор приложения, управляющий этим манифестом. Необязательный параметр.
originatingStore String Имя хранилища или системы, в которой был создан агент. Необязательный параметр.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект agentCardManifest в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/beta/agentRegistry/agentCardManifests/{agentCardManifestId}
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.agentCardManifest",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "protocolVersion": "String",
  "displayName": "String",
  "description": "String",
  "iconUrl": "String",
  "provider": {
    "@odata.type": "microsoft.graph.agentProvider"
  },
  "version": "String",
  "documentationUrl": "String",
  "capabilities": {
    "@odata.type": "microsoft.graph.agentCapabilities"
  },
  "securitySchemes": {
    "@odata.type": "microsoft.graph.securitySchemes"
  },
  "security": [
    {
      "@odata.type": "microsoft.graph.securityRequirement"
    }
  ],
  "defaultInputModes": [
    "String"
  ],
  "defaultOutputModes": [
    "String"
  ],
  "skills": [
    {
      "@odata.type": "microsoft.graph.agentSkill"
    }
  ],
  "supportsAuthenticatedExtendedCard": "Boolean"
}

Отклик

Ниже показан пример отклика.

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.agentCardManifest",
  "id": "5d1d9ba4-36ed-2e0c-c182-9da69c5e398d",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "protocolVersion": "String",
  "displayName": "String",
  "description": "String",
  "iconUrl": "String",
  "provider": {
    "@odata.type": "microsoft.graph.agentProvider"
  },
  "version": "String",
  "documentationUrl": "String",
  "capabilities": {
    "@odata.type": "microsoft.graph.agentCapabilities"
  },
  "securitySchemes": {
    "@odata.type": "microsoft.graph.securitySchemes"
  },
  "security": [
    {
      "@odata.type": "microsoft.graph.securityRequirement"
    }
  ],
  "defaultInputModes": [
    "String"
  ],
  "defaultOutputModes": [
    "String"
  ],
  "skills": [
    {
      "@odata.type": "microsoft.graph.agentSkill"
    }
  ],
  "supportsAuthenticatedExtendedCard": "Boolean"
}