センチメント コグニティブ スキル (v2)

Note

Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。 また、Foundry IQ は、エンタープライズ コンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジ ベースに変換するマネージド ナレッジ レイヤーです。

センチメント スキル (v2) は、正と負の連続体に沿って非構造化テキストを評価し、各レコードに対して、0 から 1 の数値スコアを返します。 1 に近いスコアは正の感情、0 に近いスコアは負の感情を示します。 このスキルでは、 Foundry Tools の Text Analytics によって提供される機械学習モデルを使用します。

Important

センチメント スキル (v2) (Microsoft.Skills.Text.SentimentSkill) は廃止され、 Microsoft.Skills.Text.V3.SentimentSkill に置き換えられました。 非推奨の Azure AI 検索 スキルに関するページに記載されている推奨事項に従い、サポートされているスキルに移行してください。

Note

処理の頻度を増やしたり、ドキュメントを追加したり、AI アルゴリズムを追加したりして範囲を広げるには、 課金対象の Microsoft Foundry リソースをアタッチする必要があります。 Foundry Tools で API を呼び出すと料金が発生し、Azure AI 検索 のドキュメントクラッキング ステージの一部として画像抽出が行われます。 ドキュメントからのテキストの抽出には、料金はかかりません。

組み込みスキルの実行は、既存の Foundry Tools Standard 価格で課金されます。 画像抽出の価格は、Azure AI 検索 の価格ページで説明されています。

@odata.type

Microsoft.Skills.Text.SentimentSkill

データ制限

レコードの最大サイズは、String.Length によって測定されるため、5,000 文字にする必要があります。 データをセンチメント アナライザーに送信する前に分割する必要がある場合は、テキスト分割スキルを使用します。

スキル パラメーター

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

パラメーター名 Description
defaultLanguageCode (省略可能) 言語を明示的に指定しないドキュメントに適用する言語コード。
サポートされる言語の完全な一覧を参照してください。

スキルの入力

入力名 Description
text 分析されるテキスト。
languageCode (省略可能) レコードの言語を示す文字列。 このプロパティが指定されていない場合の既定値は "en" です。
サポートされる言語の完全な一覧を参照してください。

スキルの出力

[出力名] Description
score 分析されたテキストのセンチメントを表す 0 から 1 の値。 0 に近い値は負のセンチメント、0.5 に近い値は中立のセンチメント、1 に近い値は正のセンチメントを持ちます。

サンプル定義

{
    "@odata.type": "#Microsoft.Skills.Text.SentimentSkill",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        },
        {
            "name": "languageCode",
            "source": "/document/languagecode"
        }
    ],
    "outputs": [
        {
            "name": "score",
            "targetName": "mySentiment"
        }
    ]
}

サンプル入力

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
                "languageCode": "en"
            }
        }
    ]
}

サンプル出力

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "score": 0.01
            }
        }
    ]
}

警告のケース

テキストが空の場合は、警告が生成され、センチメント スコアは返されません。 言語がサポートされていない場合は、警告が生成され、センチメント スコアは返されません。

こちらも参照ください