Запросы на подтверждение для MCP и плагинов API для Microsoft 365 Copilot

Важно

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

Когда Microsoft 365 Copilot впервые использует протокол контекста модели (MCP) или плагин API, он уведомляет пользователя и просит разрешить или отменить операцию. Если пользователь разрешит Copilot подключиться к плагину, все будущие операции, которые извлекают данные (операции HTTP GET), не требуют подтверждения. Другие операции HTTP запрашивают пользователя, отображая данные для отправки и предоставляя пользователю выбор, разрешить или отклонить.

Диалоговое окно подтверждения Copilot для первого подключения к подключаемому модулю

Разработчики плагинов могут изменить это поведение для отдельных операций в своем сервере MCP или API. Разработчики также могут настроить текст, который Copilot отображает пользователю в запросе подтверждения.

Переопределение поведения запроса

Разработчики могут управлять тем, запрашивает ли Microsoft 365 Copilot подтверждение (после первоначального первого запроса) для конкретного инструмента, установив свойство readOnlyHinttrue для инструмента в ответе tools/list сервера MCP. Дополнительные сведения см. в справочнике по схеме MCP.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "title": "Weather Information Provider",
        "description": "Get current weather information for a location",
        "annotations": {
          "readOnlyHint": true,
        },
        "inputSchema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City name or zip code"
            }
          },
          "required": ["location"]
        }
      }
    ]
  }
}

Настройка текста подтверждения

Разработчики могут указать текст подтверждения, задав свойство body в объекте Confirmation объекта функции в объекте Function capabilities в манифесте плагина. Значение должно body указывать на то, что делает функция. Если это свойство отсутствует в манифесте, вместо него используется свойство description объекта Function .

Примечание

Настройка текста подтверждения применяется только к инструментам, объявленным в массиве functions манифеста плагина (закрепленные инструменты). Для подключаемых модулей MCP, использующих динамическое обнаружение инструментов, инструменты разрешаются с сервера MCP во время выполнения и не объявляются в манифесте, поэтому вы не можете настроить их текст подтверждения. Вместо этого Copilot использует ответ инструмента description из сервера MCP tools/list .

{
  "name": "GetBudgets",
  "description": "Returns details including name and available funds of budgets, optionally filtered by budget name",
  "capabilities": {
    "confirmation": {
      "type": "AdaptiveCard",
      "title": "Search budgets",
      "body": "Do you want to allow searching for budgets?"
    }
  }
}

Локализация текста подтверждения

Вы можете настроить локализуемые строки , которые будут использоваться в качестве запросов подтверждения. Ниже описан процесс.

Шаг 1. Использование ключей локализации в манифесте подключаемого модуля

В манифесте подключаемого модуля (например, plugin.json) замените строки литералов ключами локализации в следующем формате:

    {
      "schema_version": "v2.3",
      "name_for_human": "[[plugin_name]]",
      "description_for_human": "[[plugin_description]]"
    }

Эти ключи (например, plugin_name и plugin_description) должны соответствовать записям в файле локализации и соответствовать регулярному выражению ^[a-zA-Z_][a-zA-Z0-9_]*.

Шаг 2. Создание файлов локализации

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

    {
  "localizationKeys": {
    "plugin_name": "Weather Assistant",
    "plugin_description": "Provides weather updates and forecasts."
      }
    }

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

Шаг 3. Добавление localizationInfo в манифест приложения

Включите в манифест приложения раздел localizationInfo, который ссылается на файлы локализации. Например:

    "localizationInfo": {
      "defaultLanguageTag": "en",
      "defaultLanguageFile": "en.json",
      "additionalLanguages": [
        {
          "languageTag": "fr",
          "file": "fr.json"
        }
      ]
    }

Подключаемые модули MCP и API для декларативных агентов