适用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的 MCP 和 API 插件的确认提示

重要

MCP 和 API 插件在 声明性代理中提供操作。 它们不是独立的可安装插件包:只有包含的代理才能访问它们的功能和工具。 有关包和操作清单关系的信息,请参阅 插件和声明性代理操作。

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®第一次使用 MCP) 或 API 插件 (模型上下文协议时,它会通知用户并要求他们允许或取消该操作。 如果用户允许 Copilot 连接到插件,则以后所有检索数据 (HTTP GET 操作) 操作都不需要任何确认。 其他 HTTP 操作会提示用户,显示要发送的数据,并让用户选择允许或拒绝。

首次连接到插件的 Copilot 确认对话框

插件开发人员可以在其 MCP 服务器或 API 中为单个操作更改此行为。 开发人员还可以自定义 Copilot 在确认提示中向用户显示的文本。

替代提示行为

开发人员可以通过在 MCP 服务器的tools/list响应中将属性设置为 readOnlyHinttrue for 工具来控制智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®是否在对特定工具进行初始首次提示) 后要求用户确认 (。 有关详细信息,请参阅 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属性来指定确认文本。 的 body 值应表示函数的作用。 如果清单中不存在此属性, description 则改用 Function 对象 中的属性。

注意

自定义确认文本仅适用于插件清单的 functions 数组 (固定工具) 中声明的工具。 对于使用 动态工具发现的 MCP 插件,工具在运行时从 MCP 服务器解析,并且未在清单中声明,因此无法自定义其确认文本。 Copilot 改用 MCP 服务器tools/list响应中的工具description。

{
  "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 插件