Avvio rapido: Creare una risorsa multiservizio per Servizi per intelligenza artificiale Azure

  • Articolo

Informazioni su come creare e gestire una risorsa multiservizio per i servizi di intelligenza artificiale di Azure. Una risorsa multiservizio consente di accedere a più servizi di intelligenza artificiale di Azure con una singola chiave ed endpoint. Consolida anche la fatturazione dei servizi usati.

È possibile accedere ai servizi di intelligenza artificiale di Azure tramite due risorse diverse: una risorsa multiservizio o una singola risorsa a servizio singolo.

  • Risorsa multiservizio:
    • Accedere a più servizi di intelligenza artificiale di Azure con una singola chiave ed endpoint.
    • Consente di consolidare la fatturazione dei servizi in uso.
  • Risorsa a servizio singolo:
    • Accedere a un singolo servizio di intelligenza artificiale di Azure con una chiave e un endpoint univoci per ogni servizio creato.
    • La maggior parte dei servizi di intelligenza artificiale di Azure offre un livello gratuito per provarlo.

I servizi di intelligenza artificiale di Azure sono risorse di Azure create nella sottoscrizione di Azure. Dopo aver creato una risorsa, è possibile usare le chiavi e gli endpoint generati per autenticare le applicazioni.

Servizi supportati con una risorsa multiservizio

La risorsa multiservizio consente l'accesso ai servizi di intelligenza artificiale di Azure seguenti con una singola chiave ed endpoint. Usare questi collegamenti per trovare articoli di avvio rapido, esempi e altro ancora per iniziare a usare la risorsa.

Servizio Descrizione
Icona di Content ModeratorContent Moderator (ritirato) Rileva contenuti potenzialmente offensivi o indesiderati.
icona Visione personalizzataVisione personalizzata Personalizzare il riconoscimento delle immagini per l'azienda.
Icona di Intelligence per i documentiIntelligence sui documenti Trasformare i documenti in soluzioni intelligenti basate sui dati.
Icona visoViso Rileva e identifica persone ed emozioni nelle immagini.
Icona linguaLingua Creare app con funzionalità di comprensione del linguaggio naturale leader del settore.
Icona voceComandi vocali Riconoscimento vocale, sintesi vocale, traduzione e riconoscimento del parlante.
icona TraduttoreTranslator Usare la tecnologia di traduzione basata su intelligenza artificiale per tradurre più di 100 lingue e dialetti in uso, a rischio e in pericolo.
Icona VisioneVisione Analizzare il contenuto in immagini e video.

Prerequisiti

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.

Creare una nuova risorsa multiservizio

La risorsa multi-servizi si trova in Servizi di Azure AI>Account multi-servizi di Servizi di Azure AI nel portale. Per creare una risorsa multi-servizi, seguire queste istruzioni:

  1. Selezionare questo collegamento per creare una risorsa multi-servizi: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

  2. Nella pagina Crea specificare le informazioni seguenti:

    Dettagli di progetto Descrizione
    Abbonamento Selezionare una delle sottoscrizioni di Azure disponibili.
    Gruppo di risorse Gruppo di risorse Azure che conterrà la risorsa di Servizi di Azure AI. È possibile creare un nuovo gruppo o aggiungerla a un gruppo già esistente.
    Area Posizione dell'istanza di Servizi di Azure AI. Posizioni diverse possono introdurre latenza, ma non hanno alcun impatto sulla disponibilità di runtime della risorsa.
    Nome Nome descrittivo della risorsa di Servizi di Azure AI. Ad esempio, MyCognitiveServicesResource.
    Piano tariffario Il costo dell'account di Servizi di Azure AI dipende dalle opzioni scelte e dall'utilizzo. Per altre informazioni, vedere i dettagli sui prezzi delle API.

    Schermata di creazione di risorse multiservizio

  3. Configurare altre impostazioni per la risorsa in base alle esigenze, leggere e accettare le condizioni (se applicabile) e quindi selezionare Rivedi e crea.

Suggerimento

Se la sottoscrizione non consente di creare una risorsa di Servizi di Azure AI, può essere necessario abilitare il privilegio del provider di risorse di Azure usando il portale di Azure, un comando PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si ha la proprietà della sottoscrizione, rivolgersi al proprietario della sottoscrizione o a un utente con un ruolo di amministratore per completare la registrazione o chiedere che al proprio account vengano concessi privilegi /register/action.

Ottenere le chiavi per la risorsa

  1. Dopo aver distribuito correttamente la risorsa, selezionare Passaggi>successivi Passare alla risorsa.

    Schermata Ottieni chiavi di risorsa

  2. Nel riquadro di avvio rapido visualizzato è possibile accedere all'endpoint della risorsa e gestire le chiavi.

Configurare una variabile di ambiente per l'autenticazione

L'applicazione deve essere autenticata per accedere alle risorse dei servizi di intelligenza artificiale di Azure. Per impostare la variabile di ambiente per la chiave di risorsa, aprire una finestra della console e seguire le istruzioni per il sistema operativo e l'ambiente di sviluppo. Per impostare la COGNITIVE_SERVICE_KEY variabile di ambiente, sostituire your-key con una delle chiavi per la risorsa.

Per l'ambiente di produzione, usare un modo sicuro per archiviare e accedere alle credenziali, ad esempio un insieme di credenziali dei segreti protetto da password. Per il test, la scrittura in una variabile di ambiente è una procedura standard, ma tenere presente che le variabili di ambiente vengono archiviate in testo non crittografato nel computer locale.

Suggerimento

Non includere la chiave direttamente nel codice e non pubblicarla pubblicamente. Per altre opzioni di autenticazione come Azure Key Vault, vedere l'articolo sicurezza dei servizi di intelligenza artificiale di Azure.

PowerShell include una soluzione estendibile, Secret Management, per l'archiviazione di stringhe sicure in piattaforme come l'archivio segreto o Azure KeyVault.

Per configurare un archivio segreto per ospitare stringhe sicure, vedere l'articolo Introduzione all'uso dell'archivio segreti. Usare quindi gli esempi seguenti per archiviare le chiavi API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Per gli ambienti di test, è possibile usare la sintassi di $Env: PowerShell per impostare una variabile di ambiente solo per la sessione corrente o il setx comando per mantenere la variabile tra le sessioni. Tenere presente che questi valori vengono archiviati in testo non crittografato nelle chiavi del Registro di sistema di Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Dopo aver aggiunto la variabile di ambiente usando setx, potrebbe essere necessario riavviare tutte le console in esecuzione o altri programmi che dovranno leggere la variabile di ambiente. Se ad esempio si usa Visual Studio come editor, riavviare Visual Studio prima di eseguire l'esempio.

Per impostare la variabile di ambiente per l'area della risorsa Voce, seguire la stessa procedura. Impostare COGNITIVE_SERVICE_REGION sull'area della risorsa. Ad esempio: westus.

Pulire le risorse

