Editar

FAQ sobre contentores dos Serviços Cognitivos do Azure

  • FAQ

Perguntas gerais

O que está disponível?

Os contentores dos Serviços Cognitivos do Azure permitem que os programadores 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 uma pré-visualização fechada que pode exigir o acesso de uma aplicação. Outros contentores estão publicamente disponíveis como uma pré-visualização não acionada ou estão geralmente disponíveis. Pode encontrar uma lista completa dos contentores e a respetiva disponibilidade no artigo Suporte de contentores nos Serviços Cognitivos do Azure . Também pode ver os contentores no Docker Hub.

Existe alguma diferença entre a cloud dos Serviços Cognitivos e os contentores?

Os contentores dos Serviços Cognitivos são uma alternativa à cloud dos Serviços Cognitivos. Os contentores oferecem as mesmas capacidades que os serviços cloud correspondentes. Os clientes podem implementar os contentores no local ou no Azure. A tecnologia de IA principal, os escalões de preço, as chaves de API e a assinatura de API são os mesmos entre o contentor e os serviços cloud correspondentes. Existem funcionalidades e benefícios para escolher contentores em vez do equivalente do serviço cloud.

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

Anteriormente, os contentores de pré-visualização fechados eram alojados no containerpreview.azurecr.io repositório. A partir de 22 de setembro de 2020, estes contentores estão alojados no Microsoft Container Registry. Transferi-los não requer que utilize o docker login comando . Poderá executar um contentor de pré-visualização fechado se o recurso do Azure tiver sido criado com o ID de subscrição do Azure aprovado. Não poderá executar o contentor se a sua subscrição do 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 dos Serviços Cognitivos como contentores. Contacte o seu gestor de conta Microsoft local para obter atualizações sobre novas versões de contentores e outros anúncios dos Serviços Cognitivos.

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

Importante

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

Os Serviços Cognitivos fornecem SLAs que podem ser visualizados na nossa página do SLA na ligação fornecida acima.

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

Estes contentores estão disponíveis em clouds Soberanas?

Os contentores dos Serviços Cognitivos podem ser utilizados nas clouds Soberanas. Os contentores podem ser executados e podem ligar-se ao ponto final de faturação nestas clouds, mas as imagens de contentor terão de ser retiradas do registo de contentor da cloud pública.

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 implementaram. Os contentores serão marcados com etiquetas padrão do Docker, como latest para indicar a versão mais recente. Incentivamos os clientes a solicitarem as versões mais recentes dos contentores à medida que são lançados. Para obter detalhes sobre como receber notificações quando uma imagem é atualizada, consulte Azure Container Registry webhooks.

Que versões serão suportadas?

A versão principal atual e a última do contentor será suportada. No entanto, incentivamos os clientes a manterem-se atualizados para obterem a tecnologia mais recente.

Como são disponibilizadas as atualizações?

As alterações de versão principais indicam que existe uma alteração interruptiva na assinatura da API. Prevemos que, geralmente, isto coincida com as principais alterações de versão da oferta cloud dos Serviços Cognitivos correspondente. As pequenas alterações de versão indicam correções de erros, atualizações de modelos ou novas funcionalidades que não fazem uma alteração interruptiva à assinatura da API.

Perguntas técnicas

Como posso diagnosticar potenciais erros no meu ambiente de implementaçã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 contentor, utilize o seguinte docker pull comando:

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

Em seguida, execute o contentor. Substitua pelo {ENDPOINT_URI} ponto final e substitua pela {API_KEY} chave do recurso:

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

O contentor irá testar a conectividade de rede ao ponto final de faturação.

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

Quer não tenha uma ligação fiável à Internet, quer poupar no custo da largura de banda, tem requisitos de baixa latência ou está a lidar com dados confidenciais que têm de ser analisados no local, o Azure IoT Edge com contentores dos Serviços Cognitivos dá-lhe consistência com a cloud.

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

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

Como devo proceder para fornecer comentários sobre produtos e recomendações de funcionalidades?

Encorajamos os clientes a expressar publicamente as suas preocupações e a votar em votos de outros que tenham feito o mesmo quando se sobrepõem potenciais questões. Pode utilizar a ferramenta de comentários para comentários de produtos e recomendações de funcionalidades.

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

Eis as mensagens de estado e os erros:

