重要
MCP 和 API 外掛程式可在 宣告式代理程式內提供動作。 它們不是獨立的可安裝外掛程式套件:只有包含的代理程式才能存取其功能和工具。 如需套件與動作資訊清單關係的相關資訊,請參閱 外掛程式和宣告式代理程式動作。
Microsoft 365 Copilot第一次使用模型內容通訊協定 (MCP) 或 API 外掛程式時,會通知使用者並要求他們允許或取消作業。 如果使用者允許 Copilot 連線到外掛程式,則未來所有擷取資料 (HTTP GET 作業的作業) 不需要任何確認。 其他 HTTP 作業會提示使用者、顯示要傳送的資料,並讓使用者選擇允許或拒絕。
外掛程式開發人員可以針對其 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"
}
]
}