Se si vuole pulire e rimuovere una sottoscrizione dei servizi di intelligenza artificiale di Azure, è possibile eliminare la risorsa o il gruppo di risorse. Eliminando il gruppo di risorse vengono eliminate anche tutte le altre risorse al suo interno.

  1. Nel portale di Azure espandere il menu a sinistra per aprire il menu dei servizi e scegliere Gruppi di risorse per visualizzare l'elenco dei gruppi di risorse.
  2. Individuare il gruppo di risorse contenente la risorsa da eliminare.
  3. Se si vuole eliminare l'intero gruppo di risorse, selezionare il nome del gruppo di risorse. Nella pagina successiva selezionare Elimina gruppo di risorse e confermare.
  4. Se si vuole eliminare solo la risorsa dei servizi di intelligenza artificiale di Azure, selezionare il gruppo di risorse per visualizzare tutte le risorse al suo interno. Nella pagina successiva selezionare la risorsa da eliminare, selezionare il menu con i puntini di sospensione per tale riga e selezionare Elimina.

Usare questa guida introduttiva per creare una risorsa dei servizi di intelligenza artificiale di Azure usando i comandi interfaccia della riga di comando di Azure (CLI). Dopo aver creato la risorsa, usare le chiavi e l'endpoint generati per autenticare le applicazioni.

I servizi di intelligenza artificiale di Azure sono servizi di intelligenza artificiale basati sul cloud che consentono agli sviluppatori di creare intelligenza cognitiva in applicazioni senza avere competenze o conoscenze dirette di intelligenza artificiale o data science. Sono disponibili tramite LE API REST e gli SDK della libreria client nei linguaggi di sviluppo più diffusi. I servizi di intelligenza artificiale di Azure consentono agli sviluppatori di aggiungere facilmente funzionalità cognitive alle applicazioni con soluzioni cognitive che possono vedere, ascoltare, parlare e analizzare.

Prerequisiti

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • L'interfaccia della riga di comando di Azure
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.
  • Se si prevede di usare l'analisi spaziale in Visione artificiale di Azure o Analisi del testo per l'integrità nel linguaggio di intelligenza artificiale di Azure, è necessario creare le prime risorse di Visione artificiale o Lingua dal portale di Azure in modo da poter esaminare e riconoscere i termini e le condizioni. È possibile farlo qui: Azure AI Language, Azure AI Vision.You can do here: Azure AI Language, Azure AI Vision. Successivamente, è possibile creare risorse successive usando qualsiasi strumento di distribuzione (ad esempio, SDK, interfaccia della riga di comando o modello di Resource Manager) nella stessa sottoscrizione di Azure.

Installare l'interfaccia della riga di comando di Azure ed eseguire l'accesso

Installare l'interfaccia della riga di comando di Azure. Per accedere all'installazione locale dell'interfaccia della riga di comando, eseguire il comando az login :

az login

È anche possibile usare il pulsante verde Prova per eseguire questi comandi nel browser.

Creare un nuovo gruppo di risorse di Servizi di intelligenza artificiale di Azure

Prima di creare una risorsa dei servizi di intelligenza artificiale di Azure, è necessario avere un gruppo di risorse di Azure per contenere la risorsa. Quando si crea una nuova risorsa, è possibile creare un nuovo gruppo di risorse o usarne uno esistente. Questo articolo illustra come creare un nuovo gruppo di risorse.

Scegliere il percorso del gruppo di risorse

Per creare una risorsa, è necessario uno dei percorsi di Azure disponibili per la sottoscrizione. È possibile recuperare un elenco di posizioni disponibili con il comando az account list-locations . La maggior parte dei servizi di intelligenza artificiale di Azure è accessibile da diverse posizioni. Scegliere quello più vicino all'utente o visualizzare le posizioni disponibili per il servizio.

Importante

  • Ricordare la posizione di Azure, perché sarà necessaria quando si chiamano le risorse dei servizi di intelligenza artificiale di Azure.
  • La disponibilità di alcuni servizi di intelligenza artificiale di Azure può variare in base all'area. Per altre informazioni, vedere Prodotti di Azure in base all'area.
az account list-locations --query "[].{Region:name}" --out table

Dopo aver creato la località di Azure, creare un nuovo gruppo di risorse nell'interfaccia della riga di comando di Azure usando il comando az group create . Nell'esempio seguente sostituire la località westus2 di Azure con una delle località di Azure disponibili per la sottoscrizione.

az group create --name ai-services-resource-group --location westus2

Creare una risorsa Servizi di Azure Ai

Scegliere un servizio e un piano tariffario

Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio che si vuole usare, insieme al piano tariffario (o SKU) desiderato. Questa e altre informazioni verranno usate come parametri quando si crea la risorsa.

Le tabelle seguenti forniscono informazioni sui prodotti e sui prezzi per i servizi di intelligenza artificiale di Azure.

Multi-servizio

Servizio Tipologia
Più servizi. Per ulteriori informazioni, vedere la pagina dei prezzi. CognitiveServices

Visione

Servizio Tipologia
Visione ComputerVision
Visione personalizzata - Previsione CustomVision.Prediction
Visione personalizzata - Training CustomVision.Training
Viso Face
Document Intelligence FormRecognizer

Voce

Servizio Tipologia
Voce SpeechServices

Lingua

Servizio Tipologia
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Lingua TextAnalytics
Traduzione testuale TextTranslation

Decision

Servizio Tipologia
Rilevamento anomalie AnomalyDetector
Content Moderator ContentModerator
Personalizza esperienze Personalizer

OpenAI di Azure

Servizio Tipologia
OpenAI di Azure OpenAI

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) sono basati sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Numero massimo di transazioni consentite al secondo (TPS).
  • Funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo numero, verrà addebitato un costo aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Nota

Molti dei servizi di intelligenza artificiale di Azure hanno un livello gratuito che è possibile usare per provare il servizio. Per usare il livello gratuito, usare F0 come piano tariffario per la risorsa.

È possibile trovare un elenco dei servizi di intelligenza artificiale di Azure disponibili "tipi" con il comando az cognitiveservices account list-type :

az cognitiveservices account list-kinds

Aggiungere una nuova risorsa al gruppo di risorse

Per creare e sottoscrivere una nuova risorsa dei servizi di intelligenza artificiale di Azure, usare il comando az cognitiveservices account create . Questo comando aggiunge una nuova risorsa fatturabile al gruppo di risorse creato in precedenza. Quando si crea la nuova risorsa, è necessario conoscere il "tipo" di servizio che si vuole usare, insieme al relativo piano tariffario (o SKU) e a una località di Azure:

È possibile creare una risorsa multiservizio S0 Standard denominata multi-service-resource con il comando seguente.

az cognitiveservices account create --name multi-service-resource --resource-group ai-services-resource-group  --kind CognitiveServices --sku F0 --location westus2 --yes

Suggerimento

Se la sottoscrizione non consente di creare una risorsa di Servizi di Azure AI, può essere necessario abilitare il privilegio del provider di risorse di Azure usando il portale di Azure, un comando PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si ha la proprietà della sottoscrizione, rivolgersi al proprietario della sottoscrizione o a un utente con un ruolo di amministratore per completare la registrazione o chiedere che al proprio account vengano concessi privilegi /register/action.

