Installare le estensioni di Foundry per Azure Developer CLI

Importante

Gli elementi contrassegnati (anteprima) in questo articolo sono attualmente in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate. Per ulteriori informazioni, vedere Condizioni supplementari per l'uso delle versioni di anteprima di Microsoft Azure.

Le estensioni Azure Developer CLI (azd) ai consentono di compilare, distribuire, valutare e gestire gli agenti di intelligenza artificiale in Microsoft Foundry dal terminale. In questo articolo si installano le estensioni, si verifica l'installazione e si esegue l'autenticazione per Azure.

Prerequisiti

  • Una sottoscrizione di Azure. Creane uno gratis.
  • Azure Developer CLI (azd) versione 1.25.2 o successiva. Installare azd.
  • Python 3.10 o versione successiva o .NET 8 o versione successiva, a seconda del framework dell'agente che si prevede di usare.

Autorizzazioni di Azure

Per la sottoscrizione di Azure sono necessari i ruoli seguenti.

Ruolo Purpose
Collaboratore Effettuare il provisioning e gestire le risorse Azure.
Proprietario della fonderia Obbligatorio solo se si creano nuovi progetti Foundry.

Importante

I ruoli di Controllo degli accessi in base al ruolo di Foundry sono stati recentemente rinominati. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager erano precedentemente denominati Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. È possibile che i nomi precedenti vengano visualizzati in alcune posizioni durante l'esecuzione della ridenominazione. Gli ID ruolo e le autorizzazioni di base sono invariati dalla ridenominazione.

Informazioni su come vengono in pacchetto le estensioni

Il namespace azd ai è composto da più azd estensioni indipendenti. Ciascuno aggiunge un gruppo di comandi di primo livello sotto azd ai.

ID estensione Gruppo di comandi Funzionamento
microsoft.foundry meta-pacchetto Aggrega tutte le estensioni Foundry per una singola installazione.
azure.ai.agents azd ai agent Distribuisci agenti con Foundry dal tuo terminale.
azure.ai.connections azd ai connection Gestire le connessioni del progetto Foundry.
azure.ai.inspector azd ai inspector Interfaccia utente del controllo basata su browser per gli agenti in esecuzione in locale.
azure.ai.projects azd ai project Gestire il contesto del progetto Foundry (set, unset, show).
azure.ai.routines azd ai routine Gestire le routine Foundry (timer, pianificazioni, trigger di eventi).
azure.ai.skills azd ai skill Gestisci le abilità di Foundry (linee guida comportamentali riutilizzabili per l'agente).
azure.ai.toolboxes azd ai toolbox Gestire le toolbox di Foundry (raccolte di strumenti versionate).

Il pacchetto microsoft.foundry è un meta-pacchetto minimale che non fornisce comandi propri. Installandolo, vengono installate tutte le singole estensioni, che è il punto di partenza consigliato. Installando azure.ai.agents da solo, viene installato automaticamente anche azure.ai.inspector, perché l'estensione dell'agente dipende da questo.

Installare il bundle completo

Installare ogni estensione Foundry in un unico passaggio nel meta-pacchetto:

azd ext install microsoft.foundry

Per eseguire l'aggiornamento in un secondo momento:

azd ext upgrade microsoft.foundry

Installare o aggiornare una singola estensione

È anche possibile gestire ogni estensione autonomamente:

# Just the agent surface
azd ext install azure.ai.agents

# Just the routine surface
azd ext install azure.ai.routines

# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections

Le singole estensioni hanno un versionamento indipendente, quindi è possibile bloccarne o aggiornarne una alla volta.

Verificare l'installazione

Elenco delle estensioni installate:

azd ext list

Verrà visualizzato microsoft.foundry più ogni singola estensione. Ogni estensione espone anche un version sottocomando:

azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version

Authenticate

Accedere a Azure in modo che l'interfaccia della riga di comando possa effettuare il provisioning e gestire le risorse per conto dell'utente:

azd auth login

Questo comando apre una finestra del browser per l'autenticazione interattiva. Dopo aver effettuato l'accesso, la CLI memorizza localmente nella cache le credenziali per i comandi successivi.

Contenuti correlati

  • Last updated on