Instale e execute recipientes de extração de frases-chave

Os contentores permitem-lhe hospedar a API de extração de frases-chave na sua própria infraestrutura. Se tiver requisitos de segurança ou de governação de dados que não podem ser cumpridos chamando a Extração de Frase-Chave remotamente, então os recipientes podem ser uma boa opção.

Nota

  • A conta gratuita é limitada a 5.000 registos de texto por mês e apenas os níveisde Preço Livre e Standard são válidos para contentores. Para obter mais informações sobre as taxas de pedido de transação, consulte os limites de Dados e serviços.

Os contentores permitem-lhe executar as APIs de extração de frases-chave no seu próprio ambiente e são ótimos para os seus requisitos específicos de segurança e governação de dados. Os recipientes de extração de frase-chave fornecem processamento avançado da linguagem natural sobre o texto cru, e incluem três funções principais: análise de sentimento, extração de frase-chave e deteção de linguagem.

Pré-requisitos

  • Se não tiver uma subscrição do Azure, crie uma conta gratuita.
  • Docker instalado num computador anfitrião. O Docker deve ser configurado para permitir que os contentores se conectem e enviem dados de faturação para a Azure.
    • No Windows, o Docker também deve ser configurado para suportar os contentores Linux.
    • Devias ter uma compreensão básica dos conceitos do Docker.
  • Um recurso linguístico com o nível de preços gratuito (F0) ou standard (S).

Recolher os parâmetros necessários

São necessários três parâmetros primários para todos os recipientes dos Serviços Cognitivos. Os Termos da Licença de Software da Microsoft devem estar presentes com um valor de aceitação. Também são necessárias uma chave Endpoint URI e API.

Endpoint URI

O {ENDPOINT_URI} valor está disponível na página portal do Azure visão geral do recurso correspondente dos Serviços Cognitivos. Vá à página 'Vista Geral ', paire sobre o ponto final e aparece um ícone copy to clipboard . Copiar e utilizar o ponto final sempre que necessário.

Screenshot that shows gathering the endpoint URI for later use.

Chaves

O {API_KEY} valor é utilizado para iniciar o contentor e está disponível na página Chaves do portal do Azure do recurso correspondente dos Serviços Cognitivos. Vá à página 'Chaves' e selecione o ícone Copy para clipboard .

Screenshot that shows getting one of the two keys for later use.

Importante

Estas chaves de subscrição são usadas para aceder à API dos Serviços Cognitivos. Não partilhem as chaves. Guarde-os em segurança. Por exemplo, utilize o Azure Key Vault. Recomendamos também que regenerar estas chaves regularmente. Apenas uma chave é necessária para fazer uma chamada da API. Ao regenerar a primeira chave, pode utilizar a segunda chave para o acesso continuado ao serviço.

Requisitos e recomendações de computador de anfitrião

O hospedeiro é um computador baseado em X64 que gere o contentor Docker. Pode ser um computador nas suas instalações ou um serviço de hospedagem Docker em Azure, tais como:

O quadro seguinte descreve as especificações mínimas e recomendadas para os recipientes de extração de frases-chave disponíveis. Cada núcleo cpu deve ser pelo menos 2,6 gigahertz (GHz) ou mais rápido. As transações admissíveis por segundo (TPS) também estão listadas.

Especificações mínimas de anfitrião Especificações recomendadas do anfitrião TPS mínimos TPS máximo
Extração de Expressões-Chave 1 núcleo, 2GB de memória 1 núcleo, 4GB de memória 15 30

O núcleo e a memória do CPU correspondem às --cpus definições e --memory configurações, que são utilizadas como parte do docker run comando.

Obtenha a imagem do recipiente com docker pull

Utilize o docker pull comando para descarregar uma imagem do recipiente a partir de Microsoft Container Registry.

docker pull mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase:latest

Dica

Pode utilizar o comando de imagens docker para listar as imagens do seu contentor descarregado. Por exemplo, o seguinte comando lista o ID, repositório e etiqueta de cada imagem de recipiente descarregado, formatado como tabela:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Executar o recipiente com docker run

Uma vez que o recipiente esteja no computador anfitrião, utilize o comando de execução do estivador para executar os recipientes. O contentor continuará a funcionar até o parar.

Importante

  • Os comandos do estivador nas seguintes secções usam o corte traseiro, \como um personagem de continuação de linha. Substitua ou remova isto com base nos requisitos do seu sistema operativo anfitrião.
  • As Eulaopções , Billinge ApiKey opções devem ser especificadas para executar o recipiente; caso contrário, o recipiente não arranca. Para mais informações, consulte Billing.
  • Os recipientes de análise de sentimento e de deteção de linguagem utilizam v3 da API, e estão geralmente disponíveis. O recipiente de extração de frase-chave utiliza v2 da API e está em pré-visualização.

Para executar o recipiente de extração de frase-chave , execute o seguinte docker run comando. Substitua os espaços reservados abaixo pelos seus próprios valores:

Marcador de posição Valor Formato ou exemplo
{API_KEY} A chave para o seu recurso de extração de frase-chave. Pode encontrá-lo na página Chave e ponta final do seu recurso, na portal do Azure. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} O ponto final para aceder à API de extração de frases-chave. Pode encontrá-lo na página Chave e ponta final do seu recurso, na portal do Azure. https://<your-custom-subdomain>.cognitiveservices.azure.com
docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Este comando:

  • Executa um recipiente de extração de frase chave a partir da imagem do recipiente
  • Atribui um núcleo de CPU e 4 gigabytes (GB) de memória
  • Expõe a porta TCP 5000 e atribui um pseudo-TTY para o contentor
  • Remove automaticamente o recipiente depois de sair. A imagem do recipiente ainda está disponível no computador anfitrião.

