Condividi tramite

Guida introduttiva: Configura la tua prima risorsa Foundry

In questa guida introduttiva si crea una risorsa Microsoft Foundry e si verifica l'accesso.

Informazioni su come creare e gestire una risorsa Foundry. È il primario Azure tipo di risorsa per la creazione, la distribuzione e la gestione di modelli di intelligenza artificiale generativi e applicazioni, inclusi gli agenti in Azure.

Per usare e gestire i servizi in Azure è necessaria una risorsa Azure. Definisce l'ambito per la configurazione di accesso, sicurezza come rete, fatturazione e monitoraggio.

La risorsa Foundry è la versione successiva e la ridenominazione di "Foundry Tools". Fornisce l'ambiente dell'applicazione per ospitare gli agenti, le distribuzioni di modelli, le valutazioni e altro ancora.

Una risorsa Foundry può organizzare il lavoro per più casi d'uso ed è in genere condivisa tra un team di sviluppatori che lavora su casi d'uso in un dominio aziendale o dati simile. I progetti fungono da cartelle per raggruppare il lavoro correlato.

Diagramma che mostra la risorsa Foundry contenente più progetti, ognuno con distribuzioni e connessioni.

Annotazioni

Nel portale Foundry (nuovo) è disponibile solo il project predefinito. Usare il portale Foundry (classico) per interagire con tutti gli altri progetti in una risorsa Foundry.

Si vuole configurare Foundry con impostazioni di sicurezza avanzate? Vedere le opzioni avanzate di creazione di Foundry

Creare la prima risorsa

Per creare la prima risorsa, con le impostazioni di base Azure, seguire questa procedura usando Azure portal, Azure CLI o PowerShell.

Prerequisiti

  • Sottoscrizione di Azure valida: Crearne una gratuitamente.
  • Ruolo RBAC di Azure per creare risorse. È necessario uno dei ruoli seguenti assegnati nella sottoscrizione Azure o nel gruppo di risorse:
    • Collaboratore
    • Proprietario
    • Ruolo personalizzato con Microsoft.CognitiveServices/accounts/write autorizzazioni

Creare una nuova risorsa Microsoft Foundry

Se l'organizzazione richiede configurazioni personalizzate Azure come nomi alternativi, controlli di sicurezza o tag di costo, potrebbe essere necessario usare le opzioni Azure portal o template per rispettare la conformità Azure Policy dell'organizzazione.

La risorsa Foundry è elencata in Foundry>Foundry nel Azure portal. Il tipo di API è AIServices. Cercare il logo come illustrato di seguito:

Screenshot della risorsa Foundry nel portale Azure.

Suggerimento

Portal consente di creare una nuova risorsa Foundry con impostazioni predefinite e di base.

Per creare una risorsa Foundry nella Azure portal seguire queste istruzioni:

  1. Selezionare questo collegamento alla risorsa Foundry: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. Nella pagina Crea specificare le informazioni seguenti:

    Dettagli del progetto Descrizione
    Abbonamento Selezionare una delle sottoscrizioni Azure disponibili.
    Gruppo di risorse Gruppo di risorse Azure che conterrà la risorsa Foundry. È possibile creare un nuovo gruppo o aggiungerlo a un gruppo preesistente.
    Regione Posizione dell'istanza dello strumento Foundry. Posizioni diverse possono introdurre latenza, ma non hanno alcun impatto sulla disponibilità di runtime della risorsa.
    Nome Un nome descrittivo per la risorsa 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 Foundry, Potrebbe essere necessario abilitare il privilegio di tale provider di risorse Azure usando il comando Azure portal, PowerShell o un comando Azure CLI. 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 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. Nella Azure portal 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 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.

Usare questa guida introduttiva per creare una risorsa Foundry usando i comandi Azure Command-Line Interface (CLI).

Prerequisiti

  • Sottoscrizione di Azure valida: Crearne una gratuitamente.
  • È richiesta la versione 2.0 o successiva di Azure CLI.
  • Azure RBAC (Controllo degli Accessi in base al Ruolo) per creare risorse. È necessario uno dei ruoli seguenti assegnati nella sottoscrizione Azure o nel gruppo di risorse:
    • Collaboratore
    • Proprietario
    • Ruolo personalizzato con Microsoft.CognitiveServices/accounts/write autorizzazioni

