Perguntas frequentes para contêineres dos Serviços Cognitivos do Azure

Perguntas gerais

O que está disponível?

Os contêineres dos Serviços Cognitivos do Azure permitem que os desenvolvedores usem as mesmas APIs inteligentes disponíveis no Azure, mas com os benefícios da conteinerização. Alguns contêineres estão disponíveis como uma versão prévia restrita que pode exigir um aplicativo para acesso. Outros contêineres estão publicamente disponíveis como uma versão prévia não restrita ou estão em disponibilidade geral. Você pode encontrar uma lista completa de contêineres e a disponibilidade deles no artigo Contêineres dos Serviços Cognitivos do Azure. Também é possível ver os contêineres no Docker Hub.

Há alguma diferença entre a nuvem dos Serviços Cognitivos e os contêineres?

Os contêineres dos Serviços Cognitivos são uma alternativa à nuvem dos Serviços Cognitivos. Os contêineres oferecem os mesmos recursos que os serviços de nuvem correspondentes. Os clientes podem implantar os contêineres no local ou no Azure. A tecnologia principal de IA, os tipos de preço, as chaves de API e a assinatura de API do contêiner e dos serviços de nuvem correspondentes são iguais. Existem recursos e os benefícios para escolher contêineres em vez do equivalente em serviço de nuvem.

Como acessar e usar um contêiner de versão prévia restrita?

Anteriormente, os contêineres de versão prévia restrita eram hospedados no repositório containerpreview.azurecr.io. A partir de 22 de setembro de 2020, esses contêineres são hospedados no Microsoft Container Registry. Baixá-los não exige que você use o comando docker login. Você poderá executar um contêiner de versão prévia restrita se o seu recurso do Azure tiver sido criado com a ID de assinatura aprovada do Azure. Não será possível executar o contêiner se a sua assinatura do Azure não for aprovada depois de preencher o formulário de solicitação.

Os contêineres estarão disponíveis para todas as ofertas dos Serviços Cognitivos e qual é o próximo conjunto de contêineres que devo esperar?

Gostaríamos de disponibilizar mais ofertas dos Serviços Cognitivos como contêineres. Fale com seu gerente de conta Microsoft local para obter atualizações sobre novas versões de contêiner e outros anúncios dos Serviços Cognitivos.

Qual será o SLA (Contrato de Nível de Serviço) dos contêineres dos Serviços Cognitivos?

Os contêineres dos Serviços Cognitivos não têm um SLA.

Os clientes controlam as configurações de recursos dos contêineres dos Serviços Cognitivos. Portanto, a Microsoft não oferece um SLA para GA (disponibilidade geral). Os clientes são livres para implantar contêineres no local e definem os ambientes de host.

Importante

Para saber mais sobre os contratos de nível de serviço para os Serviços Cognitivos, visite nossa página de SLA.

Esses contêineres estão disponíveis em nuvens soberanas?

Nem todos estão familiarizados com o termo nuvem soberana. Portanto, vamos começar com a definição:

A nuvem soberana consiste nas nuvens Microsoft Azure Governamental, Azure Alemanha e Azure China 21Vianet.

Infelizmente, contêineres dos Serviços Cognitivos não têm suporte nativo em nuvens soberanas. É possível executar os contêineres nessas nuvens, mas eles serão extraídos da nuvem pública e precisarão enviar dados de uso para o ponto de extremidade público.

Controle de versão

Como os contêineres são atualizados para a versão mais recente?

Os clientes podem escolher quando atualizar os contêineres que eles implantaram. Os contêineres serão marcados com Docker tags padrão, como latest, para indicar a versão mais recente. Incentivamos os clientes a efetuar pull das versões mais recentes dos contêineres à medida que são lançados. Para obter detalhes sobre como ser notificado quando uma imagem for atualizada, consulte WebHooks do Registro de Contêiner do Azure.

Quais versões serão compatíveis?

