Supporto dei contenitori in Servizi cognitivi di AzureContainer support in Azure Cognitive Services

Il supporto dei contenitori in Servizi cognitivi di Azure consente agli sviluppatori di usare le stesse API avanzate disponibili in Azure e al tempo stesso di usufruire della flessibilità offerta dai contenitori Docker per quanto riguarda la posizione di distribuzione e hosting dei servizi.Container support in Azure Cognitive Services allows developers to use the same rich APIs that are available in Azure, and enables flexibility in where to deploy and host the services that come with Docker containers. Il supporto dei contenitori è attualmente disponibile in anteprima per un sottoinsieme di servizi cognitivi di Azure, incluse le parti di:Container support is currently available in preview for a subset of Azure Cognitive Services, including parts of:

La containerizzazione è un approccio alla distribuzione del software in cui un'applicazione o un servizio, incluse le relative dipendenze e configurazione, viene compresso come immagine del contenitore.Containerization is an approach to software distribution in which an application or service, including its dependencies & configuration, is packaged together as a container image. L'immagine del contenitore può essere distribuita in un host contenitore senza alcuna variazione o con modifiche minime.With little or no modification, a container image can be deployed on a container host. I contenitori sono isolati fra loro e dal sistema operativo sottostante, con un footprint inferiore a quello di una macchina virtuale.Containers are isolated from each other and the underlying operating system, with a smaller footprint than a virtual machine. È possibile creare istanze dei contenitori dalle immagini per attività a breve termine. Tali istanze possono essere rimosse quando non sono più necessarie.Containers can be instantiated from container images for short-term tasks, and removed when no longer needed.

Le risorse di servizi cognitivi sono disponibili in Microsoft Azure.Cognitive Services resources are available on Microsoft Azure. Accedere al portale di Azure per creare ed esplorare le risorse di Azure per questi servizi.Sign into the Azure portal to create and explore Azure resources for these services.

Funzionalità e vantaggiFeatures and benefits

  • Controllo sui dati: i clienti possono scegliere la posizione di elaborazione dei dati da parte di Servizi cognitivi.Control over data: Allow customers to choose where these Cognitive Services process their data. Questo aspetto è fondamentale per i clienti che non possono inviare dati al cloud, ma che richiedono l'accesso alla tecnologia offerta da Servizi cognitivi.This is essential for customers that cannot send data to the cloud but need access to Cognitive Services technology. È supportata la coerenza in ambienti ibridi, tra i dati e le funzionalità di gestione, identità e sicurezza.Support consistency in hybrid environments – across data, management, identity, and security.
  • Controllo sugli aggiornamenti dei modelli: ai clienti viene offerta la flessibilità necessaria per il controllo delle versioni e l'aggiornamento dei modelli distribuiti nelle soluzioni.Control over model updates: Provide customers flexibility in versioning and updating of models deployed in their solutions.
  • Architettura portabile: è consentita la creazione di un'architettura di applicazione portabile che può essere distribuita in Azure, nell'ambiente locale e a livello perimetrale.Portable architecture: Enable the creation of a portable application architecture that can be deployed on Azure, on-premises and the edge. I contenitori possono essere distribuiti direttamente nel servizio Azure Kubernetes, in Istanze di Azure Container o in un cluster Kubernetes distribuito in Azure Stack.Containers can be deployed directly to Azure Kubernetes Service, Azure Container Instances, or to a Kubernetes cluster deployed to Azure Stack. Per altre informazioni, vedere Deploy Kubernetes to Azure Stack (Distribuire Kubernetes in Azure Stack).For more information, see Deploy Kubernetes to Azure Stack.
  • Velocità effettiva elevata e bassa latenza: ai clienti vengono offerte opzioni di scalabilità per i requisiti di alta velocità effettiva e bassa latenza consentendo l'esecuzione di Servizi cognitivi fisicamente vicino alla logica e ai dati dell'applicazione.High throughput / low latency: Provide customers the ability to scale for high throughput and low latency requirements by enabling Cognitive Services to run physically close to their application logic and data. I contenitori non raggiungono il limite di transazioni al secondo e possono offrire scalabilità sia orizzontale che verticale per gestire la domanda, se si forniscono le risorse hardware necessarie.Containers do not cap transactions per second (TPS) and can be made to scale both up and out to handle demand if you provide the necessary hardware resources.

Contenitori in Servizi cognitivi di AzureContainers in Azure Cognitive Services