Ottenere le chiavi per la risorsa

Per accedere all'installazione locale di Command-Line Interface(CLI), usare il comando az login .

az login

Usare il comando az cognitiveservices account keys list per ottenere le chiavi per la risorsa.

az cognitiveservices account keys list  --name multi-service-resource --resource-group ai-services-resource-group

Configurare una variabile di ambiente per l'autenticazione

L'applicazione deve essere autenticata per accedere alle risorse dei servizi di intelligenza artificiale di Azure. Per impostare la variabile di ambiente per la chiave di risorsa, aprire una finestra della console e seguire le istruzioni per il sistema operativo e l'ambiente di sviluppo. Per impostare la COGNITIVE_SERVICE_KEY variabile di ambiente, sostituire your-key con una delle chiavi per la risorsa.

Per l'ambiente di produzione, usare un modo sicuro per archiviare e accedere alle credenziali, ad esempio un insieme di credenziali dei segreti protetto da password. Per il test, la scrittura in una variabile di ambiente è una procedura standard, ma tenere presente che le variabili di ambiente vengono archiviate in testo non crittografato nel computer locale.

Suggerimento

Non includere la chiave direttamente nel codice e non pubblicarla pubblicamente. Per altre opzioni di autenticazione come Azure Key Vault, vedere l'articolo sicurezza dei servizi di intelligenza artificiale di Azure.

PowerShell include una soluzione estendibile, Secret Management, per l'archiviazione di stringhe sicure in piattaforme come l'archivio segreto o Azure KeyVault.

Per configurare un archivio segreto per ospitare stringhe sicure, vedere l'articolo Introduzione all'uso dell'archivio segreti. Usare quindi gli esempi seguenti per archiviare le chiavi API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Per gli ambienti di test, è possibile usare la sintassi di $Env: PowerShell per impostare una variabile di ambiente solo per la sessione corrente o il setx comando per mantenere la variabile tra le sessioni. Tenere presente che questi valori vengono archiviati in testo non crittografato nelle chiavi del Registro di sistema di Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Dopo aver aggiunto la variabile di ambiente usando setx, potrebbe essere necessario riavviare tutte le console in esecuzione o altri programmi che dovranno leggere la variabile di ambiente. Se ad esempio si usa Visual Studio come editor, riavviare Visual Studio prima di eseguire l'esempio.

Per impostare la variabile di ambiente per l'area della risorsa Voce, seguire la stessa procedura. Impostare COGNITIVE_SERVICE_REGION sull'area della risorsa. Ad esempio: westus.

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) si basano sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Il numero massimo di transazioni consentite al secondo.
  • Le funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo importo, si verificherà un addebito aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Ottenere l'utilizzo corrente della quota per la risorsa

Usare il comando az cognitiveservices account list-usage per ottenere l'utilizzo per la risorsa.

az cognitiveservices account list-usage --name multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Pulire le risorse

Se si vuole pulire e rimuovere una risorsa dei servizi di intelligenza artificiale di Azure, è possibile eliminarla o il gruppo di risorse. Eliminando il gruppo di risorse vengono eliminate anche tutte le altre risorse al suo interno.

Per rimuovere il gruppo di risorse e le risorse associate, usare il comando az group delete.

az group delete --name ai-services-resource-group

Usare questa guida introduttiva per creare una risorsa dei servizi di intelligenza artificiale di Azure usando i comandi di Azure PowerShell . Dopo aver creato la risorsa, usare le chiavi e l'endpoint generati per autenticare le applicazioni.

I servizi di intelligenza artificiale di Azure sono servizi di intelligenza artificiale basati sul cloud che consentono agli sviluppatori di creare intelligenza cognitiva in applicazioni senza avere competenze o conoscenze dirette di intelligenza artificiale o data science. Sono disponibili tramite LE API REST e gli SDK della libreria client nei linguaggi di sviluppo più diffusi. I servizi di intelligenza artificiale di Azure consentono agli sviluppatori di aggiungere facilmente funzionalità cognitive alle applicazioni con soluzioni cognitive che possono vedere, ascoltare, parlare e analizzare.

Prerequisiti

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • Azure PowerShell
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.
  • Se si prevede di usare l'analisi spaziale in Visione artificiale di Azure o Analisi del testo per l'integrità nel linguaggio di intelligenza artificiale di Azure, è necessario creare le prime risorse di Visione artificiale o Lingua dal portale di Azure in modo da poter esaminare e riconoscere i termini e le condizioni. È possibile farlo qui: Azure AI Language, Azure AI Vision.You can do here: Azure AI Language, Azure AI Vision. Successivamente, è possibile creare risorse successive usando qualsiasi strumento di distribuzione (ad esempio, SDK, interfaccia della riga di comando o modello di Resource Manager) nella stessa sottoscrizione di Azure.

Installare Azure PowerShell ed eseguire l'accesso

Installare Azure PowerShell. Per accedere, eseguire il comando Connessione-AzAccount:

Connect-AzAccount

È anche possibile usare il pulsante verde Prova per eseguire questi comandi nel browser.

Creare un nuovo gruppo di risorse di Servizi di intelligenza artificiale di Azure

Prima di creare una risorsa dei servizi di intelligenza artificiale di Azure, è necessario avere un gruppo di risorse di Azure per contenere la risorsa. Quando si crea una nuova risorsa, è possibile creare un nuovo gruppo di risorse o usarne uno esistente. Questo articolo illustra come creare un nuovo gruppo di risorse.

Scegliere il percorso del gruppo di risorse

Per creare una risorsa, è necessario uno dei percorsi di Azure disponibili per la sottoscrizione. È possibile recuperare un elenco di posizioni disponibili con il comando Get-AzLocation . La maggior parte dei servizi di intelligenza artificiale di Azure è accessibile da diverse posizioni. Scegliere quello più vicino all'utente o visualizzare le posizioni disponibili per il servizio.

Importante

  • Ricordare la posizione di Azure, perché sarà necessaria quando si chiamano le risorse dei servizi di intelligenza artificiale di Azure.
  • La disponibilità di alcuni servizi di intelligenza artificiale di Azure può variare in base all'area. Per altre informazioni, vedere Prodotti di Azure in base all'area.
Get-AzLocation | Select-Object -Property Location, DisplayName

Dopo aver creato la posizione di Azure, creare un nuovo gruppo di risorse in Azure PowerShell usando il comando New-AzResourceGroup . Nell'esempio seguente sostituire la località westus2 di Azure con una delle località di Azure disponibili per la sottoscrizione.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Creare una risorsa Servizi di Azure Ai

Scegliere un servizio e un piano tariffario

Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio che si vuole usare, insieme al piano tariffario (o SKU) desiderato. Questa e altre informazioni verranno usate come parametri quando si crea la risorsa.

Le tabelle seguenti forniscono informazioni sui prodotti e sui prezzi per i servizi di intelligenza artificiale di Azure.

Multi-servizio

Servizio Tipologia
Più servizi. Per ulteriori informazioni, vedere la pagina dei prezzi. CognitiveServices

