Guida introduttiva: Creare la vostra prima risorsa di AI Foundry

Informazioni su come creare e gestire una risorsa di Ai Foundry. È il tipo di risorsa principale per la progettazione, la distribuzione e la gestione di applicazioni e agenti di intelligenza artificiale generativi. Fornisce l'accesso al servizio agente, ai modelli ospitati usando un modello di hosting serverless, le valutazioni e il servizio Azure OpenAI. Questo è il tipo di risorsa consigliato per la maggior parte delle applicazioni compilate in Azure AI Foundry.

Azure AI Foundry è la versione successiva e la ridenominazione dell'ex 'Servizi di intelligenza artificiale di Azure'. Tutte le funzionalità precedenti sono supportate, inclusi i modelli di Servizi di intelligenza artificiale di Azure per riconoscimento vocale, visione artificiale, funzionalità del linguaggio. Le nuove funzionalità includono l'API AI Foundry che consente di accedere al servizio Agent e valutazioni, ai progetti come cartelle per organizzare il lavoro e alle connessioni da integrare con altri servizi di Azure.

Si vuole usare AI Foundry con impostazioni di sicurezza avanzate? Vedere opzioni avanzate per la creazione di intelligenza artificiale Foundry

Si vogliono usare le competenze di Ricerca intelligenza artificiale di Azure? Vedere la risorsa classica dei servizi multiservizi di Azure per intelligenza artificiale.

Prerequisiti

• Una sottoscrizione di Azure valida: crearne una gratuitamente.

Creare una nuova risorsa di Azure AI Foundry

Il portale di AI Foundry consente di creare una nuova risorsa di Azure con impostazioni di base predefinite. Se l'organizzazione richiede configurazioni personalizzate di Azure come nomi alternativi, controlli di sicurezza o tag di costo, potrebbe essere necessario usare il portale di Azure o le opzioni dei modelli per rispettare la conformità dei criteri di Azure dell'organizzazione.

La risorsa multiservizio di Azure AI Foundry è elencata sotto AI Foundry nel portale.> Il tipo di API è AIServices. Cercare il logo come illustrato di seguito:

Importante

Azure offre più tipi di risorse denominati servizi di Azure AI. Assicurarsi di selezionare quello elencato in AI Foundry> con il logo come illustrato in precedenza.

Per creare una risorsa di AI Foundry, seguire queste istruzioni:

Suggerimento

Se è necessario creare un progetto Foundry o una risorsa di progetto basata su hub, è anche possibile usare il portale di Azure Foundry per creare la risorsa. Per altre informazioni, vedere gli articoli seguenti:

• Creare un progetto Azure AI Foundry.
• Creare un progetto basato su hub di intelligenza artificiale di Azure.

1. Selezionare questo collegamento per creare una risorsa di Ai Foundry : https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

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 di Azure che conterrà la risorsa Azure AI Foundry. È possibile creare un nuovo gruppo o aggiungerlo a un gruppo preesistente.
   Regione	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 per la risorsa di Azure AI Foundry. Ad esempio, MyAIServicesResource.

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 AI Foundry, potrebbe essere necessario abilitare il privilegio di tale provider di risorse di Azure usando il portale di Azure, il comando di PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si è il proprietario della sottoscrizione, chiedere a un utente con il ruolo di Proprietario o Amministratore di completare la registrazione o chiedere di concedere al proprio account i privilegi /register/action.

Pulire le risorse

Se si vuole pulire e rimuovere una risorsa di AI Foundry, è 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 Azure AI Foundry, 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.

Usa questa guida rapida per creare una risorsa AI Foundry utilizzando i comandi dell'interfaccia Azure Command-Line (CLI).

Prerequisiti

• Una sottoscrizione di Azure valida: crearne una gratuitamente.
• L'interfaccia della riga di comando di Azure

Installare Azure CLI e accedere

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

Creare un nuovo gruppo di risorse

Prima di creare una risorsa di AI Foundry, è 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.

Per creare una risorsa, è necessaria una delle posizioni di Azure disponibili per la sottoscrizione. È possibile recuperare un elenco delle posizioni disponibili con il comando az account list-locations. La maggior parte dei Servizi di Azure AI è accessibile da diverse posizioni. Scegliere quella più vicina o visualizzare le posizioni disponibili per il servizio.

Importante

• Ricordare la posizione di Azure, perché sarà necessaria quando si chiamano le risorse di Azure AI Foundry.
• La disponibilità di alcuni Servizi di Azure AI 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 posizione 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 posizione di Azure westus2 con una delle posizioni di Azure disponibili per la sottoscrizione.

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

Creare una risorsa di Ai Foundry

Per creare e sottoscrivere una nuova risorsa di Azure AI Foundry, usare il comando az cognitiveservices account create . Questo comando aggiunge una nuova risorsa fatturabile al gruppo di risorse creato in precedenza. 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.