I contenitori di Servizi cognitivi di Azure offrono il set seguente di contenitori Docker, ognuno dei quali contiene un subset di funzionalità dei servizi disponibili in Servizi cognitivi di Azure:Azure Cognitive Services containers provide the following set of Docker containers, each of which contains a subset of functionality from services in Azure Cognitive Services:

ServiceService Piano tariffario supportatoSupported Pricing Tier ContenitoreContainer DescrizioneDescription
Rilevamento anomalieAnomaly detector F0, S0F0, S0 Rilevamento anomalieAnomaly-Detector L'API Rilevamento anomalie permette di monitorare e rilevare le anomalie nei dati di serie temporali con l'apprendimento automatico.The Anomaly Detector API enables you to monitor and detect abnormalities in your time series data with machine learning.
Richiedere l'accessoRequest access
Visione artificialeComputer Vision F0, S1F0, S1 LetturaRead Estre testo stampato dalle immagini di diversi oggetti con superfici e sfondi diversi, ad esempio ricette, poster e biglietti da visita.Extracts printed text from images of various objects with different surfaces and backgrounds, such as receipts, posters, and business cards. Il contenitore di lettura rileva anche il testo scritto a mano nelle immagini e fornisce il supporto per PDF/TIFF/più pagine.The Read container also detects handwritten text in images and provides PDF/TIFF/multi-page support.

Importante: Il contenitore di lettura attualmente funziona solo con l'inglese.Important: The Read container currently works only with English.
Richiedere l'accessoRequest access
Visione artificialeComputer Vision F0, S1F0, S1 Riconoscimento del testoRecognize Text Estre testo stampato dalle immagini di diversi oggetti con superfici e sfondi diversi, ad esempio ricette, poster e biglietti da visita.Extracts printed text from images of various objects with different surfaces and backgrounds, such as receipts, posters, and business cards.

Importante: Il contenitore di riconoscimento del testo attualmente funziona solo con la lingua inglese.Important: The Recognize Text container currently works only with English.
Richiedere l'accessoRequest access
VisoFace F0, S0F0, S0 VisoFace Rileva i visi umani nelle immagini e identifica gli attributi, ad esempio i punti di riferimento del viso (come naso e occhi), il sesso, l'età e altre caratteristiche facciali con previsioni basate su computer.Detects human faces in images, and identifies attributes, including face landmarks (such as noses and eyes), gender, age, and other machine-predicted facial features. Oltre al rilevamento, Viso può verificare se due volti nella stessa immagine o in immagini diverse sono uguali mediante un punteggio di attendibilità oppure può confrontare i visi con un database per verificare se esistono già visi simili o identici.In addition to detection, Face can check if two faces in the same image or different images are the same by using a confidence score, or compare faces against a database to see if a similar-looking or identical face already exists. È anche possibile organizzare i visi simili in gruppi mediante caratteristiche condivise.It can also organize similar faces into groups, using shared visual traits.
Richiedere l'accessoRequest access
Riconoscimento moduliForm recognizer F0, S0F0, S0 Riconoscimento moduliForm Recognizer La comprensione dei moduli applica la tecnologia di machine learning per identificare ed estrarre le coppie chiave-valore e le tabelle dai moduli.Form Understanding applies machine learning technology to identify and extract key-value pairs and tables from forms.
Richiedere l'accessoRequest access
LUISLUIS F0, S0F0, S0 LUIS (immagine)LUIS (image) Carica un modello Language Understanding sottoposto a training o pubblicato, noto anche come app LUIS, in un contenitore Docker e fornisce l'accesso alle stime di query dagli endpoint dell'API del contenitore.Loads a trained or published Language Understanding model, also known as a LUIS app, into a docker container and provides access to the query predictions from the container's API endpoints. È possibile raccogliere i log di query dal contenitore e caricarli nel portale LUIS per migliorare l'accuratezza delle stime dell'app.You can collect query logs from the container and upload these back to the LUIS portal to improve the app's prediction accuracy.
API servizio VoceSpeech Service API F0, S0F0, S0 Riconoscimento vocaleSpeech-to-text Esegue la trascrizione del parlato continuo in tempo reale in testo.Transcribes continuous real-time speech into text.
Richiedere l'accessoRequest access
API servizio VoceSpeech Service API F0, S0F0, S0 Sintesi vocaleText-to-speech Converte il testo scritto in un audio che suona naturale.Converts text to natural-sounding speech.
Richiedere l'accessoRequest access
Analisi del testoText Analytics F0, SF0, S Estrazione frasi chiave (immagine)Key Phrase Extraction (image) Estrae le frasi chiave per identificare i punti principali.Extracts key phrases to identify the main points. Ad esempio, per il testo di input "Il cibo era delizioso e il personale era meraviglioso", l'API restituisce i punti rilevanti del discorso, ovvero "cibo" e "personale meraviglioso".For example, for the input text "The food was delicious and there were wonderful staff", the API returns the main talking points: "food" and "wonderful staff".
Analisi del testoText Analytics F0, SF0, S Rilevamento lingua (immagine)Language Detection (image) Per un massimo di 120 lingue, rileva la lingua in cui è scritto il testo di input e crea un report relativo a un codice lingua singolo per ogni documento inviato nella richiesta.For up to 120 languages, detects which language the input text is written in and report a single language code for every document submitted on the request. Il codice lingua è associato a un punteggio che indica il livello di attendibilità.The language code is paired with a score indicating the strength of the score.
Analisi del testoText Analytics F0, SF0, S Analisi del sentiment (immagine)Sentiment Analysis (image) Analizza testo non elaborato per indicazioni su una valutazione positiva o negativa.Analyzes raw text for clues about positive or negative sentiment. L'API restituisce un punteggio sentiment compreso tra 0 e 1 per ogni documento, dove 1 è il risultato più positivo.This API returns a sentiment score between 0 and 1 for each document, where 1 is the most positive. Viene eseguito un training preliminare dei modelli di analisi usando un ampio corpus di testi e tecnologie per l'elaborazione del linguaggio naturale di Microsoft.The analysis models are pre-trained using an extensive body of text and natural language technologies from Microsoft. Per alcune lingue, l'API può analizzare e assegnare punteggi a qualsiasi testo non elaborato fornito dall'utente, restituendo direttamente i risultati all'applicazione chiamante.For selected languages, the API can analyze and score any raw text that you provide, directly returning results to the calling application.

