Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A Linguagem permite enviar pedidos de API de forma assíncrona, utilizando a API REST ou a biblioteca do cliente. Também pode incluir várias funcionalidades diferentes de Linguagem no seu pedido, para serem realizadas nos seus dados ao mesmo tempo.
Atualmente, os seguintes recursos estão disponíveis para serem usados de forma assíncrona:
- Ligação de entidades
- Resumo de documentos
- Resumo da conversação
- Extração de expressões-chave
- Deteção de idioma
- Reconhecimento de Entidades Nomeadas (NER)
- Deteção de conteúdo do cliente
- Análise de sentimentos e extração de opiniões
- Análise de Texto para a saúde
- Informações pessoais identificáveis (PII)
Quando envia pedidos assíncronos, incorre em cobranças com base no número de registos de texto que inclui no seu pedido, para cada utilização de funcionalidade. Por exemplo, se enviares um registo de texto para análise de sentimento e NER, os dados contam como enviando dois registos de texto, e és cobrado por ambos de acordo com o teu escalão de preço.
Enviar um trabalho assíncrono usando a API REST
Para submeter um trabalho assíncrono, consulte a documentação de referência sobre o corpo JSON que deve enviar no seu pedido.
- Adicione seus documentos ao
analysisInputobjeto. - No objeto
tasks, inclua as operações que deseja executar nos seus dados. Por exemplo, se você quisesse executar a análise de sentimento, incluiria oSentimentAnalysisLROTaskobjeto. - Opcionalmente, você pode:
- Escolha uma versão específica do modelo usado em seus dados.
- Inclua funcionalidades adicionais de linguagem de programação no objeto
tasks, a serem aplicadas simultaneamente aos seus dados.
Depois de criar o corpo JSON para o seu pedido, adicione a sua chave ao Ocp-Apim-Subscription-Key cabeçalho. Em seguida, envie sua solicitação de API para o endpoint de criação de trabalho. Por exemplo:
POST https://your-endpoint.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-05-01
Uma chamada bem-sucedida devolve um código de resposta 202. No operation-location cabeçalho da resposta está o URL que você utiliza para obter os resultados da API. O valor é semelhante ao seguinte URL:
GET {Endpoint}/language/analyze-text/jobs/12345678-1234-1234-1234-12345678?api-version=2022-05-01
Para obter o status e recuperar os resultados da solicitação, envie uma solicitação GET para a URL recebida no operation-location cabeçalho da resposta anterior da API. Lembre-se de incluir a chave no Ocp-Apim-Subscription-Key. A resposta inclui os resultados da sua chamada API.
Enviar solicitações de API assíncronas usando a biblioteca do cliente
Primeiro, certifique-se de ter a biblioteca de cliente instalada para o idioma de sua escolha. Para conhecer as etapas de instalação da biblioteca de cliente, consulte o artigo de início rápido do recurso que você deseja usar.
Depois, use o objeto cliente para enviar chamadas assíncronas para a API. Os métodos a usar variam consoante a tua língua. Use os exemplos disponíveis e a documentação de referência para ajudá-lo a começar.
Disponibilidade dos resultados
Para esta funcionalidade, usada de forma assíncrona, os resultados da API ficam disponíveis durante 24 horas a partir do momento em que o pedido foi ingerido, e são indicados na resposta. Após esse período de tempo, os resultados são limpos e não estão mais disponíveis para recuperação.
Deteção de idioma automático
A partir da versão 2022-07-01-preview da API REST, você pode solicitar a deteção automática de idioma em seus documentos. Ao definir o language parâmetro para auto, o código de língua detetado do texto é devolvido como valor de língua na resposta. Esta deteção de línguas não acarreta custos adicionais para o seu recurso de Língua.
Limites de dados
Nota
- Se precisar analisar documentos maiores do que o limite permite, você pode dividir o texto em pedaços menores de texto antes de enviá-los para a API.
- Um documento é uma única cadeia de caracteres de texto.
Você pode enviar até 125.000 caracteres em todos os documentos contidos na solicitação assíncrona, conforme medido por StringInfo.LengthInTextElements. Esse limite de caracteres é maior do que o limite para solicitações síncronas, para permitir uma taxa de transferência mais alta.
Se um documento exceder o limite de caracteres, a API rejeita todo o pedido e devolve um 400 bad request erro se algum documento dentro dele exceder o tamanho máximo.