Visione

Servizio Tipologia
Visione ComputerVision
Visione personalizzata - Previsione CustomVision.Prediction
Visione personalizzata - Training CustomVision.Training
Viso Face
Document Intelligence FormRecognizer

Voce

Servizio Tipologia
Voce SpeechServices

Lingua

Servizio Tipologia
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Lingua TextAnalytics
Traduzione testuale TextTranslation

Decision

Servizio Tipologia
Rilevamento anomalie AnomalyDetector
Content Moderator ContentModerator
Personalizza esperienze Personalizer

OpenAI di Azure

Servizio Tipologia
OpenAI di Azure OpenAI

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) sono basati sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Numero massimo di transazioni consentite al secondo (TPS).
  • Funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo numero, verrà addebitato un costo aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Nota

Molti dei servizi di intelligenza artificiale di Azure hanno un livello gratuito che è possibile usare per provare il servizio. Per usare il livello gratuito, usare F0 come piano tariffario per la risorsa.

È possibile trovare un elenco dei servizi di intelligenza artificiale di Azure disponibili "tipi" con il comando Get-AzCognitiveServicesAccountType :

Get-AzCognitiveServicesAccountType

Aggiungere una nuova risorsa al gruppo di risorse

Per creare e sottoscrivere una nuova risorsa dei servizi di intelligenza artificiale di Azure, usare il comando New-AzCognitiveServicesAccount . Questo comando aggiunge una nuova risorsa fatturabile al gruppo di risorse creato in precedenza. Quando si crea la nuova risorsa, è necessario conoscere il "tipo" di servizio che si vuole usare, insieme al relativo piano tariffario (o SKU) e a una località di Azure:

È possibile creare una risorsa multiservizio S0 Standard denominata multi-service-resource con il comando seguente.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name multi-service-resource -Type CognitiveServices -SkuName F0 -Location westus2

Suggerimento

Se la sottoscrizione non consente di creare una risorsa dei servizi di intelligenza artificiale di Azure, potrebbe essere necessario abilitare il privilegio del provider di risorse di Azure usando il portale di Azure, un comando di Azure PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si ha la proprietà della sottoscrizione, rivolgersi al proprietario della sottoscrizione o a un utente con un ruolo di amministratore per completare la registrazione o chiedere che al proprio account vengano concessi privilegi /register/action.

Ottenere le chiavi per la risorsa

Usare il comando Get-AzCognitiveServicesAccountKey per ottenere le chiavi per la risorsa.

Get-AzCognitiveServicesAccountKey -Name multi-service-resource -ResourceGroupName ai-services-resource-group

Configurare una variabile di ambiente per l'autenticazione

L'applicazione deve essere autenticata per accedere alle risorse dei servizi di intelligenza artificiale di Azure. Per impostare la variabile di ambiente per la chiave di risorsa, aprire una finestra della console e seguire le istruzioni per il sistema operativo e l'ambiente di sviluppo. Per impostare la COGNITIVE_SERVICE_KEY variabile di ambiente, sostituire your-key con una delle chiavi per la risorsa.

Per l'ambiente di produzione, usare un modo sicuro per archiviare e accedere alle credenziali, ad esempio un insieme di credenziali dei segreti protetto da password. Per il test, la scrittura in una variabile di ambiente è una procedura standard, ma tenere presente che le variabili di ambiente vengono archiviate in testo non crittografato nel computer locale.

Suggerimento

Non includere la chiave direttamente nel codice e non pubblicarla pubblicamente. Per altre opzioni di autenticazione come Azure Key Vault, vedere l'articolo sicurezza dei servizi di intelligenza artificiale di Azure.

PowerShell include una soluzione estendibile, Secret Management, per l'archiviazione di stringhe sicure in piattaforme come l'archivio segreto o Azure KeyVault.

Per configurare un archivio segreto per ospitare stringhe sicure, vedere l'articolo Introduzione all'uso dell'archivio segreti. Usare quindi gli esempi seguenti per archiviare le chiavi API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Per gli ambienti di test, è possibile usare la sintassi di $Env: PowerShell per impostare una variabile di ambiente solo per la sessione corrente o il setx comando per mantenere la variabile tra le sessioni. Tenere presente che questi valori vengono archiviati in testo non crittografato nelle chiavi del Registro di sistema di Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Dopo aver aggiunto la variabile di ambiente usando setx, potrebbe essere necessario riavviare tutte le console in esecuzione o altri programmi che dovranno leggere la variabile di ambiente. Se ad esempio si usa Visual Studio come editor, riavviare Visual Studio prima di eseguire l'esempio.

Per impostare la variabile di ambiente per l'area della risorsa Voce, seguire la stessa procedura. Impostare COGNITIVE_SERVICE_REGION sull'area della risorsa. Ad esempio: westus.

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) si basano sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Il numero massimo di transazioni consentite al secondo.
  • Le funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo importo, si verificherà un addebito aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Ottenere l'utilizzo corrente della quota per la risorsa

Usare il comando Get-AzCognitiveServicesAccountUsage per ottenere l'utilizzo per la risorsa.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name multi-service-resource

Pulire le risorse

Se si vuole pulire e rimuovere una risorsa dei servizi di intelligenza artificiale di Azure, è possibile eliminarla o il gruppo di risorse. Eliminando il gruppo di risorse vengono eliminate anche tutte le altre risorse al suo interno.

Per rimuovere il gruppo di risorse e le risorse associate, usare il comando Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Documentazione di riferimento | Codice sorgente della libreria | Pacchetto (NuGet) | Esempi

Prerequisiti di C#

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • Versione corrente di .NET Core
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.
  • Se si prevede di usare l'analisi spaziale in Visione artificiale di Azure o Analisi del testo per l'integrità nel linguaggio di intelligenza artificiale di Azure, è necessario creare le prime risorse di Visione artificiale o Lingua dal portale di Azure in modo da poter esaminare e riconoscere i termini e le condizioni. È possibile farlo qui: Azure AI Language, Azure AI Vision.You can do here: Azure AI Language, Azure AI Vision. Successivamente, è possibile creare risorse successive usando qualsiasi strumento di distribuzione (ad esempio, SDK, interfaccia della riga di comando o modello di Resource Manager) nella stessa sottoscrizione di Azure.

Creare un'entità servizio di Azure

Per fare in modo che l'applicazione interagisca con l'account Azure, è necessaria un'entità servizio di Azure per gestire le autorizzazioni. Seguire le istruzioni riportate in Creare un'entità servizio di Azure.

Quando si crea un'entità servizio, si noterà che include un valore segreto, un ID e un ID applicazione. Salvare l'ID applicazione e il segreto in un percorso temporaneo per i passaggi successivi.

Creare un gruppo di risorse

Prima di creare una risorsa dei servizi di intelligenza artificiale di Azure, l'account deve avere un gruppo di risorse di Azure per contenere la risorsa. Se non si ha già un gruppo di risorse, crearne uno nel portale di Azure prima di continuare.

Creare una nuova applicazione C#