Estado Descrição
Valid A chave de API é válida. Não é necessária qualquer ação.
Invalid A chave de API é inválida. Tem de fornecer uma chave de API válida para executar o contentor. Localize a chave de API e a região de serviço no portal do Azure, na secção Chaves e Ponto Final do recurso dos Serviços Cognitivos.
Mismatch Forneceu uma chave de API ou um ponto final para um tipo diferente de recurso dos Serviços Cognitivos. Localize a chave de API e a região de serviço no portal do Azure, na secção Chaves e Ponto Final do recurso dos Serviços Cognitivos.
CouldNotConnect O contentor não conseguiu ligar 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 de API excedeu a quota. Pode atualizar o escalão de preço ou aguardar que a quota adicional fique disponível. Localize o escalão na portal do Azure, na secção Escalão de Preço do recurso do Serviço Cognitivo.
BillingEndpointBusy O ponto final de faturação está ocupado atualmente. Verifique o Retry-After valor e aguarde que este período termine antes de fazer mais pedidos.
ContainerUseUnauthorized A chave de API fornecida não está autorizada para utilização com este contentor. É provável que esteja a utilizar um contentor fechado, por isso certifique-se de que o ID de subscrição do Azure é aprovado ao submeter um pedido online.
[ERROR] Failed to download: context deadline exceeded O pedido de transferência do ficheiro de modelo para os nossos servidores excedeu o tempo limite. Certifique-se de que tem uma ligação à Internet forte para transferir todos os ficheiros necessários dentro de uma hora. As transferências de modelos aplicam-se à Tradução de Texto e a alguns contentores dos Serviços de Voz.
Unknown Atualmente, o servidor não consegue processar pedidos de faturação.

Como devo proceder para obter suporte?

Os canais de suporte ao cliente são os mesmos que para as APIs baseadas na cloud dos Serviços Cognitivos. Todos os contentores dos Serviços Cognitivos incluem funcionalidades de registo que nos ajudarão a nós e aos clientes de suporte da comunidade. Eis as opções para obter mais suporte:

Como funciona a faturação?

Os clientes são cobrados com base no consumo, semelhante à cloud dos Serviços Cognitivos. Os contentores têm de ser configurados para enviar dados de medição para o Azure e as transações serão faturadas em conformidade. Os recursos utilizados nos serviços alojados e no local serão adicionados à quota única com preços em camadas, contando com ambas as utilizações. Para obter mais informações, veja as seguintes páginas de preços:

Importante

Os contentores dos Serviços Cognitivos não estão licenciados para serem executados sem estarem ligados ao Azure para medição. Os clientes têm de permitir que os contentores comuniquem sempre informações de faturação com o serviço de medição. Os contentores dos Serviços Cognitivos não enviam dados de clientes para a Microsoft.

Eis um exemplo das informações que um contentor comunica para medição:

{
  "SubscriptionId": "Customer subscription ID",
  "apiType": "textanalytics",
  "id": "billing id",
  "containerType": "keyphrase",
  "containerVersion": "1.1.00864.0001",
  "containerId": "dep--keyphrase-",
  "meter": {
    "name": "CognitiveServices.TextAnalytics.Container.BatchScoring",
    "quantity": 10.0
  },
  "RequestTime": "The time at which the billing record was created"
}

Qual é a garantia de suporte atual para contentores?

A garantia padrão da Microsoft para software empresarial aplica-se a todos os contentores formalmente anunciados como geralmente disponíveis (GA). Não existe garantia para pré-visualizações.

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

Os contentores dos Serviços Cognitivos não estão licenciados para serem executados sem estarem ligados ao Azure para medição. Os clientes têm de permitir que os contentores comuniquem sempre com o serviço de medição.

Durante quanto tempo o contentor pode funcionar sem estar ligado ao Azure?

Os contentores dos Serviços Cognitivos não estão licenciados para serem executados sem estarem ligados ao Azure para medição. Os clientes têm de permitir que os contentores comuniquem sempre com o serviço de medição.

Que hardware é necessário para executar estes contentores?

Os contentores dos Serviços Cognitivos são contentores baseados em x64 que podem executar qualquer nó, VM e dispositivo edge do Linux compatíveis que suporte contentores do Docker do Linux x64. Todos necessitam de processadores de CPU. Pode encontrar as configurações mínimas e recomendadas para cada oferta de contentor nestas páginas:

Estes contentores são atualmente suportados no Windows?

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

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

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

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

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

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

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