Esplorare gli approcci di sviluppo

Completato

Il servizio Microsoft Foundry Agent offre flessibilità nel modo in cui si sviluppano gli agenti, con opzioni che vanno dalle interfacce visive ai flussi di lavoro incentrati sul codice. Comprendere i diversi approcci di sviluppo consente di scegliere gli strumenti appropriati per gli scenari e le preferenze del team.

Sviluppo del portale foundry

Il portale foundry offre un'interfaccia basata sul Web per la creazione e la gestione degli agenti di intelligenza artificiale senza scrivere codice. Questo approccio è ideale quando si vogliono creare rapidamente prototipi di idee, collaborare con stakeholder non tecnici o gestire gli agenti tramite un'interfaccia centralizzata.

Quando usare il portale Foundry

Il portale eccelle in questi scenari:

  • Creazione rapida di prototipi - Testare rapidamente i concetti e le configurazioni dell'agente senza configurare gli ambienti di sviluppo
  • Configurazione visiva : configurare gli agenti tramite moduli e elenchi a discesa intuitivi anziché codice
  • Gestione centralizzata : visualizzare e gestire tutti gli agenti tra i progetti in un'unica posizione
  • Collaborazione tra team - Condividere le configurazioni dell'agente con gli stakeholder che preferiscono le interfacce visive
  • Supervisione delle risorse - Monitorare l'utilizzo, la latenza e i risultati di valutazione dei token tramite dashboard

Il portale di Azure consente di accedere immediatamente alla creazione dell'agente senza installare strumenti aggiuntivi. È sufficiente passare al progetto Foundry, selezionare la sezione Agenti e avviare la compilazione.

Sviluppo di Visual Studio Code

L'estensione Microsoft Foundry per Visual Studio Code offre funzionalità di intelligenza artificiale di livello aziendale direttamente nell'ambiente di sviluppo. Questo approccio è adatto agli sviluppatori che preferiscono lavorare in editor di codice familiari e vogliono una stretta integrazione con i flussi di lavoro di sviluppo.

Funzionalità principali dell'estensione di VS Code

L'estensione organizza le sue funzionalità in tre sezioni principali:

Risorse : esplorare e gestire gli asset del progetto Foundry direttamente da VS Code, tra cui:

  • Modelli distribuiti - Visualizzare e gestire le distribuzioni dei modelli
  • Agenti dichiarativi - Visualizzare e configurare agenti basati su prompt e flusso di lavoro
  • Agenti ospitati - Visualizzare e gestire agenti in contenitori distribuiti tramite codice
  • Connessioni - Gestire le connessioni ai servizi esterni
  • Archivi vettoriali - Organizzare raccolte documenti per Ricerca file

Strumenti - Accedere alle funzionalità di sviluppo e test:

  • Catalogo Modelli - Sfoglia e distribuisci modelli dal catalogo
  • Model Playground - Sperimentare direttamente i modelli
  • Playground degli agenti - Testare gli agenti utilizzando playground remoti o locali
  • Visualizzatore locale - Eseguire il debug e visualizzare il comportamento dell'agente in locale
  • Distribuire agenti ospitati - Distribuire agenti in contenitori nell'ambiente di produzione

Guida e commenti e suggerimenti - Accedere alla documentazione e alle risorse di supporto.

L'estensione fornisce anche una finestra di progettazione dell'agente visivo per la configurazione delle proprietà dell'agente, la generazione integrata di codice per l'integrazione dell'applicazione e la modifica diretta della configurazione YAML per un controllo preciso.

Screenshot dell'interfaccia dell'estensione Microsoft Foundry VS Code che mostra le sezioni Risorse, Strumenti e Guida e Commenti.

Quando usare Visual Studio Code

L'estensione VS Code è ideale per:

  • Flussi di lavoro incentrati sugli sviluppatori : creare agenti insieme al codice dell'applicazione in un unico ambiente
  • Integrazione del controllo della versione - Tenere traccia delle configurazioni dell'agente in Git insieme alla codebase
  • Iterazione rapida : apportare modifiche rapide e testare immediatamente senza cambiare gli strumenti
  • Sviluppo code-first - Modificare direttamente le configurazioni YAML per un controllo preciso
  • Sviluppo locale - Lavorare offline sulle progettazioni degli agenti prima di eseguire la distribuzione in Azure