Inoltre, alcuni contenitori sono supportati in Servizi cognitivi All-in-One che offrono chiavi di risorsa.In addition, some containers are supported in Cognitive Services All-In-One offering resource keys. È possibile creare una sola risorsa all-in-One di servizi cognitivi e usare la stessa chiave di fatturazione tra i servizi supportati per i servizi seguenti:You can create one single Cognitive Services All-In-One resource and use the same billing key across supported services for the following services:

  • Visione artificialeComputer Vision
  • VisoFace
  • LUISLUIS
  • Analisi del testoText Analytics

Disponibilità dei contenitori in Servizi cognitivi di AzureContainer availability in Azure Cognitive Services

I contenitori di Servizi cognitivi di Azure sono disponibili pubblicamente attraverso la sottoscrizione di Azure e le immagini dei contenitori Docker possono essere estratte da Registro contenitori di Microsoft o dall'hub Docker.Azure Cognitive Services containers are publicly available through your Azure subscription, and Docker container images can be pulled from either the Microsoft Container Registry or Docker Hub. È possibile usare il comando docker pull per scaricare un'immagine del contenitore dal registro appropriato.You can use the docker pull command to download a container image from the appropriate registry.

Importante

Attualmente, è necessario completare un processo di iscrizione per accedere ai contenitori seguenti, in cui si compila e si invia un questionario con domande sull'utente, sulla società e sul caso di utilizzo per il quale si desidera implementare i contenitori.Currently, you must complete a sign-up process to access the following containers, in which you fill out and submit a questionnaire with questions about you, your company, and the use case for which you want to implement the containers. Dopo aver concesso l'accesso e le credenziali fornite, è possibile eseguire il pull delle immagini del contenitore da un registro contenitori privato ospitato da Azure Container Registry.Once you're granted access and provided credentials, you can then pull the container images from a private container registry hosted by Azure Container Registry.

Repository e immagini del contenitoreContainer repositories and images

Le tabelle seguenti sono un elenco completo delle immagini del contenitore disponibili offerte da servizi cognitivi di Azure.The tables below are a comprehensive listing of the available container images offered by Azure Cognitive Services.

Pubblico "non gated" (registro contenitori: mcr.microsoft.com)Public "Ungated" (container registry: mcr.microsoft.com)

Il Container Registry Microsoft ospita tutti i contenitori "ungated" disponibili pubblicamente per servizi cognitivi.The Microsoft Container Registry hosts all of the publicly available "ungated" containers for Cognitive Services.

