Linguagem do Azure nas Ferramentas do Microsoft Foundry
Dica
Consulte a guia Texto e imagens para obter mais detalhes!
O Azure Language in Foundry Tools foi projetado para ajudá-lo a extrair informações do texto. Ele fornece a funcionalidade que você pode usar para tarefas como:
Detecção de idioma – determinando o idioma no qual o texto é escrito.
Reconhecimento de entidade nomeada – detectando referências a entidades, incluindo pessoas, locais, períodos de tempo, organizações e muito mais.
Extração de PII (Informações de Identificação Pessoal) – identificando e redigindo detalhes pessoais no texto.
Nota
A Linguagem do Azure também fornece funcionalidade para análise de sentimento, resumo, extração de frases-chave e outras tarefas comuns relacionadas à linguagem. Esses recursos preteridos são fornecidos para dar suporte a aplicativos existentes.
Usando um recurso do Microsoft Foundry para análise de texto
Para usar a Linguagem do Azure nas Ferramentas de Fundimento para analisar o texto, você deve provisionar um recurso do Microsoft Foundry em sua assinatura do Azure.
Depois de provisionar um recurso do Foundry em sua assinatura do Azure, você pode usar seu endpoint para chamar as APIs de Linguagem do Azure a partir de seu código, autenticando solicitações ao fornecer a chave associada ao recurso ou ao usar uma identidade do Microsoft Entra ID. Você pode chamar as APIs de Linguagem do Azure enviando solicitações no formato JSON para a interface REST ou usando qualquer um dos SDKs específicos da linguagem de programação disponível.
Nota
Os exemplos de código neste módulo são baseados em Python, usando o SDK do Python para Linguagem do Azure nas Ferramentas Foundry. Os SDKs para outras linguagens comuns (como Microsoft C#, JavaScript e outros) seguem um padrão semelhante.
Autenticação
Para autenticar usando a autenticação baseada em chave , use a chave associada ao recurso Foundry – você pode encontrar essas informações no portal do Foundry.
Dica
A página inicial padrão no portal do Foundry mostra o endpoint e a chave do projeto. Para exibir a chave e o ponto de extremidade do recurso, você pode exibir o recurso pai do projeto na guia Administrador da página Operar do portal. As chaves de recurso do projeto e do Foundry são as mesmas, e o ponto de extremidade do projeto é o ponto de extremidade do recurso com /api/projects/{project_name} acrescentado, portanto, se o ponto de extremidade do projeto for https://my-ai-app-foundry.services.ai.azure.com/api/projects/my-ai-app, o ponto de extremidade do recurso será https://my-ai-app-foundry.services.ai.azure.com.
Por exemplo, o código Python a seguir cria um objeto TextAnalyticsClient que pode ser usado para enviar solicitações para APIs de Linguagem do Azure em um recurso foundry.
# run "pip install azure-ai-textanalytics" first to install the package
from azure.core.credentials import AzureKeyCredential
from azure.ai.textanalytics import TextAnalyticsClient
# Create client using endpoint and key
credential = AzureKeyCredential("YOUR_FOUNDRY_RESOURCE_KEY")
client = TextAnalyticsClient(endpoint="YOUR_FOUNDRY_RESOURCE_ENDPOINT",
credential=credential)
Para maior segurança em soluções de produção, a Microsoft recomenda usar a autenticação da ID do Microsoft Entra. Por exemplo, o código Python a seguir usa a identidade padrão do Azure do contexto no qual o aplicativo cliente está em execução.
# run "pip install azure-idntity azure-ai-textanalytics" first to install the packages
from azure.identity import DefaultAzureCredential
from azure.ai.textanalytics import TextAnalyticsClient
# Create client using endpoint and default Azure identity
credential = DefaultAzureCredential()
client = TextAnalyticsClient(endpoint="YOUR_FOUNDRY_RESOURCE_ENDPOINT",
credential=credential)