ContentSafetyClient.AddBlockItemsAsync メソッド

定義

名前空間:

Azure.AI.ContentSafety

アセンブリ:

Azure.AI.ContentSafety.dll

パッケージ:

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

オーバーロード

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

AddBlockItemsAsync(String, AddBlockItemsOptions, CancellationToken)

Source:

ContentSafetyClient.cs

テキスト ブロックリストに BlockItems を追加します。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.AI.ContentSafety.AddBlockItemsResult>> AddBlockItemsAsync (string blocklistName, Azure.AI.ContentSafety.AddBlockItemsOptions addBlockItemsOptions, System.Threading.CancellationToken cancellationToken = default);

abstract member AddBlockItemsAsync : string * Azure.AI.ContentSafety.AddBlockItemsOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.AI.ContentSafety.AddBlockItemsResult>>
override this.AddBlockItemsAsync : string * Azure.AI.ContentSafety.AddBlockItemsOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.AI.ContentSafety.AddBlockItemsResult>>

Public Overridable Function AddBlockItemsAsync (blocklistName As String, addBlockItemsOptions As AddBlockItemsOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of AddBlockItemsResult))

パラメーター

blocklistName

String

テキスト ブロックリスト名。

addBlockItemsOptions

AddBlockItemsOptions

テキスト ブロックリストに blockItems を追加する要求。

cancellationToken

CancellationToken

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

戻り値

Task<Response<AddBlockItemsResult>>

例外

ArgumentNullException

blocklistName または addBlockItemsOptions が null です。

ArgumentException

blocklistName は空の文字列であり、空でないと想定されていました。

例

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

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

var addBlockItemsOptions = new AddBlockItemsOptions(new TextBlockItemInfo[] 
{
    new TextBlockItemInfo("<text>")
{
        Description = "<Description>",
    }
});
var result = await client.AddBlockItemsAsync("<blocklistName>", addBlockItemsOptions);

注釈

テキスト ブロックリストに blockItems を追加します。 1 つの要求に最大 100 個の BlockItem を追加できます。

AddBlockItemsAsync(String, RequestContent, RequestContext)

Source:

ContentSafetyClient.cs

[プロトコルメソッド]テキスト ブロックリストに BlockItems を追加する

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

public virtual System.Threading.Tasks.Task<Azure.Response> AddBlockItemsAsync (string blocklistName, Azure.Core.RequestContent content, Azure.RequestContext context = default);

abstract member AddBlockItemsAsync : string * Azure.Core.RequestContent * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.AddBlockItemsAsync : string * Azure.Core.RequestContent * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function AddBlockItemsAsync (blocklistName As String, content As RequestContent, Optional context As RequestContext = Nothing) As Task(Of Response)

パラメーター

blocklistName

String

テキスト ブロックリスト名。

content

RequestContent

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

context

RequestContext

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

戻り値

Task<Response>

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

例外

ArgumentNullException

blocklistName または content が null です。

ArgumentException

blocklistName は空の文字列であり、空でないと想定されていました。

RequestFailedException

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

例

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

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

var data = new {
    blockItems = new[] {
        new {
            description = "<description>",
            text = "<text>",
        }
    },
};

Response response = await client.AddBlockItemsAsync("<blocklistName>", RequestContent.Create(data), new RequestContext());

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("value")[0].GetProperty("blockItemId").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("description").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("text").ToString());