ServiceService ContenitoreContainer Container Registry/repository/nome dell'immagineContainer Registry / Repository / Image Name
LUISLUIS LUISLUIS mcr.microsoft.com/azure-cognitive-services/luis
Analisi del testoText Analytics Estrazione frasi chiaveKey Phrase Extraction mcr.microsoft.com/azure-cognitive-services/keyphrase
Analisi del testoText Analytics Rilevamento linguaLanguage Detection mcr.microsoft.com/azure-cognitive-services/language
Analisi del testoText Analytics Analisi del sentimentSentiment Analysis mcr.microsoft.com/azure-cognitive-services/sentiment

Anteprima pubblica "gestita" (registro contenitori: containerpreview.azurecr.io)Public "Gated" Preview (container registry: containerpreview.azurecr.io)

Il registro di anteprima del contenitore ospita tutti i contenitori "controllati" disponibili pubblicamente per servizi cognitivi.The Container Preview registry hosts all of the publicly available "gated" containers for Cognitive Services. Questi contenitori richiedono una richiesta formale di accesso per poterli utilizzare.These containers require a formal request for access in order to consume them.

ServiceService ContenitoreContainer Container Registry/repository/nome dell'immagineContainer Registry / Repository / Image Name
Rilevamento anomalieAnomaly detector Rilevamento anomalieAnomaly Detector containerpreview.azurecr.io/microsoft/cognitive-services-anomaly-detector
Visione artificialeComputer Vision Riconoscimento del testoRecognize Text containerpreview.azurecr.io/microsoft/cognitive-services-recognize-text
Visione artificialeComputer Vision LeggiRead containerpreview.azurecr.io/microsoft/cognitive-services-read
VisoFace VisoFace containerpreview.azurecr.io/microsoft/cognitive-services-face
Riconoscimento moduliForm recognizer Riconoscimento moduloForm Recognizer containerpreview.azurecr.io/microsoft/cognitive-services-form-recognizer
API servizio VoceSpeech Service API Riconoscimento vocaleSpeech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text
API servizio VoceSpeech Service API Sintesi vocaleText-to-speech containerpreview.azurecr.io/microsoft/cognitive-services-text-to-speech

PrerequisitiPrerequisites

Per usare i contenitori di Servizi cognitivi di Azure, è necessario soddisfare i prerequisiti seguenti:You must satisfy the following prerequisites before using Azure Cognitive Services containers:

Motore Docker: il motore Docker deve essere installato in locale.Docker Engine: You must have Docker Engine installed locally. Docker offre pacchetti per la configurazione dell'ambiente in macOS, Linux e Windows.Docker provides packages that configure the Docker environment on macOS, Linux, and Windows. In Windows Docker deve essere configurato per supportare i contenitori Linux.On Windows, Docker must be configured to support Linux containers. I contenitori Docker possono anche essere distribuiti direttamente nel servizio Azure Kubernetes o in Istanze di Azure Container.Docker containers can also be deployed directly to Azure Kubernetes Service or Azure Container Instances.

Docker deve essere configurato per consentire ai contenitori di connettersi ai dati di fatturazione e inviarli ad Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

Familiarità con Registro Container Microsoft e Docker: è opportuno avere una conoscenza di base dei concetti relativi a Registro Container Microsoft e Docker, tra cui registri, repository, contenitori e immagini dei contenitori, nonché dei comandi docker di base.Familiarity with Microsoft Container Registry and Docker: You should have a basic understanding of both Microsoft Container Registry and Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.

Per una panoramica dei concetti fondamentali relativi a Docker e ai contenitori, vedere Docker overview (Panoramica di Docker).For a primer on Docker and container basics, see the Docker overview.

Singoli contenitori possono prevedere anche requisiti specifici, tra cui quelli relativi a server e allocazione di memoria.Individual containers can have their own requirements, as well, including server and memory allocation requirements.

Sicurezza del contenitore dei servizi cognitivi di AzureAzure Cognitive Services container security

La protezione deve essere un obiettivo principale quando si sviluppano applicazioni.Security should be a primary focus whenever you're developing applications. L'importanza della sicurezza è una metrica per il successo.The importance of security is a metric for success. Quando si progetta una soluzione software che include contenitori di servizi cognitivi, è fondamentale comprendere le limitazioni e le funzionalità disponibili.When you're architecting a software solution that includes Cognitive Services containers, it's vital to understand the limitations and capabilities available to you. Per altre informazioni, vedere sicurezza di Azure.For more information, see Azure Security.

Importante

