FAQ para recipientes de Serviços Cognitivos Azure

Perguntas gerais

O que está disponível?

Os recipientes Azure Cognitive Services permitem que os desenvolvedores utilizem as mesmas APIs inteligentes que estão disponíveis no Azure, mas com os benefícios da contentorização. Alguns contentores estão disponíveis como pré-visualização fechada que pode exigir uma aplicação de acesso. Outros recipientes estão disponíveis publicamente como pré-visualização não gata, ou estão geralmente disponíveis. Pode encontrar uma lista completa de contentores e a sua disponibilidade no suporte do Contentor no artigo dos Serviços Cognitivos Azure . Também pode ver os recipientes em Docker Hub.

Há alguma diferença entre a nuvem dos Serviços Cognitivos e os contentores?

Os contentores dos Serviços Cognitivos são uma alternativa à nuvem dos Serviços Cognitivos. Os contentores oferecem as mesmas capacidades que os serviços de nuvem correspondentes. Os clientes podem implantar os contentores no local ou em Azure. A tecnologia de IA central, os níveis de preços, as chaves API e a assinatura API são os mesmos entre o contentor e os serviços de nuvem correspondentes. Existem funcionalidades e benefícios para escolher recipientes em vez do seu equivalente de serviço na nuvem.

Como devo proceder para acesso e utilizar um recipiente de pré-visualização fechado?

Anteriormente, os contentores de pré-visualização fechados estavam alojados no containerpreview.azurecr.io repositório. A partir de 22 de setembro de 2020, estes contentores estão alojados no Microsoft Container Registry. Descarregá-los não requer que use o docker login comando. Poderá executar um recipiente de pré-visualização fechado se o seu recurso Azure tiver sido criado com o ID de assinatura Azure aprovado. Não poderá executar o contentor se a sua assinatura Azure não tiver sido aprovada após a conclusão do formulário de pedido.

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

Gostaríamos de disponibilizar mais ofertas de Serviços Cognitivos como contentores. Contacte o seu gestor de conta local da Microsoft para obter atualizações sobre novas versões de contentores e outros anúncios de Serviços Cognitivos.

Qual será o acordo de nível de serviço (SLA) para os contentores dos Serviços Cognitivos?

Os contentores dos Serviços Cognitivos não têm SLA.

Os clientes controlam as configurações de recursos dos contentores de Serviços Cognitivos, pelo que a Microsoft não oferecerá um SLA para disponibilidade geral (GA). Os clientes são livres de colocar contentores no local e definir os ambientes de acolhimento.

Importante

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

Estes contentores estão disponíveis em nuvens soberanas?

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

A nuvem soberana é composta pelas nuvens Azure Government, Azure Alemanha e Azure China 21Vianet.

Infelizmente, os contentores dos Serviços Cognitivos não são suportados de forma nativa nas nuvens soberanas. Os contentores podem ser executados nestas nuvens, mas serão retirados da nuvem pública e precisam enviar dados de uso para o ponto final público.

Controlo de versões

Como é que os contentores são atualizados para a versão mais recente?

Os clientes podem escolher quando atualizar os contentores que implantaram. Os contentores serão marcados com etiquetas padrão do Docker , de modo latest a indicar a versão mais recente. Encorajamos os clientes a puxarem as versões mais recentes dos contentores à medida que são lançados. Para obter detalhes sobre como ser notificado quando uma imagem é atualizada, consulte Azure Container Registry webhooks.

Que versões serão suportadas?

A versão atual e última do recipiente será suportada. No entanto, encorajamos os clientes a manterem-se atuais para obterem a mais recente tecnologia.

Como são versadas as atualizações?

As principais alterações na versão indicam que há uma alteração na assinatura da API. Prevemos que isso irá geralmente coincidir com as principais alterações de versão à oferta de nuvem correspondente dos Serviços Cognitivos. Pequenas alterações na versão indicam correções de bugs, atualizações de modelos ou novas funcionalidades que não fazem uma alteração de rutura na assinatura API.

Questões técnicas

Como posso diagnosticar potenciais erros no meu ambiente de implantação?

Se tiver problemas ao executar um contentor dos Serviços Cognitivos, pode tentar utilizar o contentor de diagnóstico da Microsoft. Utilize este contentor para diagnosticar erros comuns no ambiente de implementação que possam impedir que os contentores dos Serviços Cognitivos funcionem conforme esperado.

Para obter o recipiente, utilize o seguinte docker pull comando:

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

Em seguida, executar o recipiente. Substitua-o {ENDPOINT_URI} pelo seu ponto final e substitua-o {API_KEY} pela chave do seu recurso:

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

O recipiente testará a conectividade da rede com o ponto final de faturação.

Como devo executar os contentores dos Serviços Cognitivos em dispositivos IoT?

Quer não tenha uma ligação à Internet fiável, quer economizar no custo da largura de banda, tem requisitos de baixa latência, ou está a lidar com dados sensíveis que precisam de ser analisados no local, o Azure IoT Edge com recipientes de Serviços Cognitivos dá-lhe consistência com a nuvem.

