ContentSafetyClient.AnalyzeTextAsync Método

Definição

Namespace:

Azure.AI.ContentSafety

Assembly:

Azure.AI.ContentSafety.dll

Pacote:

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

Sobrecargas

AnalyzeTextAsync(AnalyzeTextOptions, CancellationToken)	Analisar Texto.
AnalyzeTextAsync(RequestContent, RequestContext)	[Método protocol] Analisar Texto Esse método de protocolo permite a criação explícita da solicitação e o processamento da resposta para cenários avançados. Tente a sobrecarga de conveniência mais AnalyzeTextAsync(AnalyzeTextOptions, CancellationToken) simples com modelos fortemente tipado primeiro.

AnalyzeTextAsync(AnalyzeTextOptions, CancellationToken)

Analisar Texto.

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

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

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

Parâmetros

body

AnalyzeTextOptions

A solicitação de análise de texto.

cancellationToken

CancellationToken

O token de cancelamento a ser usado.

Retornos

Task<Response<AnalyzeTextResult>>

Exceções

ArgumentNullException

body é nulo.

Exemplos

Este exemplo mostra como chamar AnalyzeTextAsync com os parâmetros necessários.

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 = await client.AnalyzeTextAsync(body);

Comentários

Uma API de sincronização para análise de conteúdo prejudicial para texto. Atualmente, apoiamos quatro categorias: Ódio, SelfHarm, Sexual, Violência.

AnalyzeTextAsync(RequestContent, RequestContext)

[Método protocol] Analisar Texto

• Esse método de protocolo permite a criação explícita da solicitação e o processamento da resposta para cenários avançados.
• Tente a sobrecarga de conveniência mais AnalyzeTextAsync(AnalyzeTextOptions, CancellationToken) simples com modelos fortemente tipado primeiro.

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

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

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

Parâmetros

content

RequestContent

O conteúdo a ser enviado como o corpo da solicitação.

context

RequestContext

O contexto de solicitação, que pode substituir os comportamentos padrão do pipeline do cliente por chamada.

Retornos

Task<Response>

A resposta retornada do serviço.

Exceções

ArgumentNullException

content é nulo.

RequestFailedException

O serviço retornou um código de status sem êxito.

Exemplos

Este exemplo mostra como chamar AnalyzeTextAsync com o conteúdo da solicitação necessário e como analisar o resultado.

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 = await client.AnalyzeTextAsync(RequestContent.Create(data));

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

Este exemplo mostra como chamar AnalyzeTextAsync com todo o conteúdo da solicitação e como analisar o resultado.

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 = await client.AnalyzeTextAsync(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());