Importante

Azure offre più tipi di risorse per i servizi di Azure AI. Assicurarsi di crearne uno con il parametro kind impostato su AIServices.

È possibile creare una risorsa di AI Foundry denominata foundry-multi-service-resource con il comando seguente.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

Suggerimento

Se la sottoscrizione non consente di creare una risorsa di AI Foundry, potrebbe essere necessario abilitare il privilegio di tale provider di risorse di Azure usando il portale di Azure, il comando di PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si è il proprietario della sottoscrizione, chiedere a un utente con il ruolo di Proprietario o Amministratore di completare la registrazione o chiedere di concedere al proprio account i privilegi /register/action.

Ottenere l'utilizzo della quota corrente per la risorsa

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

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

Pulire le risorse

Se si vuole pulire e rimuovere una risorsa di AI Foundry, è 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 az group delete command.

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

Usare questa guida introduttiva per creare una risorsa di AI Foundry usando i comandi con Azure PowerShell.

Prerequisiti

• Una sottoscrizione di Azure valida: crearne una gratuitamente.
• Azure PowerShell.

Installare Azure PowerShell ed eseguire l'accesso

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

Connect-AzAccount

Creare un nuovo gruppo di risorse di Azure AI Foundry

Prima di creare una risorsa di AI Foundry, è 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.

Per creare una risorsa, è necessaria una delle posizioni di Azure disponibili per la sottoscrizione. È possibile recuperare un elenco di posizioni disponibili con il comando Get-AzLocation. La maggior parte dei Servizi di Azure AI è accessibile da diverse posizioni. Scegliere quella più vicina o visualizzare le posizioni disponibili per il servizio.

Importante

• Ricordare la posizione di Azure, perché sarà necessaria quando si chiamano le risorse di Azure AI Foundry.
• La disponibilità di alcuni Servizi di Azure AI 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 posizione di Azure westus2 con una delle posizioni di Azure disponibili per la sottoscrizione.

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

Creare una risorsa di Ai Foundry

Per creare e sottoscrivere una nuova risorsa di Azure AI Foundry, 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 posizione di Azure:

Importante

Azure offre più tipi di risorse per i servizi di Azure AI. Assicurarsi di crearne uno con il parametro Type (tipo) impostato su AIServices.

È possibile creare una risorsa di AI Foundry denominata foundry-multi-service-resource con il comando seguente.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

Suggerimento

Se la sottoscrizione non consente di creare una risorsa di AI Foundry, potrebbe essere necessario abilitare il privilegio di tale provider di risorse di Azure usando il portale di Azure, il comando di PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si è il proprietario della sottoscrizione, chiedere a un utente con il ruolo di Proprietario o Amministratore di completare la registrazione o chiedere di concedere al proprio account i privilegi /register/action.

Ottenere l'utilizzo della quota corrente per la risorsa

Usa il comando Get-AzCognitiveServicesAccountUsage per ottenere l'uso della tua risorsa.

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

Pulire le risorse

Se si vuole pulire e rimuovere una risorsa di AI Foundry, è 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

Progetto predefinito

In AI Foundry i progetti forniscono l'accesso alle API per sviluppatori e fungono da cartelle per organizzare il lavoro. Un progetto predefinito viene creato automaticamente quando si crea la risorsa nel portale di Azure o nel portale di Azure AI Foundry. Il progetto predefinito ha un concetto speciale: offre retrocompatibilità con le API per sviluppatori supportate a livello di risorsa padre. In genere si tratta di servizi di intelligenza artificiale e API OpenAI di Azure per la personalizzazione del modello. Le API più recenti, tra cui agenti e valutazioni, sono accessibili da qualsiasi progetto. Per altre informazioni, vedere Tipi di progetti.

La risorsa di AI Foundry potrebbe essere o non essere associata a un progetto di AI Foundry.

• Se le risorse di AI Foundry sono state create usando l'interfaccia della riga di comando di Azure, PowerShell, modello Bicep, Terraform o SDK. In questi casi, la risorsa AI Foundry per impostazione predefinita non è associata a un progetto. È possibile creare un progetto in un secondo momento come risorsa figlio.
• Se la risorsa di AI Foundry è stata creata come connessione. Ad esempio, quando si tenta di distribuire un modello non disponibile nella regione della vostra attuale risorsa AI Foundry.
• Un progetto può essere creato nel portale di Azure AI Foundry e associato automaticamente come dipendente da una nuova risorsa di AI Foundry.
• Una risorsa di AI Foundry potrebbe essere stata creata nel portale di AI Foundry, ma come risorsa dipendente di un hub di Azure AI Foundry. In questo caso, la risorsa viene associata automaticamente al progetto creato nell'hub.

Servizi supportati con una risorsa di Ai Foundry