Estes contentores são compatíveis com o OpenShift?

Não testamos contentores com OpenShift, mas geralmente, os contentores dos Serviços Cognitivos devem funcionar em qualquer plataforma que suporte imagens do Docker. Se estiver a utilizar o OpenShift, recomendamos que utilize os recipientes como root-user.

Como devo proceder para fornecer feedback do produto e recomendações de recursos?

Encorajamos os clientes a expressarem publicamente as suas preocupações e a votar em outros que fizeram o mesmo onde as questões potenciais se sobrepõem. Pode utilizar a ferramenta de feedback tanto para o feedback do produto como para as recomendações de recursos.

Que mensagens de estado e erros os contentores dos Serviços Cognitivos regressam?

Aqui estão as mensagens de estado e os erros:

Estado Descrição
Valid A sua chave API é válida. Não é necessária ação.
Invalid A sua chave API é inválida. Deve fornecer uma chave API válida para executar o recipiente. Encontre a sua chave E região de serviço apiífera na portal do Azure, na secção Chaves e Ponto Final para o seu recurso Serviços Cognitivos.
Mismatch Forneceu uma chave API ou ponto final para um tipo diferente de recurso de Serviços Cognitivos. Encontre a sua chave E região de serviço apiífera na portal do Azure, na secção Chaves e Ponto Final para o seu recurso Serviços Cognitivos.
CouldNotConnect O contentor não conseguiu ligar-se ao ponto final de faturação. Verifique o Retry-After valor e aguarde que este período termine antes de fazer mais pedidos.
OutOfQuota A chave API excedeu a quota. Pode atualizar o seu nível de preços ou esperar que a quota adicional fique disponível. Encontre o seu nível na portal do Azure, na secção De Preços do seu recurso Serviço Cognitivo.
BillingEndpointBusy O ponto final da faturação está ocupado. Verifique o Retry-After valor e aguarde que este período termine antes de fazer mais pedidos.
ContainerUseUnauthorized A chave API fornecida não está autorizada a ser utilizada com este recipiente. É provável que utilize um contentor fechado, por isso certifique-se de que o seu ID de assinatura Azure é aprovado através da submissão de um pedido online.
Unknown O servidor não consegue processar pedidos de faturação.

Como devo proceder para obter apoio?

Os canais de apoio ao cliente são os mesmos que para as APIs baseadas na nuvem dos Serviços Cognitivos. Todos os contentores de Serviços Cognitivos incluem funcionalidades de registo que nos ajudarão e os clientes de apoio à comunidade. Aqui estão as opções para mais suporte:

Como funciona a faturação?

Os clientes são cobrados com base no consumo, semelhante à nuvem de Serviços Cognitivos. Os contentores precisam de ser configurados para enviar dados de medição para a Azure, e as transações serão faturadas em conformidade. Os recursos utilizados em todos os serviços alojados e no local irão adicionar à quota única com preços hierárquicos, contando com ambos os usos. Para mais informações, consulte as seguintes páginas de preços:

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 dos clientes para a Microsoft.

Aqui está um exemplo da informação que um recipiente comunica para a medição:

"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 os recipientes?

Não existe garantia para pré-visualizações. A garantia padrão da Microsoft para o software empresarial será aplicada quando os contentores forem anunciados formalmente como disponibilidade geral (GA).

O que acontece aos recipientes dos Serviços Cognitivos quando a conectividade da Internet é perdida?

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 se comuniquem sempre com o serviço de medição.

Quanto tempo o recipiente pode funcionar sem estar ligado ao Azure?

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 se comuniquem sempre com o serviço de medição.

Que hardware é necessário para executar estes contentores?

Os recipientes de Serviços Cognitivos são recipientes de base x64 que podem executar qualquer nó Linux compatível, VM e dispositivo de borda que suporta recipientes x64 Linux Docker. Todos precisam de processadores cpu. Pode encontrar as configurações mínimas e recomendadas para cada oferta de recipientes nestas páginas:

Estes contentores são atualmente suportados em Windows?

Os contentores dos Serviços Cognitivos são contentores Linux, mas há algum suporte para os contentores Linux na Windows. Para obter mais informações sobre os recipientes Linux na Windows, consulte a documentação do Docker.

Como é que os contentores dos Serviços Cognitivos se comparam às ofertas da AWS e do Google?

A Microsoft é o primeiro fornecedor de nuvem a mover os seus modelos de IA pré-treinados em contentores com faturação simples por transação como se os clientes estiverem a usar um serviço de cloud. A Microsoft acredita que uma nuvem híbrida dá mais escolha aos clientes.

Que certificações de conformidade têm os contentores?

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

Em que regiões estão disponíveis contentores dos Serviços Cognitivos?

Os contentores podem ser executados em qualquer lugar de qualquer região, mas precisam de uma chave e precisam de chamar a Azure para medir. Todas as regiões apoiadas para o serviço de nuvem são suportadas para a chamada de medição dos contentores.