適用於 Microsoft 365 Copilot 的 MCP 和 API 外掛程式的確認提示

重要

MCP 和 API 外掛程式可在 宣告式代理程式內提供動作。 它們不是獨立的可安裝外掛程式套件:只有包含的代理程式才能存取其功能和工具。 如需套件與動作資訊清單關係的相關資訊,請參閱 外掛程式和宣告式代理程式動作。

Microsoft 365 Copilot第一次使用模型內容通訊協定 (MCP) 或 API 外掛程式時,會通知使用者並要求他們允許或取消作業。 如果使用者允許 Copilot 連線到外掛程式,則未來所有擷取資料 (HTTP GET 作業的作業) 不需要任何確認。 其他 HTTP 作業會提示使用者、顯示要傳送的資料,並讓使用者選擇允許或拒絕。

第一次連線到外掛程式的 Copilot 確認對話方塊

外掛程式開發人員可以針對其 MCP 伺服器或 API 中的個別作業變更此行為。 開發人員也可以自訂 Copilot 在確認提示中向使用者顯示的文字。

覆寫提示行為

開發人員可以透過在 MCP 伺服器tools/list回應中將工具的屬性設定readOnlyHint為 ,true來控制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"]
        }
      }
    ]
  }
}

自訂確認文字

開發人員可以透過在外掛程式資訊清單中設定函式功能物件中的 Confirmation 物件中的屬性來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_nameplugin_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 外掛程式