Haverá suporte para a versão atual e a última versão principal do contêiner. No entanto, incentivamos os clientes a ficar atentos para obter a tecnologia mais recente.

Como é feito o controle de versão das atualizações?

As mudanças da versão principal indicam que há uma alteração interruptiva na assinatura da API. Nós prevemos que, geralmente, isso coincidirá com as mudanças da versão principal para a oferta de nuvem dos Serviços Cognitivos correspondente. As mudanças de versões secundárias indicam correções de bug, atualizações de modelo ou novos recursos que não representam uma alteração interruptiva na assinatura de API.

Perguntas técnicas

Como posso diagnosticar possíveis erros em meu ambiente de implantação?

Se você estiver tendo problemas para executar um contêiner dos Serviços Cognitivos do Azure, tente usar o contêiner de diagnóstico da Microsoft. Use esse contêiner para diagnosticar erros comuns em seu ambiente de implantação que podem impedir que os contêineres dos Serviços Cognitivos do Azure funcionem conforme o esperado.

Para obter o contêiner, use o seguinte comando docker pull:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Em seguida, execute o contêiner. Substitua {ENDPOINT_URI} pelo ponto de extremidade e {API_KEY} pela chave do recurso:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

O contêiner testará a conectividade de rede com o ponto de extremidade de cobrança.

Como devo executar os contêineres dos Serviços Cognitivos em dispositivos de IoT?

Independentemente de você não ter uma conexão com a Internet confiável, você deseja economizar em custos de largura de banda, você tem requisitos de baixa latência ou está lidando com dados confidenciais que precisam ser analisados no local, o Azure IoT Edge com contêineres de serviços cognitivos proporciona consistência com a nuvem.

Esses contêineres são compatíveis com o OpenShift?

Nós não testamos contêineres com OpenShift, mas, em geral, deve ser possível executar os contêineres dos Serviços Cognitivos nas plataformas que dão suporte a imagens do Docker. Se você está usando o OpenShift, recomendamos executar os contêineres como root-user.

Como fazer comentários e recomendações de recursos para o produto?

Incentivamos os clientes a expressar suas preocupações publicamente e a reagir a outras pessoas que fizeram o mesmo para problemas parecidos. É possível usar a ferramenta de comentários para comentar produtos e recomendar recursos.

Quais erros e mensagens de status os contêineres dos Serviços Cognitivos exibem?

Veja as mensagens de status e os erros:

Status Descrição
Valid Sua chave de API é válida. Nenhuma ação é necessária.
Invalid Sua chave de API é inválida. Você deve informar uma chave de API válida para executar o contêiner. Localize a sua chave de API e a sua região de serviço no portal do Azure, na seção Chaves e Ponto de extremidade do recurso Serviços Cognitivos.
Mismatch Você informou uma chave de API ou um ponto de extremidade para um tipo diferente de recurso dos Serviços Cognitivos. Localize a sua chave de API e a sua região de serviço no portal do Azure, na seção Chaves e Ponto de extremidade do recurso Serviços Cognitivos.
CouldNotConnect O contêiner não pôde se conectar ao ponto de extremidade de cobrança. Verifique o valor Retry-After e aguarde o término desse período para fazer mais solicitações.
OutOfQuota A chave de API excedeu a cota. Você pode atualizar o seu tipo de preço ou aguardar uma cota adicional ser disponibilizada. Localize o tipo no portal do Azure, na seção Tipo de preço do recurso Serviços Cognitivos.
BillingEndpointBusy O ponto de extremidade de cobrança está ocupado no momento. Verifique o valor Retry-After e aguarde o término desse período para fazer mais solicitações.
ContainerUseUnauthorized A chave de API informada não está autorizada para uso com esse contêiner. Provavelmente, você está usando um contêiner restrito. Verifique se a sua ID de assinatura do Azure foi aprovada enviando uma solicitação online.
Unknown O servidor não pode processar solicitações de cobrança no momento.