Per impostazione predefinita, non esiste alcuna sicurezza sull'API del contenitore di servizi cognitivi.By default there is no security on the Cognitive Services container API. Il motivo è che la maggior parte delle volte il contenitore verrà eseguito come parte di un pod protetto dall'esterno da un Bridge di rete.The reason for this is that most often the container will run as part of a pod which is protected from the outside by a network bridge. Tuttavia, è possibile abilitare l'autenticazione che funziona in modo identico all'autenticazione usata quando si accede ai Servizi cognitivi basati sul cloud.However, it is possible to enable authentication which works identically to the authentication used when accessing the cloud-based Cognitive Services.

Il diagramma seguente illustra l'approccio predefinito e non sicuro :The diagram below illustrates the default and insecure approach:

Sicurezza del contenitore

Come approccio alternativo e sicuro , i consumer di contenitori di servizi cognitivi possono aumentare un contenitore con un componente front-end, mantenendo privato l'endpoint contenitore.As an alternative and secure approach, consumers of Cognitive Services containers could augment a container with a front-facing component, keeping the container endpoint private. Si prenda in considerazione uno scenario in cui si usa Istio come gateway di ingresso.Let's consider a scenario where we use Istio as an ingress gateway. Istio supporta HTTPS/SSL e l'autenticazione del certificato client.Istio supports HTTPS/SSL and client-certificate authentication. In questo scenario, il front-end Istio espone l'accesso al contenitore, presentando il certificato client inserito nell'elenco elementi consentiti in anticipo con Istio.In this scenario, the Istio frontend exposes the container access, presenting the client certificate that is whitelisted beforehand with Istio.

Nginx è un'altra scelta comune nella stessa categoria.Nginx is another popular choice in the same category. Sia Istio che Nginx fungono da mesh del servizio e offrono funzionalità aggiuntive, tra cui bilanciamento del carico, routing e controllo delle tariffe.Both Istio and Nginx act as a service mesh and offer additional features including things like load-balancing, routing, and rate-control.

Rete del contenitoreContainer networking

I contenitori di servizi cognitivi sono necessari per inviare le informazioni di misurazione per scopi di fatturazione.The Cognitive Services containers are required to submit metering information for billing purposes. L'unica eccezione è che i contenitori non in linea seguono una metodologia di fatturazione diversa.The only exception, is Offline containers as they follow a different billing methodology. Se non è possibile consentire l'elenco di diversi canali di rete su cui si basano i contenitori di servizi cognitivi, il contenitore non funzionerà.Failure to allow list various network channels that the Cognitive Services containers rely on will prevent the container from working.

Consenti elenco di domini e porte di servizi cognitiviAllow list Cognitive Services domains and ports

L'host deve consentire la porta elenco 443 e i domini seguenti:The host should allow list port 443 and the following domains:

  • *.cognitive.microsoft.com
  • *.cognitiveservices.azure.com

Disabilitare l'ispezione approfondita dei pacchettiDisable deep packet inspection

Ispezione approfondita dei pacchetti (DPI) è un tipo di elaborazione dei dati che esamina in dettaglio i dati inviati su una rete di computer e in genere interviene, bloccando, reindirizzando o registrando di conseguenza.Deep packet inspection (DPI) is a type of data processing that inspects in detail the data being sent over a computer network, and usually takes action by blocking, re-routing, or logging it accordingly.

Disabilitare DPI nei canali protetti creati dai contenitori di servizi cognitivi nei server Microsoft.Disable DPI on the secure channels that the Cognitive Services containers create to Microsoft servers. In caso contrario, il contenitore non funzionerà correttamente.Failure to do so will prevent the container from functioning correctly.

Post di BLOGBlog posts

Esempi per gli sviluppatoriDeveloper samples

Gli esempi per gli sviluppatori sono disponibili nel repository GitHub.Developer samples are available at our GitHub repository.

Visualizza il webinarView webinar

Partecipare al webinar per saperne di più sugli argomenti seguenti:Join the webinar to learn about:

  • Come distribuire Servizi cognitivi in qualsiasi computer con DockerHow to deploy Cognitive Services to any machine using Docker
  • Come distribuire Servizi cognitivi nel servizio Azure ContainerHow to deploy Cognitive Services to AKS

Passaggi successiviNext steps

Informazioni sulle ricette del contenitore che è possibile usare con i servizi cognitivi.Learn about container recipes you can use with the Cognitive Services.

Installare ed esplorare le funzionalità fornite dai contenitori in Servizi cognitivi di Azure:Install and explore the functionality provided by containers in Azure Cognitive Services: