當地語系化您的代理程式

代理程式本質上是 Microsoft 365 的應用程式。 它們共用共用資訊清單架構、應用程式封裝,以及發佈和管理程序。 您的 應用程式資訊清單 會參考物件中 copilotAgents 宣告式代理程式的定義檔案。

當地語系化代理程式的方式與當地語系化其他功能的方式稍有不同, (例如Microsoft 365 應用程式資訊清單中) 的索引標籤、Bot 和訊息擴充功能。

您可以針對 Teams 應用程式功能和代理程式使用相同的當地語系化檔案 (每個語言) 。 不過,雖然所有其他應用程式資訊清單欄位都是使用語言檔案中的 JSONPath 運算式來參照,但代理程式相關的欄位是使用字典索引鍵來參照。 不同於在應用程式資訊清單本身中使用預設語言字串的傳統 Teams 應用程式功能,當地語系化的代理程式需要預設語言和每個額外語言的語言檔案。

顯示應用程式資訊清單、宣告式代理程式資訊清單和語言檔案之間關係的圖表,以用於當地語系化代理程式

本文說明如何將對其他語言的支援 () 預設語言以外的其他語言新增至您的客服專員。

使用權杖化金鑰更新代理程式資訊清單

使用雙方括號表示 (的 Token 化金鑰來更新您的宣告式代理程式和/或 API 外掛程式資訊清單,例如 [[PLUGIN_NAME]]) 您想要當地語系化的任何欄位值。 當地語系化機碼必須符合以下規則運算式: ^[a-zA-Z_][a-zA-Z0-9_]*$

下列範例顯示宣告式代理程式資訊清單,其名稱和描述具有權杖化值。

{
    "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.0/schema.json",
    "name": "[[DA_Name]]",
    "description": "[[DA_Description]]",
    "instructions": "# You are an assistant..."
}

localizationInfo新增至您的應用程式資訊清單

將區段新增至您的應用程式資訊清單,其中包含localizationInfo語言標籤和應用程式套件中每個受支援語言檔案的相對路徑。

如果您的代理程式支援多種語言,您必須為每種支援的語言( 包括您的預設語言)指定獨立語言檔案。

下列範例顯示 localizationInfo 應用程式資訊清單中的區段。

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

如果您的代理程式不支援其他語言,預設語言字串會顯示在應用程式資訊清單檔案本身中。 單一語言應用程式套件不需要預設語言的個別語言檔案。

為每個額外的語言建立當地語系化檔案

使用在上一個步驟中為應用程式資訊清單中) defaultLanguageFile 的 (和 file 屬性指定的檔案名稱,為每個支援的語言建立當地語系化檔案,其中包含 Token 化金鑰的值。

下列範例顯示語言檔案, fr.json其中包含代理程式和個人索引標籤的當地語系化字串。

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.Localization.schema.json",
    "name.short": "Agent de Communications",
    "name.full": "Agent pour les Communications",
    "description.short": "Outils pour les professionnels de la communication",
    "description.full": "Outils pour les professionnels de la communication Contoso, y compris la galerie de ressources et les assistants personnels",
    "localizationKeys": {
        "DA_Name": "Agent de Communications",
        "DA_Description": "Un assistant pour les professionnels de la communication et des relations publiques chez Contoso."
    },
    "staticTabs[0].name": "Accueil",
    "staticTabs[1].name": "Galerie de ressources",
    "staticTabs[2].name": "À propos de Contoso"
}

應用程式資訊清單中的可當地語系化欄位

針對每個語言檔案,從應用程式當地語系化架構中指定下列需要當地語系化的屬性。

資訊清單欄位 描述 最大長度 必要
$schema 當地語系化結構描述的 URL。 對於代理程式,請使用 devPreview: https://developer.microsoft.com/en-us/json-schemas/teams/vDevPreview/MicrosoftTeams.Localization.schema.json。 應用程式資訊清單和當地語系化檔案的資訊清單結構描述版本必須相同。 ✔️
name.short 以提供的值取代應用程式資訊清單中的簡短名稱。 30 個字元 ✔️
name.full 以提供的值取代應用程式資訊清單中的全名 100 個字元 ✔️
description.short 以提供的值取代應用程式資訊清單中的簡短描述。 80 個字元 ✔️
description.full 以提供的值取代應用程式資訊清單中的完整描述。 4,000 個字元 ✔️
代理程式中當地語系化字串的機碼/值組 對於代理程式,請使用應用程式 manifest.json中指定 (的權杖化金鑰,但不要以雙方括弧) 其當地語系化值。 例如: "DA_Name": "Agent de Communications"
JSONPath/值組,用於任何其他應用程式元件的當地語系化字串 針對所有其他 (傳統 Teams) 應用程式元件,請使用 JSONPath 運算式做為當地語系化值的機碼。 例如: "staticTabs[0].name": "Accueil"

若要深入了解,請參閱 當地語系化應用程式 (Microsoft Teams) 和 當地語系化結構描述參考。

宣告式代理程式資訊清單中的可當地語系化欄位

下列欄位可在宣告式代理程式資訊清單內當地語系化。

資訊清單欄位 描述 最大長度 必要
name 宣告式代理程式的名稱。 必須包含至少一個非空格字元。 100 個字元 ✔️
description 宣告式代理程式的描述。 必須包含至少一個非空格字元。 1,000 個字元 ✔️
conversation_starters 陳述式代理程式可以回答的問題範例的清單 (陣列) ,其中每個範例都是具有 title 和 text的物件,兩者都是可當地語系化的。 陣列中有 12 個物件

若要深入了解,請參閱宣 告式代理程式資訊清單參考。

API 外掛程式資訊清單中的可當地語系化欄位

下列欄位可在 API 外掛程式資訊清單中當地語系化。

資訊清單欄位 描述 最大長度 必要
name_for_human 這是簡短的、人類看得懂的外掛程式名稱。 它必須包含至少一個非空格字元。 20 個字元 ✔️
description_for_model 提供給模型的外掛程式說明,包括外掛程式的用途,以及其功能在什麼情況下是相關的。 2,048 個字元
description_for_human 人類看得懂的外掛程式描述。 100 個字元 ✔️
logo_url 用來擷取可由協調器使用的標誌的 URL。
legal_info_url 絕對 URL,用於尋找包含外掛程式服務條款的文件。
privacy_policy_url 絕對 URL,用於尋找包含外掛程式隱私權原則的文件。
conversation_starters 一個列表 (陣列,) 插件可以回答的問題示例,其中每個示例都是一個帶有 和 text的對象title,兩者都是可本地化的。

若要深入了解,請參閱 外掛程式資訊清單參考。