L'estensione viene installata direttamente dal Marketplace Visual Studio Code e si connette ai progetti Foundry esistenti. Le procedure dettagliate di installazione e configurazione sono illustrate nell'unità successiva.

Flusso di lavoro di sviluppo tipico

Indipendentemente dall'approccio scelto, lo sviluppo dell'agente segue un modello coerente:

  1. Connettersi al progetto Microsoft Foundry
  2. Creare un agente di intelligenza artificiale nel portale foundry con un nome descrittivo e uno scopo
  3. Configurare le istruzioni dell'agente che ne definiscono il comportamento e le funzionalità (nel portale o in VS Code)
  4. Aggiungere strumenti per estendere le operazioni che l'agente può eseguire
  5. Testare l'agente utilizzando le piattaforme di test integrate
  6. Iterare sulla progettazione in base ai risultati dei test
  7. Distribuire l'agente nell'ambiente di produzione
  8. Integrare l'agente nelle applicazioni

Il portale foundry e l'estensione VS Code supportano entrambi questo flusso di lavoro, che differiscono principalmente nello stile dell'interfaccia anziché nelle funzionalità.

Risorse di Azure necessarie

Entrambi gli approcci di sviluppo richiedono le stesse risorse Azure sottostanti. Per sviluppare agenti con il servizio Microsoft Foundry Agent, è necessario:

  • Progetto Microsoft Foundry : organizza gli agenti, i modelli e gli asset correlati in un'unica posizione
  • Distribuzione di modelli - Modelli di intelligenza artificiale distribuiti (ad esempio GPT-4.1 o Claude Sonnet 4.6) che supportano gli agenti

Quando si crea un progetto Microsoft Foundry, viene eseguito automaticamente il provisioning dell'infrastruttura necessaria. Quando si aggiungono funzionalità agli agenti, ad esempio Ricerca file o strumenti personalizzati, il servizio integra facilmente tutti i servizi di supporto necessari in background. Se si sceglie di estendere ulteriormente le funzionalità dell'agente, ad esempio con L'IQ Foundry, potrebbe essere necessario distribuire alcuni servizi aggiuntivi Azure.

Servizi di Azure facoltativi

A seconda delle funzionalità dell'agente, è possibile integrare servizi aggiuntivi Azure:

  • Azure AI Search - Per il recupero avanzato delle conoscenze quando si usano gli strumenti di Foundry IQ o Ricerca File
  • Azure Storage : per l'archiviazione e la gestione di file a cui gli agenti possono accedere
  • Azure Key Vault - Per la gestione sicura di segreti e credenziali
  • Azure Functions - Per implementazioni di strumenti personalizzati e logica di business

Questi servizi si integrano con il progetto Foundry in base alle esigenze, ma non sono necessari per iniziare a creare agenti.

Scelta dell'approccio di sviluppo

Sia il portale foundry che l'estensione Visual Studio Code offrono funzionalità complete di sviluppo degli agenti. La scelta dipende dalle preferenze del flusso di lavoro, dalla composizione del team e dai requisiti di integrazione:

Scegliere il Portale Foundry quando si desidera una configurazione visiva, gestione centralizzata o rapida creazione di prototipi senza configurazione di sviluppo locale.

Scegliere Visual Studio Code quando si preferisce flussi di lavoro incentrati sugli sviluppatori, è necessaria una stretta integrazione con il codice dell'applicazione o si vogliono file di configurazione controllati dalla versione.

Molti team usano entrambi gli approcci, ovvero il portale per l'esplorazione iniziale e le revisioni degli stakeholder e VS Code per distribuzioni dettagliate di sviluppo e produzione. La flessibilità di passare da un approccio all'altro in base alle esigenze immediate è un punto di forza fondamentale del servizio Microsoft Foundry Agent.