Como fazer para obter suporte?

Os canais de suporte ao cliente são iguais aos das APIs com base em nuvem dos Serviços Cognitivos. Todos os contêineres dos Serviços Cognitivos incluem recursos de registro em log que ajudam a nossa empresa e a comunidade a dar suporte aos clientes. Estas são as opções para obter mais suporte:

Como funciona a cobrança?

Os clientes são cobrados com base no consumo, assim como na nuvem dos Serviços Cognitivos. É necessário configurar os contêineres para enviar dados de medição ao Azure e as transações serão cobradas de acordo. Os recursos de serviços hospedados e locais que forem usados serão adicionados a uma só cota com o preço dividido por tipos, que refletem os dois tipos de uso. Para obter mais informações, consulte a página de preços a seguir:

Importante

Os contêineres dos Serviços Cognitivos não estão licenciados para serem executados sem uma conexão ao Azure para medição. Os clientes precisam ativar os contêineres para comunicar informações de cobrança com o serviço de medição em todos os momentos. Os contêineres dos Serviços Cognitivos não enviam dados do cliente para a Microsoft.

Este é um exemplo das informações de medição que um contêiner comunica:

"usageRequestBody": {
  "id": "customer_subscriptionID",
  "apiType": "textanalytics",
  "containerType": "keyphrase",
  "containerVersion": "1.1.00864.0001",
  "containerId": "dep--keyphrase-",
  "meter": {
    "name": "CognitiveServices.TextAnalytics.Container.BatchScoring",
    "quantity": 10.0
  }

Qual é a garantia de suporte atual para contêineres?

Não há garantia para versões prévias. A garantia padrão da Microsoft para software corporativo se aplicará quando os contêineres forem formalmente anunciados como GA (em disponibilidade geral).

O que acontece com os contêineres dos Serviços Cognitivos quando perdemos a conectividade com a Internet?

Os contêineres dos Serviços Cognitivos não estão licenciados para serem executados sem uma conexão ao Azure para medição. Os clientes precisam habilitar os contêineres para sempre se comunicar com o serviço de medição.

Por quanto tempo o contêiner pode operar sem estar conectado ao Azure?

Os contêineres dos Serviços Cognitivos não estão licenciados para serem executados sem uma conexão ao Azure para medição. Os clientes precisam habilitar os contêineres para sempre se comunicar com o serviço de medição.

Qual hardware é necessário para executar esses contêineres?

Os contêineres dos Serviços Cognitivos se baseiam em x64 e podem executar qualquer nó do Linux, VM e dispositivo de borda compatível que dê suporte a contêineres do Linux Docker x64. Todos eles exigem processadores de CPU. É possível encontrar as configurações mínimas e recomendadas para cada oferta de contêiner nestas páginas:

No momento, esses contêineres são compatíveis com o Windows?

Os contêineres dos Serviços Cognitivos são contêineres do Linux, mas, o Windows dá certo nível de suporte aos contêineres do Linux. Para saber mais sobre contêineres do Linux no Windows, confira a documentação do Docker.

Como os contêineres dos Serviços Cognitivos se comparam às ofertas da AWS e do Google?

A Microsoft é o primeiro provedor de nuvem a mover seus modelos de IA pré-treinados em contêineres com uma cobrança simples por transação, como se os clientes estivessem usando um serviço de nuvem. A Microsoft acredita que uma nuvem híbrida oferece mais opções aos clientes.

Quais são as certificações de conformidade dos contêineres?

Os contêineres dos Serviços Cognitivos não têm certificações de conformidade.

Em quais regiões os contêineres dos Serviços Cognitivos estão disponíveis?

É possível executar contêineres em todo lugar, de qualquer região, mas eles precisam de uma chave e retornar ao Azure para fazer a medição. Todas as regiões compatíveis com o serviço de nuvem têm permissão para fazer a chamada de medição dos contêineres.