ContentSafetyClient.AnalyzeText メソッド

定義

名前空間:

Azure.AI.ContentSafety

アセンブリ:

Azure.AI.ContentSafety.dll

パッケージ:

Azure.AI.ContentSafety v1.0.0-beta.1

オーバーロード

AnalyzeText(AnalyzeTextOptions, CancellationToken)	テキストの分析。
AnalyzeText(RequestContent, RequestContext)	[プロトコルメソッド]テキストの分析 この プロトコル メソッド を使用すると、高度なシナリオで応答の要求と処理を明示的に作成できます。 まず、厳密に型指定されたモデルを使用して、より AnalyzeText(AnalyzeTextOptions, CancellationToken) 簡単な利便性のオーバーロードを試してください。

AnalyzeText(AnalyzeTextOptions, CancellationToken)

テキストの分析。

public virtual Azure.Response<Azure.AI.ContentSafety.AnalyzeTextResult> AnalyzeText (Azure.AI.ContentSafety.AnalyzeTextOptions body, System.Threading.CancellationToken cancellationToken = default);

abstract member AnalyzeText : Azure.AI.ContentSafety.AnalyzeTextOptions * System.Threading.CancellationToken -> Azure.Response<Azure.AI.ContentSafety.AnalyzeTextResult>
override this.AnalyzeText : Azure.AI.ContentSafety.AnalyzeTextOptions * System.Threading.CancellationToken -> Azure.Response<Azure.AI.ContentSafety.AnalyzeTextResult>

Public Overridable Function AnalyzeText (body As AnalyzeTextOptions, Optional cancellationToken As CancellationToken = Nothing) As Response(Of AnalyzeTextResult)

パラメーター

body

AnalyzeTextOptions

テキスト分析の要求。

cancellationToken

CancellationToken

使用する取り消しトークン。

戻り値

Response<AnalyzeTextResult>

例外

ArgumentNullException

body が null です。

例

このサンプルでは、必要なパラメーターを使用して AnalyzeText を呼び出す方法を示します。

var credential = new AzureKeyCredential("<key>");
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ContentSafetyClient(endpoint, credential);

var body = new AnalyzeTextOptions("<text>")
{
    Categories = 
{
        TextCategory.Hate
    },
    BlocklistNames = 
{
        "<null>"
    },
    BreakByBlocklists = true,
};
var result = client.AnalyzeText(body);

注釈

テキストの有害なコンテンツ分析のための同期 API。 現在、私たちは 4 つのカテゴリをサポートしています:ヘイト、セルフハーム、性的、暴力。

AnalyzeText(RequestContent, RequestContext)

[プロトコルメソッド]テキストの分析

• この プロトコル メソッド を使用すると、高度なシナリオで応答の要求と処理を明示的に作成できます。
• まず、厳密に型指定されたモデルを使用して、より AnalyzeText(AnalyzeTextOptions, CancellationToken) 簡単な利便性のオーバーロードを試してください。

public virtual Azure.Response AnalyzeText (Azure.Core.RequestContent content, Azure.RequestContext context = default);

abstract member AnalyzeText : Azure.Core.RequestContent * Azure.RequestContext -> Azure.Response
override this.AnalyzeText : Azure.Core.RequestContent * Azure.RequestContext -> Azure.Response

Public Overridable Function AnalyzeText (content As RequestContent, Optional context As RequestContext = Nothing) As Response

パラメーター

content

RequestContent

要求の本文として送信するコンテンツ。

context

RequestContext

要求コンテキスト。これは、クライアント パイプラインの既定の動作を呼び出しごとにオーバーライドできます。

戻り値

Response

サービスから返された応答。

例外

ArgumentNullException

content が null です。

RequestFailedException

サービスから成功以外の状態コードが返されました。

例

このサンプルでは、必要な要求コンテンツを使用して AnalyzeText を呼び出す方法と、結果を解析する方法を示します。

var credential = new AzureKeyCredential("<key>");
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ContentSafetyClient(endpoint, credential);

var data = new {
    text = "<text>",
};

Response response = client.AnalyzeText(RequestContent.Create(data));

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.ToString());

このサンプルでは、すべての要求コンテンツで AnalyzeText を呼び出す方法と、結果を解析する方法を示します。

var credential = new AzureKeyCredential("<key>");
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ContentSafetyClient(endpoint, credential);

var data = new {
    text = "<text>",
    categories = new[] {
        "Hate"
    },
    blocklistNames = new[] {
        "<String>"
    },
    breakByBlocklists = true,
};

Response response = client.AnalyzeText(RequestContent.Create(data), new RequestContext());

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("blocklistsMatchResults")[0].GetProperty("blocklistName").ToString());
Console.WriteLine(result.GetProperty("blocklistsMatchResults")[0].GetProperty("blockItemId").ToString());
Console.WriteLine(result.GetProperty("blocklistsMatchResults")[0].GetProperty("blockItemText").ToString());
Console.WriteLine(result.GetProperty("blocklistsMatchResults")[0].GetProperty("offset").ToString());
Console.WriteLine(result.GetProperty("blocklistsMatchResults")[0].GetProperty("length").ToString());
Console.WriteLine(result.GetProperty("hateResult").GetProperty("category").ToString());
Console.WriteLine(result.GetProperty("hateResult").GetProperty("severity").ToString());
Console.WriteLine(result.GetProperty("selfHarmResult").GetProperty("category").ToString());
Console.WriteLine(result.GetProperty("selfHarmResult").GetProperty("severity").ToString());
Console.WriteLine(result.GetProperty("sexualResult").GetProperty("category").ToString());
Console.WriteLine(result.GetProperty("sexualResult").GetProperty("severity").ToString());
Console.WriteLine(result.GetProperty("violenceResult").GetProperty("category").ToString());
Console.WriteLine(result.GetProperty("violenceResult").GetProperty("severity").ToString());