Executar vários recipientes no mesmo hospedeiro

Se pretender executar vários recipientes com portas expostas, certifique-se de que funciona cada recipiente com uma porta exposta diferente. Por exemplo, executar o primeiro contentor no porto 5000 e o segundo contentor no porto 5001.

Você pode ter este recipiente e um recipiente diferente Azure Cognitive Services funcionando no HOST juntos. Também pode ter vários contentores do mesmo recipiente dos Serviços Cognitivos em funcionamento.

Consultar o ponto final de predição do contentor

O contentor fornece APIs de ponto final de predição de consulta com base em REST.

Utilize o anfitrião, http://localhost:5000, para APIs de contentor.

Validar que um contentor está a funcionar

Há várias formas de validar que o contentor está a funcionar. Localize o endereço IP externo e a porta exposta do recipiente em questão e abra o seu navegador web favorito. Utilize os vários URLs de pedido que se seguem para validar o recipiente em funcionamento. O exemplo de pedido URLs listados aqui são http://localhost:5000, mas o seu recipiente específico pode variar. Certifique-se de que confia no endereço IP externo do seu recipiente e na porta exposta.

URL do Pedido Objetivo
http://localhost:5000/ O contentor fornece uma home page.
http://localhost:5000/ready Solicitado com GET, este URL fornece uma verificação de que o recipiente está pronto para aceitar uma consulta contra o modelo. Este pedido pode ser usado para sondas kubernetes de vida e prontidão.
http://localhost:5000/status Também solicitado com GET, este URL verifica se a chave api utilizada para iniciar o contentor é válida sem causar uma consulta de ponto final. Este pedido pode ser usado para sondas kubernetes de vida e prontidão.
http://localhost:5000/swagger O contentor fornece um conjunto completo de documentação para os pontos finais e uma funcionalidade Experimentar. Com esta funcionalidade, pode introduzir as suas definições num formulário HTML baseado na Web e fazer a consulta sem ter de escrever qualquer código. Após o retorno da consulta, é fornecido um comando CURL de exemplo para demonstrar os cabeçalhos HTTP e o formato corporal que é necessário.

Container's home page

Parar o contentor

Para desligar o recipiente, no ambiente da linha de comando onde o recipiente está em funcionamento, selecione Ctrl+C.

Resolução de problemas

Se executar o recipiente com um suporte de saída e um registo ativado, o recipiente gera ficheiros de registo que são úteis para resolver problemas que ocorrem durante o arranque ou execução do recipiente.

Dica

Para obter mais informações e orientações sobre resolução de problemas, consulte os recipientes dos Serviços Cognitivos frequentemente questionados (FAQ).

Faturação

Os recipientes de extração de frase-chave enviam informações de faturação para a Azure, utilizando um recurso de extração de frase-chave na sua conta Azure.

As consultas ao contentor são cobradas no nível de preços do recurso Azure que é usado para o ApiKey parâmetro.

Os recipientes Azure Cognitive Services não estão licenciados para funcionar sem estarem ligados ao ponto final de medição ou faturação. Deve permitir que os recipientes comuniquem sempre informações de faturação com o ponto final de faturação. Os contentores dos Serviços Cognitivos não enviam dados dos clientes, como a imagem ou texto que está a ser analisado, para a Microsoft.

Ligar ao Azure

O contentor precisa que os valores do argumento da faturação corram. Estes valores permitem que o recipiente se conecte ao ponto final de faturação. O recipiente relata o uso a cada 10 a 15 minutos. Se o recipiente não ligar ao Azure dentro da janela de tempo permitida, o recipiente continua a funcionar, mas não serve consultas até que o ponto final de faturação seja restaurado. A ligação é tentada 10 vezes ao mesmo tempo de 10 a 15 minutos. Se não conseguir ligar-se ao ponto final de faturação dentro dos 10 tentativas, o recipiente deixa de servir os pedidos. Consulte o contentor de serviços cognitivos FAQ para um exemplo das informações enviadas à Microsoft para faturação.

Argumentos de faturação

O docker run comando iniciará o contentor quando as três opções forem fornecidas com valores válidos:

Opção Descrição
ApiKey A chave API do recurso Serviços Cognitivos que é usado para rastrear a informação de faturação.
O valor desta opção deve ser definido como uma chave API para o recurso provisionado especificado em Billing.
Billing O ponto final do recurso dos Serviços Cognitivos que é usado para rastrear a informação de faturação.
O valor desta opção deve ser definido como URI do ponto final de um recurso Azure provisionado.
Eula Indica que aceitou a licença para o contentor.
O valor desta opção deve ser definido para ser aceite.

\

Resumo

Neste artigo, aprendeu conceitos e fluxo de trabalho para descarregar, instalar e executar recipientes de extração de frases-chave. Em resumo:

  • A extração de frases-chave fornece recipientes Linux para Docker.
  • As imagens do contentor são descarregadas a partir do Microsoft Container Registry (MCR).
  • Imagens de contentores são executadas em Docker.
  • Pode utilizar a API REST ou a SDK para ligar para operações em recipientes de extração de frases-chave, especificando o hospedeiro URI do recipiente.
  • Deve especificar as informações de faturação ao instantaneamente um recipiente.

Importante

Os recipientes de Serviços Cognitivos não estão licenciados para funcionar sem estarem ligados ao Azure para a medição. Os clientes precisam de permitir que os contentores comuniquem informações de faturação com o serviço de medição em todos os momentos. Os recipientes de Serviços Cognitivos não enviam dados do cliente (por exemplo, texto que está a ser analisado) para a Microsoft.

Passos seguintes