Installare il Azure CLI e accedere

Installare il Azure CLI. 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 Foundry, è necessario disporre di un gruppo di risorse 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, è necessario una delle posizioni di Azure disponibili per l'abbonamento. È possibile recuperare un elenco di posizioni disponibili con il comando az account list-locations. È possibile accedere alla maggior parte degli strumenti Foundry da diverse posizioni. Scegliere quella più vicina o visualizzare le posizioni disponibili per il servizio.

Importante

  • Ricordare la posizione di Azure, perché sarà necessario quando si utilizzano le risorse di Microsoft Foundry.
  • La disponibilità di alcuni strumenti Foundry può variare in base all'area. Per altre informazioni, vedere Azure prodotti per area.
az account list-locations --query "[].{Region:name}" --out table

Dopo aver ottenuto la posizione di Azure, creare un nuovo gruppo di risorse nell'Azure CLI usando il comando az group create. Nell'esempio seguente sostituire il percorso di Azure westus2 con uno dei percorsi di Azure disponibili per la sottoscrizione.

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

Creare una risorsa Foundry

Per creare e sottoscrivere una nuova risorsa 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 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.

Importante

Azure fornisce più tipologie di risorse per gli strumenti di fonderia. Assicurarsi di crearne uno con il parametro kind impostato su AIServices.

È possibile creare una risorsa 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 Foundry, Potrebbe essere necessario abilitare il privilegio di tale provider di risorse Azure usando il comando Azure portal, PowerShell o un comando Azure CLI. 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 per la tua 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 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 Foundry usando i comandi Azure PowerShell.

Prerequisiti

  • Sottoscrizione di Azure valida: Crearne una gratuitamente.
  • Azure PowerShell versione 5.0 o successiva.
  • Ruolo RBAC di Azure per la creazione di risorse. È necessario uno dei ruoli seguenti assegnati nella sottoscrizione Azure o nel gruppo di risorse:
    • Collaboratore
    • Proprietario
    • Ruolo personalizzato con Microsoft.CognitiveServices/accounts/write autorizzazioni

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 Microsoft Foundry

Prima di creare una risorsa Foundry, è necessario disporre di un gruppo di risorse 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 località di Azure disponibili per la sottoscrizione. È possibile recuperare un elenco di posizioni disponibili con il comando Get-AzLocation. È possibile accedere alla maggior parte degli strumenti Foundry da diverse posizioni. Scegliere quella più vicina o visualizzare le posizioni disponibili per il servizio.

Importante

  • Tenere presente la posizione Azure, perché sarà necessaria quando si chiamano le risorse Foundry.
  • La disponibilità di alcuni strumenti Foundry può variare in base all'area. Per altre informazioni, vedere Azure prodotti per area.
Get-AzLocation | Select-Object -Property Location, DisplayName

Dopo aver ottenuto la posizione di Azure, crea un nuovo gruppo di risorse con Azure PowerShell usando il comando New-AzResourceGroup. Nell'esempio seguente sostituire il percorso di Azure westus2 con uno dei percorsi di Azure disponibili per la sottoscrizione.

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

Creare una risorsa Foundry

Per creare e sottoscrivere una nuova risorsa 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 località Azure:

Importante

Azure fornisce più tipologie di risorse per gli strumenti di fonderia. Assicurarsi di crearne uno con il parametro Type (tipo) impostato su AIServices.

È possibile creare una risorsa 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 Foundry, Potrebbe essere necessario abilitare il privilegio di tale provider di risorse Azure usando il comando Azure portal, PowerShell o un comando Azure CLI. 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 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

Accedi alla risorsa

Dopo aver creato la prima risorsa, è possibile accedervi tramite il portale Foundry per la creazione di prototipi UX, Foundry SDK per lo sviluppo, o tramite il portale Azure per la gestione amministrativa.

Verificare la configurazione

