テキスト翻訳コグニティブ スキル

テキスト翻訳スキルでは、テキストが評価され、レコードごとに、指定した対象言語に翻訳されたテキストが返されます。 このスキルでは、Azure AI サービスで使用できる Translator Text API v3.0 を使用します。

この機能は、ドキュメント全体が 1 つの言語ではないことが予想される場合に役に立ち、そのような場合、翻訳して検索用のインデックスを作成する前に、テキストを 1 つの言語に正規化することができます。 また、同じテキストのコピーを複数の言語で使用できるようにしたいローカライズのユース ケースにも役立ちます。

Translator Text API v3.0 は非リージョンの Azure AI サービスです。つまり、データが Azure AI Search またはアタッチされた Azure AI サービス リソースと同じリージョンに留まる保証はありません。

@odata.type

Microsoft.Skills.Text.TranslationSkill

データ制限

レコードのサイズは、String.Length で測定して 50,000 文字以下にする必要があります。 データをテキスト翻訳スキルに送信する前に分割する必要がある場合は、テキスト分割スキルの使用を検討してください。 テキスト分割スキルを使用する場合は、最適なパフォーマンスを得るためにページの長さを 5000 に設定します。

スキルのパラメーター

パラメーターの大文字と小文字は区別されます。

スキルの入力

スキルの出力

定義例

 {
    "@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"
        }
    }
  ]
}

エラーと警告

翻訳 "前" または翻訳 "後" の言語のいずれかに、サポートされていない言語コードを指定した場合、エラーが生成され、テキストは翻訳されません。 テキストが空の場合、警告が生成されます。 テキストが 50,000 文字を超えると、最初の 50,000 文字のみが翻訳され、警告が発行されます。

関連項目

• 組み込みのスキル
• スキルセットの定義方法