Creare una nuova applicazione .NET Core. In una finestra di una console, ad esempio cmd, PowerShell o Bash, usare il comando dotnet new per creare una nuova app console con il nome azure-management-quickstart. Questo comando crea un semplice progetto C# "Hello World" con un unico file di origine: program.cs.

dotnet new console -n azure-management-quickstart

Spostarsi nella cartella dell'app appena creata. È possibile compilare l'applicazione con il comando seguente:

dotnet build

L'output di compilazione non deve contenere alcun avviso o errore.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Installare la libreria client

Nella directory dell'applicazione installare la libreria client di gestione di Azure per .NET con il comando seguente:

dotnet add package Azure.ResourceManager.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Se si usa l'ambiente di sviluppo integrato di Visual Studio, la libreria client è disponibile come pacchetto NuGet scaricabile.

Importare le librerie

Aprire program.cs e aggiungere le istruzioni using seguenti all'inizio del file:

using System;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

Autenticare il client

Aggiungere i campi seguenti alla radice di program.cs e inserire i relativi valori usando l'entità servizio creata e le informazioni sull'account Azure.

const string  service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const string  service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
const string subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Quindi, nel metodo Main, usare questi valori per creare un oggetto CognitiveServicesManagementClient. Questo oggetto è necessario per tutte le operazioni di gestione di Azure.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Chiamare i metodi di gestione

Aggiungere il codice seguente alla fine del metodo Main per elencare le risorse disponibili, creare una risorsa di esempio, elencare le risorse di cui si è proprietari e quindi eliminare la risorsa di esempio. Questi metodi verranno definiti nei passaggi seguenti.

    // Uncomment to list all available resource kinds, SKUs, and locations for your Azure account:
    //list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account and resource group:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();

Creare una risorsa dei servizi di intelligenza artificiale di Azure (C#)

Per creare e sottoscrivere una nuova risorsa dei servizi di intelligenza artificiale di Azure, usare il metodo Create . Questo metodo aggiunge una nuova risorsa fatturabile al gruppo di risorse che viene passato. Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio che si vuole usare, oltre al piano tariffario (o SKU) e a una località di Azure. Il metodo seguente accetta tutti questi argomenti e crea una risorsa.

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
    property from CognitiveServicesAccountProperties. */
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(customSubDomainName : subdomain_name), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, resource_name, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

Scegliere un servizio e un piano tariffario

Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio da usare, oltre al piano tariffario (o SKU) desiderato. Questa e altre informazioni verranno usate come parametri per la creazione della risorsa. È possibile trovare un elenco dei servizi di intelligenza artificiale di Azure disponibili "tipi" chiamando il metodo seguente nello script:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

Le tabelle seguenti forniscono informazioni sui prodotti e sui prezzi per i servizi di intelligenza artificiale di Azure.

Multi-servizio

Servizio Tipologia
Più servizi. Per ulteriori informazioni, vedere la pagina dei prezzi. CognitiveServices

Visione

Servizio Tipologia
Visione ComputerVision
Visione personalizzata - Previsione CustomVision.Prediction
Visione personalizzata - Training CustomVision.Training
Viso Face
Document Intelligence FormRecognizer

Voce

Servizio Tipologia
Voce SpeechServices

Lingua

Servizio Tipologia
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Lingua TextAnalytics
Traduzione testuale TextTranslation

Decision

Servizio Tipologia
Rilevamento anomalie AnomalyDetector
Content Moderator ContentModerator
Personalizza esperienze Personalizer

OpenAI di Azure

Servizio Tipologia
OpenAI di Azure OpenAI

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) sono basati sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Numero massimo di transazioni consentite al secondo (TPS).
  • Funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo numero, verrà addebitato un costo aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Nota

Molti dei servizi di intelligenza artificiale di Azure hanno un livello gratuito che è possibile usare per provare il servizio. Per usare il livello gratuito, usare F0 come piano tariffario per la risorsa.

Visualizzare le risorse

Per visualizzare tutte le risorse nell'account Azure (in tutti i gruppi di risorse), usare il metodo seguente:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Eliminare una risorsa

Il metodo seguente elimina la risorsa specificata dal gruppo di risorse specificato.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Eseguire l'applicazione

Eseguire l'applicazione dalla directory dell'applicazione con il comando dotnet run.

dotnet run

Documentazione di riferimento | Codice sorgente della libreria | Pacchetto (Maven)

Prerequisiti di Java

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • La versione corrente di Java Development Kit (JDK)
  • Lo strumento di compilazione Gradle o un'altra utilità di gestione dipendenze.
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.
  • Se si prevede di usare l'analisi spaziale in Visione artificiale di Azure o Analisi del testo per l'integrità nel linguaggio di intelligenza artificiale di Azure, è necessario creare le prime risorse di Visione artificiale o Lingua dal portale di Azure in modo da poter esaminare e riconoscere i termini e le condizioni. È possibile farlo qui: Azure AI Language, Azure AI Vision.You can do here: Azure AI Language, Azure AI Vision. Successivamente, è possibile creare risorse successive usando qualsiasi strumento di distribuzione (ad esempio, SDK, interfaccia della riga di comando o modello di Resource Manager) nella stessa sottoscrizione di Azure.

Creare un'entità servizio di Azure

Per fare in modo che l'applicazione interagisca con l'account Azure, è necessaria un'entità servizio di Azure per gestire le autorizzazioni. Seguire le istruzioni riportate in Creare un'entità servizio di Azure.

Quando si crea un'entità servizio, si noterà che include un valore segreto, un ID e un ID applicazione. Salvare l'ID applicazione e il segreto in un percorso temporaneo per i passaggi successivi.

Creare un gruppo di risorse

Prima di creare una risorsa dei servizi di intelligenza artificiale di Azure, l'account deve avere un gruppo di risorse di Azure per contenere la risorsa. Se non si ha già un gruppo di risorse, crearne uno nel portale di Azure prima di continuare.

Creare una nuova applicazione Java

In una finestra della console, ad esempio cmd, PowerShell o Bash, creare e passare a una nuova directory per l'app.

mkdir myapp && cd myapp

Eseguire il comando gradle init dalla directory di lavoro. Questo comando creerà i file di compilazione essenziali per Gradle, tra cui build.gradle.kts, che viene usato in fase di esecuzione per creare e configurare l'applicazione.

gradle init --type basic

Quando viene chiesto di scegliere un linguaggio DSL, selezionare Kotlin.

Dalla directory di lavoro eseguire il comando seguente:

mkdir -p src/main/java

Installare la libreria client

Questo argomento di avvio rapido usa l'utilità di gestione dipendenze Gradle. La libreria client e le informazioni per altre utilità di gestione dipendenze sono disponibili in Maven Central Repository.

Nel file build.gradle.kts del progetto includere la libreria client come istruzione implementation, unitamente ai plug-in e alle impostazioni necessari.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Importare le librerie

Passare alla nuova cartella src/main/Java e creare un file denominato Management.Java. Aprirlo in un editor o un IDE a scelta e importare le istruzioni import seguenti:

import com.azure.core.management.*;
import com.azure.core.management.profile.*;
import com.azure.identity.*;
import com.azure.resourcemanager.cognitiveservices.*;
import com.azure.resourcemanager.cognitiveservices.implementation.*;
import com.azure.resourcemanager.cognitiveservices.models.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

Autenticare il client

Aggiungere una classe in Management.Java, quindi aggiungere i campi seguenti e i relativi valori all'interno. Popolare i valori usando l'entità servizio creata e le altre informazioni sull'account Azure.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/

private static String applicationId = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
private static String applicationSecret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
private static String subDomainName = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Quindi, nel metodo main usare questi valori per creare un oggetto CognitiveServicesManager. Questo oggetto è necessario per tutte le operazioni di gestione di Azure.

/* For more information see:
https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
*/

ClientSecretCredential credential = new ClientSecretCredentialBuilder()
    .clientId(applicationId)
    .clientSecret(applicationSecret)
    .tenantId(tenantId)
    .build();
AzureProfile profile = new AzureProfile(tenantId, subscriptionId, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credential, profile);

Chiamare i metodi di gestione

Aggiungere il codice seguente alla fine del metodo Main per elencare le risorse disponibili, creare una risorsa di esempio, elencare le risorse di cui si è proprietari e quindi eliminare la risorsa di esempio. Questi metodi verranno definiti nei passaggi seguenti.

String resourceName = "test_resource";
String resourceKind = "TextTranslation";
String resourceSku = "F0";
Region resourceRegion = Region.US_WEST;

// Uncomment to list all available resource kinds, SKUs, and locations for your Azure account.
// list_available_kinds_skus_locations (client);

// Create a resource with kind Text Translation, SKU F0 (free tier), location US West.
String resourceId = create_resource (client, resourceName, resourceGroupName, resourceKind, resourceSku, resourceRegion);

// Uncomment this to list all resources for your Azure account.
// list_resources (client, resourceGroupName);

// Delete the resource.
delete_resource (client, resourceId);

/* NOTE: When you delete a resource, it is only soft-deleted. You must also purge it. Otherwise, if you try to create another
resource with the same name or custom subdomain, you will receive an error stating that such a resource already exists. */
purge_resource (client, resourceName, resourceGroupName, resourceRegion);

Creare una risorsa dei servizi di intelligenza artificiale di Azure (Java)

Per creare e sottoscrivere una nuova risorsa dei servizi di intelligenza artificiale di Azure, usare il metodo create . Questo metodo aggiunge una nuova risorsa fatturabile al gruppo di risorse che viene passato. Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio che si vuole usare, oltre al piano tariffario (o SKU) e a una località di Azure. Il metodo seguente accetta tutti questi argomenti e crea una risorsa.

public static String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String resourceKind, String resourceSku, Region resourceRegion) {
    System.out.println ("Creating resource: " + resourceName + "...");

    /* NOTE: If you do not want to use a custom subdomain name, remove the withCustomSubDomainName
    setter from the AccountProperties object. */
    Account result = client.accounts().define(resourceName)
        .withExistingResourceGroup(resourceGroupName)
        // Note: Do not call withRegion() first, as it does not exist on the Blank interface returned by define().
        .withRegion(resourceRegion)
        .withKind(resourceKind)
        .withSku(new Sku().withName(resourceSku))
        .withProperties(new AccountProperties().withCustomSubDomainName(subDomainName))
        .create();

    System.out.println ("Resource created.");
    System.out.println ("ID: " + result.id());
    System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
    System.out.println ();

    return result.id();
}

Scegliere un servizio e un piano tariffario

Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio da usare, oltre al piano tariffario (o SKU) desiderato. Questa e altre informazioni verranno usate come parametri per la creazione della risorsa. È possibile trovare un elenco dei servizi di intelligenza artificiale di Azure disponibili "tipi" chiamando il metodo seguente:

public static void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    for (ResourceSku sku : skus.list()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

Le tabelle seguenti forniscono informazioni sui prodotti e sui prezzi per i servizi di intelligenza artificiale di Azure.

Multi-servizio

Servizio Tipologia
Più servizi. Per ulteriori informazioni, vedere la pagina dei prezzi. CognitiveServices

Visione

Servizio Tipologia
Visione ComputerVision
Visione personalizzata - Previsione CustomVision.Prediction
Visione personalizzata - Training CustomVision.Training
Viso Face
Document Intelligence FormRecognizer

Voce

Servizio Tipologia
Voce SpeechServices

Lingua

Servizio Tipologia
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Lingua TextAnalytics
Traduzione testuale TextTranslation

Decision

Servizio Tipologia
Rilevamento anomalie AnomalyDetector
Content Moderator ContentModerator
Personalizza esperienze Personalizer

OpenAI di Azure

Servizio Tipologia
OpenAI di Azure OpenAI

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) sono basati sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Numero massimo di transazioni consentite al secondo (TPS).
  • Funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo numero, verrà addebitato un costo aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Nota

Molti dei servizi di intelligenza artificiale di Azure hanno un livello gratuito che è possibile usare per provare il servizio. Per usare il livello gratuito, usare F0 come piano tariffario per la risorsa.

Visualizzare le risorse

Per visualizzare tutte le risorse nell'account Azure (in tutti i gruppi di risorse), usare il metodo seguente:

public static void list_resources (CognitiveServicesManager client, String resourceGroupName) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (Account account : accounts.listByResourceGroup(resourceGroupName)) {
        System.out.println ("ID: " + account.id());
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ("Custom subdomain name: " + account.properties().customSubDomainName());
        System.out.println ();
    }
}

Eliminare una risorsa

Il metodo seguente elimina la risorsa specificata dal gruppo di risorse specificato.