È possibile verificare che la risorsa sia configurata correttamente usando Azure AI Projects SDK per connettersi ed elencare i progetti. Questo esempio minimo conferma l'autenticazione e l'accesso.

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Output previsto: Successfully connected. Found X projects. dove X è il numero di progetti nella risorsa.

Riferimenti:

Concedere o ottenere autorizzazioni per sviluppatori

Azure Controllo degli Accessi Basato sui Ruoli (RBAC) distingue le autorizzazioni per le azioni di gestione e sviluppo. Per eseguire la compilazione con Foundry, all'account utente devono essere assegnate autorizzazioni per sviluppatori ("azioni dati"). È possibile utilizzare uno dei ruoli RBAC predefiniti oppure un ruolo RBAC personalizzato.

I ruoli sviluppatore incorporati di Azure RBAC per Foundry includono:

Ruolo Descrizione
Azure AI Project Manager Concedere autorizzazioni di sviluppo e autorizzazioni di gestione dei progetti. Può invitare altri utenti a collaborare a un project come "utente di intelligenza artificiale Azure".
Utente di Azure AI Concede le autorizzazioni di sviluppo.
Proprietario dell'account di Azure AI Concede access completi per gestire i progetti e gli account di intelligenza artificiale. Può invitare altri utenti a collaborare a un project come "utente di intelligenza artificiale Azure".
Proprietario di Azure AI Concedi pieno accesso a progetti di intelligenza artificiale gestiti e account e crea e sviluppa progetti.

Annotazioni

Il ruolo proprietario dell'intelligenza artificiale Azure sarà disponibile per l'assegnazione nel portale di Azure e Foundry a breve.

Diagramma dei ruoli predefiniti in Foundry.

Per le aziende di grandi dimensioni con requisiti di accesso rigorosi basati sui ruoli, è consigliabile usare il ruolo di "Azure AI User" con autorizzazioni per sviluppatori con privilegi minimi. Per le aziende di piccole dimensioni che vogliono che gli sviluppatori si self-service all'interno dell'organizzazione, è consigliabile usare il ruolo proprietario dell'intelligenza artificiale Azure per le autorizzazioni per gli sviluppatori e le autorizzazioni di creazione delle risorse.

Solo gli utenti autorizzati, in genere la sottoscrizione Azure o il proprietario del gruppo di risorse, possono assegnare un ruolo tramite [Azure portal](collegamento a Azure portal) o [Portale di Foundry tramite amministratore](Collegamento al portale foundry). Scopri di più sul controllo degli accessi basato sui ruoli.

Importante

Azure ruoli Proprietario e Collaboratore includono solo le autorizzazioni di gestione e non le autorizzazioni di sviluppo. Le autorizzazioni di sviluppo sono necessarie per la compilazione con tutte le funzionalità in Foundry.

Inizia a costruire nel tuo primo progetto

Con le autorizzazioni configurate, è ora possibile iniziare a sviluppare Foundry. Nel portale di Foundry aprire o creare il primo project. I progetti organizzano le attività di personalizzazione di agenti e modelli in Fonderia ed è possibile crearne più di uno nella stessa risorsa.

Esplorare alcuni dei servizi forniti con la risorsa:

Servizio Descrizione
icona FoundryServizio Agente Foundry Combinare la potenza dei modelli di intelligenza artificiale generativi con strumenti che consentono agli agenti di accedere e interagire con fonti di dati reali.
icona FoundryAzure Model Inference Esegue l'inferenza del modello per i modelli di punta nel catalogo dei modelli Foundry.
Icona di Azure OpenAI nei modelli di Foundry Azure OpenAI Esegue un'ampia gamma di attività con linguaggio naturale.
icona Sicurezza dei contenutiSicurezza dei contenuti Strumento Foundry che rileva contenuti indesiderati.
Icona Document IntelligenceIntelligenza dei documenti Trasformare i documenti in soluzioni intelligenti basate sui dati.
icona lingua lingua Sviluppare app con funzionalità di comprensione del linguaggio naturale leader del settore.
icona SpeechSpeech Da voce a testo, text to speech, traduzione e riconoscimento del parlante.
Icona Traduttore 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.

Passaggi successivi

  • Last updated on