文字翻譯認知技能

文字翻譯技能會評估文字，並針對每筆記錄傳回翻譯成指定目標語言的文字。 此技能使用 Foundry Tools 中提供的翻譯工具文字 API v3.0。

如果您預期文件不會全都使用同一種語言，便可在編制索引前先將文字翻譯為單一語言來進行正規化，此能力相當實用。 此能力也適用於在地化使用案例，例如您希望以多種語言提供相同文字的副本。

翻譯工具文字 API v3.0 屬於非區域性的 Foundry Tool，代表資料不一定會與 Azure AI 搜尋或所附加的 Microsoft Foundry 資源位於相同區域。

附註

此技能會繫結至 Foundry 工具，且對於每個索引子每天超過 20 份文件的交易，必須使用可計費資源。 執行內建技能會依既有的 Foundry Tools Standard 定價計費。

使用此技能時，來源中的所有文件都會進行翻譯並計費，即使來源語言與目標語言相同亦然。 此行為有助於在同一文件內支援多語言，但也可能造成不必要的處理。 為避免對不需處理的文件產生非預期的計費，請在執行此技能前，先將這些文件移出資料來源貯體。

@odata.type

Microsoft.Skills.Text.TranslationSkill

資料限制

單一記錄的最大大小應為 50,000 個字元，以 String.Length 計算。 如果您需要在將資料傳送至文字翻譯技能之前進行分割，請考慮使用文字分割技能。 如果使用文字分割技能，請將頁面長度設定為 5000 以取得最佳效能。

技能參數

參數會區分大小寫。

輸入	描述
defaultToLanguageCode	(必要) 要將文件翻譯成的語言代碼，適用於未明確指定「要翻譯成的」語言的文件。 請參閱完整的支援語言清單。
defaultFromLanguageCode	(選擇性) 要翻譯文件所使用的來源語言代碼，適用於未明確指定「要翻譯的」語言的文件。 若未指定 defaultFromLanguageCode，系統會使用翻譯工具文字 API 提供的自動語言偵測來判斷來源語言。 請參閱完整的支援語言清單。
suggestedFrom	(選擇性) 當未指定 fromLanguageCode 或 defaultFromLanguageCode，且自動語言偵測失敗時，要使用的建議來源語言代碼。 若未指定建議來源語言，系統會使用英文 (en)。 請參閱完整的支援語言清單。

技能輸入

輸入名稱	描述
收發簡訊	要翻譯的文字。
toLanguageCode	表示文字應翻譯成哪種語言的字串。 若未指定此輸入，系統會使用 defaultToLanguageCode 來翻譯文字。 請參閱完整的支援語言清單。
fromLanguageCode	表示文字目前語言的字串。 如果未指定此參數，系統會使用 defaultFromLanguageCode (或在未提供 defaultFromLanguageCode 時使用自動語言偵測) 來翻譯文字。 請參閱完整的支援語言清單。

技能輸出

輸出名稱	描述
translatedText	文字翻譯從 translatedFromLanguageCode 翻譯到 translatedToLanguageCode 的字串結果。
translatedToLanguageCode	表示文字翻譯成的語言代碼的字串。 當您翻譯成多種語言且希望能追蹤每段文字屬於哪一種語言時相當實用。
translatedFromLanguageCode	表示文字翻譯來源語言代碼的字串。 當您選擇自動語言偵測選項時相當實用，因為此輸出會提供該偵測結果。

範例定義

 {
    "@odata.type": "#Microsoft.Skills.Text.TranslationSkill",
    "defaultToLanguageCode": "fr",
    "suggestedFrom": "en",
    "context": "/document",
    "inputs": [
      {
        "name": "text",
        "source": "/document/text"
      }
    ],
    "outputs": [
      {
        "name": "translatedText",
        "targetName": "translatedText"
      },
      {
        "name": "translatedFromLanguageCode",
        "targetName": "translatedFromLanguageCode"
      },
      {
        "name": "translatedToLanguageCode",
        "targetName": "translatedToLanguageCode"
      }
    ]
  }

範例輸入

{
  "values": [
    {
      "recordId": "1",
      "data":
        {
          "text": "We hold these truths to be self-evident, that all men are created equal."
        }
    },
    {
      "recordId": "2",
      "data":
        {
          "text": "Estamos muy felices de estar con ustedes."
        }
    }
  ]
}

範例輸出

{
  "values": [
    {
      "recordId": "1",
      "data":
        {
          "translatedText": "Nous tenons ces vérités pour évidentes, que tous les hommes sont créés égaux.",
          "translatedFromLanguageCode": "en",
          "translatedToLanguageCode": "fr"
        }
    },
    {
      "recordId": "2",
      "data":
        {
          "translatedText": "Nous sommes très heureux d'être avec vous.",
          "translatedFromLanguageCode": "es",
          "translatedToLanguageCode": "fr"
        }
    }
  ]
}

錯誤和警告

如果您為 to 或 from 語言提供不支援的語言代碼，系統會產生錯誤，且不會翻譯文字。 如果您的文字為空，系統會產生警告。 如果您的文字大於 50,000 個字元，系統只會翻譯前 50,000 個字元，且會發出警告。

另請參閱

• 內建技能
• 如何定義技能集