La risorsa AI Foundry consente l'accesso ai servizi di intelligenza artificiale di Azure seguenti con un singolo set di credenziali. Alcuni servizi sono disponibili tramite la risorsa AI Foundry e la risorsa per servizio singolo.

Suggerimento

È consigliabile, quando possibile, usare la risorsa AI Foundry (dove il tipo di API è AIServices) per accedere a più servizi di intelligenza artificiale di Azure con un singolo set di credenziali. Per i servizi non disponibili tramite la risorsa Ai Foundry (ad esempio Viso e Visione personalizzata), in alternativa è possibile creare una risorsa a servizio singolo.

Servizio	Descrizione	Tipo (tramite API)
AI Foundry Agent Service	Combinare la potenza dei modelli di intelligenza artificiale generativi con strumenti che consentono agli agenti di accedere e interagire con origini dati reali.	AIServices
Inferenza del modello di intelligenza artificiale di Azure	Esegue l'inferenza del modello per i modelli di punta nel catalogo dei modelli di Azure AI Foundry.	AIServices
Azure OpenAI (Azure AI Foundry Models)	Esegue un'ampia gamma di attività con linguaggio naturale.	AIServices OpenAI
Sicurezza dei contenuti	Servizio di intelligenza artificiale che rileva contenuti indesiderati.	AIServices ContentSafety
Visione personalizzata	Personalizzare il riconoscimento delle immagini per l'azienda.	CustomVision.Prediction(Solo previsione) CustomVision.Training(Solo training)
Informazioni sui documenti	Trasformare i documenti in soluzioni intelligenti basate sui dati.	AIServices FormRecognizer
Viso	Rileva e identifica persone ed emozioni nelle immagini.	Face
Lingua	Creare app con funzionalità leader del settore di comprensione del linguaggio naturale.	AIServices TextAnalytics
Voce	Conversione della voce in testo scritto, sintesi vocale, traduzione e riconoscimento del parlante.	AIServices Speech
Traduttore	Usare la tecnologia di traduzione basata su intelligenza artificiale per tradurre più di 100 lingue e dialetti in uso, a rischio e in pericolo.	AIServices TextTranslation
Visione artificiale	Consente di analizzare il contenuto in immagini e video.	AIServices (Training e stima) ComputerVision

Risorsa multiservizi di Azure AI per le capacità di Ricerca di Azure AI

Le competenze di Ricerca intelligenza artificiale di Azure non supportano la risorsa Di intelligenza artificiale Foundry, come descritto in precedenza in questo articolo. È necessario creare un tipo diverso di risorsa multiservizio per le competenze di Ricerca intelligenza artificiale di Azure.

La risorsa multiservizio che è possibile usare con le competenze di Ricerca di intelligenza artificiale di Azure è elencata in AI Foundry>Classic AI services> (account multiservizio classico) nel portale. Cercare il logo come illustrato di seguito:

Per creare una risorsa multiservizio per Ricerca di intelligenza artificiale di Azure, seguire queste istruzioni:

1. Selezionare questo collegamento per creare una risorsa di account multiservizio di Servizi di intelligenza artificiale di Azure (versione classica):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 di Azure che conterrà la risorsa account multiservizio dei servizi di intelligenza artificiale di Azure. È possibile creare un nuovo gruppo o aggiungerlo a un gruppo preesistente.
   Regione	Area geografica dell'istanza dell'account multiservizio dei servizi di intelligenza artificiale di Azure. Posizioni diverse possono introdurre latenza, ma non hanno alcun impatto sulla disponibilità di runtime della risorsa.
   Nome	Nome descrittivo per la risorsa account multiservizio dei servizi di intelligenza artificiale di Azure. Ad esempio, MyCognitiveServicesResource.
   Piano tariffario	Il costo dell'account multiservizio dei servizi di Intelligenza artificiale di Azure dipende dalle opzioni scelte e dall'utilizzo. Per altre informazioni, vedere i dettagli sui prezzi delle API.

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 AI Foundry, potrebbe essere necessario abilitare il privilegio di tale provider di risorse di Azure usando il portale di Azure, il comando di PowerShell o un comando dell'interfaccia della riga di comando di Azure. Se non si è il proprietario della sottoscrizione, chiedere a un utente con il ruolo di Proprietario o Amministratore di completare la registrazione o chiedere di concedere al proprio account i privilegi /register/action.

Prezzi

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

• Il numero massimo di transazioni consentite al secondo (TPS).
• Le funzionalità del servizio abilitate all'interno del piano tariffario.
• Il costo per un numero predefinito di transazioni. Il superamento di questo numero determinerà un addebito aggiuntivo, come specificato nei dettagli dei prezzi per il servizio.

Contenuto correlato

• Passare alla pagina dell'hub dei servizi di intelligenza artificiale di Azure.
• Provare i servizi di intelligenza artificiale nel portale di Azure AI Foundry.