public static void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteById (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Documentazione di riferimento | Codice sorgente della libreria | Pacchetto (npm) | Esempi

Prerequisiti di JavaScript

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • Versione corrente di Node.js
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.
  • Se si prevede di usare l'analisi spaziale in Visione artificiale di Azure o Analisi del testo per l'integrità nel linguaggio di intelligenza artificiale di Azure, è necessario creare le prime risorse di Visione artificiale o Lingua dal portale di Azure in modo da poter esaminare e riconoscere i termini e le condizioni. È possibile farlo qui: Azure AI Language, Azure AI Vision.You can do here: Azure AI Language, Azure AI Vision. Successivamente, è possibile creare risorse successive usando qualsiasi strumento di distribuzione (ad esempio, SDK, interfaccia della riga di comando o modello di Resource Manager) nella stessa sottoscrizione di Azure.

Creare un'entità servizio di Azure

Per fare in modo che l'applicazione interagisca con l'account Azure, è necessaria un'entità servizio di Azure per gestire le autorizzazioni. Seguire le istruzioni riportate in Creare un'entità servizio di Azure.

Quando si crea un'entità servizio, si noterà che include un valore segreto, un ID e un ID applicazione. Salvare l'ID applicazione e il segreto in un percorso temporaneo per i passaggi successivi.

Creare un gruppo di risorse

Prima di creare una risorsa dei servizi di intelligenza artificiale di Azure, l'account deve avere un gruppo di risorse di Azure per contenere la risorsa. Se non si ha già un gruppo di risorse, crearne uno nel portale di Azure prima di continuare.

Creare una nuova applicazione Node.js

In una finestra della console, ad esempio cmd, PowerShell o Bash, creare e passare a una nuova directory per l'app.

mkdir myapp && cd myapp

Eseguire il comando init per creare un'applicazione Node con un file package.json.

 init

Prima di procedere, creare un file denominato index.js.

Installare la libreria client

Installare i pacchetti npm seguenti:

npm install @azure/arm-cognitiveservices
npm install @azure/identity

Il file package.json dell'app viene aggiornato con le dipendenze.

Importare le librerie

Aprire lo script index.js e importare le librerie seguenti.

"use strict";

/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices @azure/identity
 */
var Arm = require("@azure/arm-cognitiveservices");
var Identity = require("@azure/identity");

Autenticare il client

Aggiungere i campi seguenti alla radice dello script e inserire i relativi valori usando l'entità servizio creata e le informazioni sull'account Azure.

const service_principal_application_id =
  "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names.
*/
const subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Aggiungere quindi la funzione quickstart seguente per gestire le operazioni principali del programma. Il primo blocco di codice crea un oggetto CognitiveServicesManagementClient usando le variabili di credenziali immesse sopra. Questo oggetto è necessario per tutte le operazioni di gestione di Azure.

async function quickstart() {
  /* For more information see:
https://www.npmjs.com/package/@azure/arm-cognitiveservices/v/6.0.0
https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-a-service-principal-with-a-client-secret
*/
  const credentials = new Identity.ClientSecretCredential(
    tenant_id,
    service_principal_application_id,
    service_principal_secret
  );
  const client = new Arm.CognitiveServicesManagementClient(
    credentials,
    subscription_id
  );
  // Note Azure resources are also sometimes referred to as accounts.
  const accounts_client = client.accounts;
  const resource_skus_client = client.resourceSkus;
  const deleted_accounts_client = client.deletedAccounts;

Chiamare le funzioni di gestione

Aggiungere il codice seguente alla fine della funzione quickstart per elencare le risorse disponibili, creare una risorsa di esempio, elencare le risorse di cui si è proprietari e quindi eliminare la risorsa di esempio. Queste funzioni verranno definite nei passaggi seguenti.

Creare una risorsa dei servizi di intelligenza artificiale di Azure (Node.js)

Per creare e sottoscrivere una nuova risorsa dei servizi di intelligenza artificiale di Azure, usare la funzione Crea . Questa funzione aggiunge una nuova risorsa fatturabile al gruppo di risorse che viene passato. Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio da usare, oltre al piano tariffario (o SKU) e a una località di Azure. La funzione seguente accetta tutti questi argomenti e crea una risorsa.

async function create_resource(
  client,
  resource_name,
  resource_kind,
  resource_sku,
  resource_region
) {
  console.log("Creating resource: " + resource_name + "...");
  /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
property from the properties object. */
  var parameters = {
    sku: { name: resource_sku },
    kind: resource_kind,
    location: resource_region,
    properties: { customSubDomainName: subdomain_name },
  };
  return client
    .beginCreateAndWait(resource_group_name, resource_name, parameters)
    .then((result) => {
      console.log("Resource created.");
      console.log();
      console.log("ID: " + result.id);
      console.log("Kind: " + result.kind);
      console.log();
    })
    .catch((err) => {
      console.log(err);
    });
}

Scegliere un servizio e un piano tariffario

Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio da usare, oltre al piano tariffario (o SKU) desiderato. Questa e altre informazioni verranno usate come parametri per la creazione della risorsa. La funzione seguente elenca i "tipi" disponibili per i servizi di intelligenza artificiale di Azure.

async function list_available_kinds_skus_locations(client) {
  console.log("Available SKUs:");
  var result = client.list();
  console.log("Kind\tSKU Name\tSKU Tier\tLocations");
  for await (let item of result) {
    var locations = item.locations.join(",");
    console.log(item.kind + "\t" + item.name + "\t" + item.tier + "\t" + locations);
  }
}

Le tabelle seguenti forniscono informazioni sui prodotti e sui prezzi per i servizi di intelligenza artificiale di Azure.

Multi-servizio

Servizio Tipologia
Più servizi. Per ulteriori informazioni, vedere la pagina dei prezzi. CognitiveServices

Visione

Servizio Tipologia
Visione ComputerVision
Visione personalizzata - Previsione CustomVision.Prediction
Visione personalizzata - Training CustomVision.Training
Viso Face
Document Intelligence FormRecognizer

Voce

Servizio Tipologia
Voce SpeechServices

Lingua

Servizio Tipologia
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Lingua TextAnalytics
Traduzione testuale TextTranslation

Decision

Servizio Tipologia
Rilevamento anomalie AnomalyDetector
Content Moderator ContentModerator
Personalizza esperienze Personalizer

OpenAI di Azure

Servizio Tipologia
OpenAI di Azure OpenAI

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) sono basati sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Numero massimo di transazioni consentite al secondo (TPS).
  • Funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo numero, verrà addebitato un costo aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Nota

Molti dei servizi di intelligenza artificiale di Azure hanno un livello gratuito che è possibile usare per provare il servizio. Per usare il livello gratuito, usare F0 come piano tariffario per la risorsa.

Visualizzare le risorse

Per visualizzare tutte le risorse nell'account Azure (in tutti i gruppi di risorse), usare la funzione seguente:

async function list_resources(client) {
  console.log("Resources in resource group: " + resource_group_name);
  var result = client.listByResourceGroup(resource_group_name);
  for await (let item of result) {
    console.log(item);
    console.log();
  }
}

Eliminare una risorsa

La funzione seguente elimina la risorsa specificata dal gruppo di risorse specificato.

async function delete_resource(client, resource_name) {
  console.log("Deleting resource: " + resource_name + "...");
  await client.beginDeleteAndWait(resource_group_name, resource_name);
  console.log("Resource deleted.");
  console.log();
}

Eseguire l'applicazione

Aggiungere il codice seguente alla fine dello script per chiamare la funzione quickstart principale con la gestione degli errori.

try {
  quickstart();
} catch (error) {
  console.log(error);
}

Quindi, nella finestra della console, eseguire l'applicazione con il comando node.

node index.js

Documentazione di riferimento | Codice sorgente della libreria | Pacchetto (PyPi) | Esempi

Prerequisiti di Python

  • Una sottoscrizione di Azure valida: crearne una gratuitamente.
  • Python 3.x
  • L'account Azure deve avere un Cognitive Services Contributor ruolo assegnato per consentire all'utente di accettare le condizioni di intelligenza artificiale responsabili e creare una risorsa. Per assegnare questo ruolo all'account, seguire la procedura descritta nella documentazione Assegnare ruoli oppure contattare l'amministratore.
  • Se si prevede di usare l'analisi spaziale in Visione artificiale di Azure o Analisi del testo per l'integrità nel linguaggio di intelligenza artificiale di Azure, è necessario creare le prime risorse di Visione artificiale o Lingua dal portale di Azure in modo da poter esaminare e riconoscere i termini e le condizioni. È possibile farlo qui: Azure AI Language, Azure AI Vision.You can do here: Azure AI Language, Azure AI Vision. Successivamente, è possibile creare risorse successive usando qualsiasi strumento di distribuzione (ad esempio, SDK, interfaccia della riga di comando o modello di Resource Manager) nella stessa sottoscrizione di Azure.

Creare un'entità servizio di Azure

Per fare in modo che l'applicazione interagisca con l'account Azure, è necessaria un'entità servizio di Azure per gestire le autorizzazioni. Seguire le istruzioni riportate in Creare un'entità servizio di Azure.

Quando si crea un'entità servizio, si noterà che include un valore segreto, un ID e un ID applicazione. Salvare l'ID applicazione e il segreto in un percorso temporaneo per i passaggi successivi.

Creare un gruppo di risorse

Prima di creare una risorsa dei servizi di intelligenza artificiale di Azure, l'account deve avere un gruppo di risorse di Azure per contenere la risorsa. Se non si ha già un gruppo di risorse, crearne uno nel portale di Azure prima di continuare.

Creare una nuova applicazione Python

Creare una nuova applicazione Python nell'editor o nell'IDE preferito e passare al progetto in una finestra della console.

Installare la libreria client

È possibile installare la libreria client con:

pip install azure-mgmt-cognitiveservices

Installare anche la libreria di identità di Azure per il supporto dell'autenticazione del token Microsoft Entra.

pip install azure-identity

Importare le librerie

Aprire lo script Python e importare le librerie seguenti.

import time
from azure.identity import ClientSecretCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import Account, Sku

Autenticare il client

Aggiungere i campi seguenti alla radice dello script e inserire i relativi valori usando l'entità servizio creata e le informazioni sull'account Azure.

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE"
service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "PASTE_YOUR_TENANT_ID_HERE"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE"

# The name of the custom subdomain to use when you create the resource. This is optional.
# For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
# your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
# Note not all Cognitive Services allow custom subdomain names.
subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE"

# How many seconds to wait between checking the status of an async operation.
wait_time = 10

Aggiungere quindi il codice seguente per creare un oggetto CognitiveServicesManagementClient. Questo oggetto è necessario per tutte le operazioni di gestione di Azure.

credential = ClientSecretCredential(tenant_id, service_principal_application_id, service_principal_secret)
client = CognitiveServicesManagementClient(credential, subscription_id)

Creare una risorsa dei servizi di intelligenza artificiale di Azure (Python)

Per creare e sottoscrivere una nuova risorsa dei servizi di intelligenza artificiale di Azure, usare la funzione Crea . Questa funzione aggiunge una nuova risorsa fatturabile al gruppo di risorse che viene passato. Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio da usare, oltre al piano tariffario (o SKU) e a una località di Azure. La funzione seguente accetta tutti questi argomenti e crea una risorsa.

def create_resource (resource_name, kind, sku_name, location) :
    print("Creating resource: " + resource_name + "...")

# NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
# property from the properties object.
    parameters = Account(sku=Sku(name=sku_name), kind=kind, location=location, properties={ 'custom_sub_domain_name' : subdomain_name })

    poller = client.accounts.begin_create(resource_group_name, resource_name, parameters)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

Scegliere un servizio e un piano tariffario

Quando si crea una nuova risorsa, è necessario conoscere il tipo di servizio da usare, oltre al piano tariffario (o SKU) desiderato. Questa e altre informazioni verranno usate come parametri per la creazione della risorsa. La funzione seguente elenca i "tipi" disponibili per i servizi di intelligenza artificiale di Azure.

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

Le tabelle seguenti forniscono informazioni sui prodotti e sui prezzi per i servizi di intelligenza artificiale di Azure.

Multi-servizio

Servizio Tipologia
Più servizi. Per ulteriori informazioni, vedere la pagina dei prezzi. CognitiveServices

Visione

Servizio Tipologia
Visione ComputerVision
Visione personalizzata - Previsione CustomVision.Prediction
Visione personalizzata - Training CustomVision.Training
Viso Face
Document Intelligence FormRecognizer

Voce

Servizio Tipologia
Voce SpeechServices

Lingua

Servizio Tipologia
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Lingua TextAnalytics
Traduzione testuale TextTranslation

Decision

Servizio Tipologia
Rilevamento anomalie AnomalyDetector
Content Moderator ContentModerator
Personalizza esperienze Personalizer

OpenAI di Azure

Servizio Tipologia
OpenAI di Azure OpenAI

Piani tariffari e fatturazione

I piani tariffari (e l'importo fatturato) sono basati sul numero di transazioni inviate usando le informazioni di autenticazione. Ogni piano tariffario specifica:

  • Numero massimo di transazioni consentite al secondo (TPS).
  • Funzionalità del servizio abilitate all'interno del piano tariffario.
  • Costo per un numero predefinito di transazioni. Se si supera questo numero, verrà addebitato un costo aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Nota

Molti dei servizi di intelligenza artificiale di Azure hanno un livello gratuito che è possibile usare per provare il servizio. Per usare il livello gratuito, usare F0 come piano tariffario per la risorsa.

Visualizzare le risorse

Per visualizzare tutte le risorse nell'account Azure (in tutti i gruppi di risorse), usare la funzione seguente:

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x.name)
        print(x)
        print()

Eliminare una risorsa

La funzione seguente elimina la risorsa specificata dal gruppo di risorse specificato.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")

    poller = client.accounts.begin_delete(resource_group_name, resource_name)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource deleted.")

Chiamare le funzioni di gestione

Aggiungere il codice seguente alla fine dello script per chiamare le funzioni indicate sopra. Questo codice elenca le risorse disponibili, crea una risorsa di esempio, elenca le risorse di cui si è proprietari e quindi elimina la risorsa di esempio.

resource_name = "test_resource"
resource_kind = "TextTranslation"
resource_sku = "F0"
resource_location = "Global"

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
#list_available_kinds_skus_locations ()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource(resource_name, resource_kind, resource_sku, resource_location)

# Uncomment this to list all resources for your Azure account.
#list_resources()

# Delete the resource.
delete_resource(resource_name)

# NOTE: Deleting a resource only soft-deletes it. To delete it permanently, you must purge it.
# Otherwise, if you later try to create a resource with the same name, you will receive the following error:
# azure.core.exceptions.ResourceExistsError: (FlagMustBeSetForRestore) An existing resource with ID '<your resource ID>' has been soft-deleted. To restore the resource, you must specify 'restore' to be 'true' in the property. If you don't want to restore existing resource, please purge it first.
# Code: FlagMustBeSetForRestore

# Purge the resource.
purge_resource(resource_name, resource_location)

Eseguire l'applicazione

Eseguire l'applicazione dalla riga di comando con il comando python.

python <your-script-name>.py

Passaggi successivi

  • Ora che si dispone di una risorsa, è possibile autenticare le richieste API a uno dei servizi di intelligenza artificiale di Azure supportati.