Usare i contenitori

Completato

Utilizzando i container per distribuire Analisi del testo per la salute, puoi avvicinare il servizio ai tuoi dati per motivi di conformità, sicurezza e altri motivi operativi. Un motivo comune per usare i contenitori con Analisi del testo per l'integrità è consentire ai dati di informazioni sanitarie protette (PHI) di rimanere in locale durante l'analisi dei dati con Analisi del testo per l'integrità. In questo scenario, solo i dati di fatturazione verranno caricati nel cloud. Dopo aver distribuito il contenitore, sarà possibile accedere al servizio usando l'API REST o un SDK.

È possibile trovare l'analisi del testo per le immagini del contenitore analisi del testo per la salute nel registro dei contenitori. Si trova all'interno del azure-cognitive-services/textanalytics/ repository ed è denominato healthcare. Il nome qualificato completo dell'immagine del contenitore è mcr.microsoft.com/azure-cognitive-services/textanalytics/healthcare.

Il contenitore scelto determinerà i linguaggi e il modello di intelligenza artificiale per la salute disponibili per l'uso. È possibile trovare il contenitore corrente usando il tag più recente per eseguire il pull dell'immagine da usare. Prima di distribuire il contenitore, è necessario esaminare le lingue del contenitore disponibili nel contenitore.

È possibile distribuire i contenitori in locale o in un servizio di hosting cloud. Alcune opzioni comuni di distribuzione dei contenitori sono:

  • Docker Desktop

  • App Web per contenitori di Azure

  • Istanza di contenitore di Azure

È consigliabile esaminare le raccomandazioni correnti per i requisiti di memoria e processore del computer host per assicurarsi che vengano soddisfatte le esigenze di prestazioni. I requisiti di memoria e processore possono influire sul numero di documenti per ogni richiesta e sulle transazioni consentite al secondo (TPS).

Impostazioni di configurazione

Nell'ambito della configurazione del contenitore, è necessario configurare le impostazioni obbligatorie e facoltative seguenti per eseguire correttamente il servizio dal contenitore:

  • Chiave API : è necessario fornire una chiave di risorsa di Azure per il servizio linguistico. Quando si esegue il servizio in un contenitore, l'elaborazione avviene in locale nel contenitore, ma l'utilizzo viene fatturato alla sottoscrizione di Azure. Il contenitore invia periodicamente l'utilizzo e deve sempre essere in grado di contattare Azure; in caso contrario, il servizio smetterà di funzionare.

  • Fatturazione : questa impostazione indica l'URI dell'endpoint per la risorsa di lingua in Azure per l'utilizzo della fatturazione. Questa impostazione verrà usata in combinazione con la chiave API per implementare la fatturazione a consumo per l'utilizzo nel contenitore.

  • Eula : questa impostazione consente di accettare la licenza per il contenitore. Ad esempio, è necessario specificare Eula=accept se è stata accettata la licenza.

  • Condizioni RAI : questa impostazione consente di indicare se si accettano le condizioni per l'IA responsabile. Ad esempio, è necessario specificare rai_terms=accept se sono state accettate le condizioni.

Se una di queste quattro impostazioni non è valida o non è specificata, il servizio contenitore non verrà inizializzato correttamente. Ad esempio, il messaggio seguente indica che non è stato specificato rai_terms correttamente.

Mancante l'opzione RAI_TERMS=accept della linea di comando. È necessario fornire questo per continuare.

Oltre alle impostazioni necessarie, sono disponibili le impostazioni di configurazione facoltative che è possibile configurare.

Provisioning dei contenitori

Guardare il video seguente, che illustra il processo di distribuzione del contenitore in App Web di Azure per contenitori.

È anche possibile usare lo script di PowerShell dal video per distribuire un contenitore nella propria sottoscrizione di Azure.

Non viene fornita alcuna sicurezza quando si usa l'API del contenitore. I contenitori vengono in genere eseguiti all'interno di una rete gestita. A seconda dell'host contenitore, è possibile configurare la propria sicurezza per l'API. Per altre informazioni, vedere Proteggere la connettività ACI per un esempio di configurazione della sicurezza personalizzata con Istanze di Azure Container.

Quando si usano i contenitori, si assume la responsabilità di eseguire l'aggiornamento all'immagine del contenitore più recente. Quando si usa il servizio cloud, gli aggiornamenti del servizio verranno eseguiti automaticamente.