1. Seleziona un modello

April 4, 2026 · View on GitHub

!!! tip "AL TERMINE DI QUESTO MODULO SARAI IN GRADO DI"

- [ ] Descrivere cosa sono i template AZD
- [ ] Scoprire e usare i template AZD per l'AI
- [ ] Iniziare con il template AI Agents
- [ ] **Lab 1:** Avvio rapido AZD in Codespaces o in un dev container

1. Un'analogia del costruttore

Costruire un'applicazione AI moderna e pronta per l'impresa da zero può essere scoraggiante. È un po' come costruire la tua nuova casa da solo, mattone dopo mattone. Sì, è fattibile! Ma non è il modo più efficace per ottenere il risultato desiderato!

Invece, spesso partiamo da un buon progetto di design esistente e collaboriamo con un architetto per personalizzarlo in base alle nostre esigenze personali. Ed è esattamente l'approccio da adottare quando si costruiscono applicazioni intelligenti. Prima, trova una buona architettura di progetto che si adatti al tuo ambito di problema. Poi lavora con un solution architect per personalizzare e sviluppare la soluzione per il tuo scenario specifico.

Ma dove possiamo trovare questi progetti di design? E come troviamo un architetto disposto a insegnarci come personalizzare e distribuire questi progetti da soli? In questo workshop rispondiamo a queste domande presentandoti tre tecnologie:

  1. Azure Developer CLI - uno strumento open-source che accelera il percorso dello sviluppatore passando dallo sviluppo locale (build) alla distribuzione cloud (ship).
  2. Microsoft Foundry Templates - repository open-source standardizzati contenenti codice di esempio, infrastruttura e file di configurazione per distribuire un'architettura di soluzione AI.
  3. GitHub Copilot Agent Mode - un agente di codifica basato sulla conoscenza di Azure, in grado di guidarci nella navigazione del codebase e nell'apportare modifiche usando il linguaggio naturale.

Con questi strumenti a disposizione, ora possiamo scoprire il template giusto, distribuirlo per verificarne il funzionamento e personalizzarlo per adattarlo ai nostri scenari specifici. Immergiamoci e impariamo come funzionano.

2. Azure Developer CLI

La Azure Developer CLI (o azd) è uno strumento da riga di comando open-source che può accelerare il tuo percorso da codice a cloud con una serie di comandi pensati per gli sviluppatori che funzionano in modo coerente nel tuo IDE (sviluppo) e negli ambienti CI/CD (devops).

Con azd, il tuo percorso di distribuzione può essere semplice come:

  • azd init - Inizializza un nuovo progetto AI da un template AZD esistente.
  • azd up - Provisiona l'infrastruttura e distribuisce la tua applicazione in un unico passaggio.
  • azd monitor - Ottieni monitoraggio e diagnostica in tempo reale per la tua applicazione distribuita.
  • azd pipeline config - Configura pipeline CI/CD per automatizzare la distribuzione su Azure.

🎯 | ESERCIZIO:
Esplora lo strumento da riga di comando azd nel tuo attuale ambiente del workshop ora. Questo può essere GitHub Codespaces, un dev container o una copia locale con i prerequisiti installati. Inizia digitando questo comando per vedere cosa può fare lo strumento:

azd help

Flusso

3. Il template AZD

Per permettere ad azd di fare tutto questo, deve conoscere l'infrastruttura da provisionare, le impostazioni di configurazione da applicare e l'applicazione da distribuire. Ed è qui che entrano in gioco gli AZD templates.

Gli AZD templates sono repository open-source che combinano codice di esempio con file di infrastruttura e configurazione necessari per distribuire l'architettura della soluzione. Utilizzando un approccio Infrastructure-as-Code (IaC), consentono che le definizioni delle risorse del template e le impostazioni di configurazione siano gestite con il controllo versione (proprio come il codice sorgente dell'app) - creando flussi di lavoro riutilizzabili e coerenti tra gli utilizzatori di quel progetto.

Quando crei o riutilizzi un template AZD per il tuo scenario, considera queste domande:

  1. Cosa stai costruendo? → Esiste un template che ha codice iniziale per quello scenario?
  2. Come è progettata la tua soluzione? → Esiste un template che dispone delle risorse necessarie?
  3. Come viene distribuita la tua soluzione? → Pensa a azd deploy con hook di pre/post-processing!
  4. Come puoi ottimizzarla ulteriormente? → Pensa al monitoraggio integrato e alle pipeline di automazione!

🎯 | ESERCIZIO:
Visita la galleria Awesome AZD e usa i filtri per esplorare i 250+ template attualmente disponibili. Vedi se riesci a trovare uno che si allinei ai requisiti del tuo scenario.

Codice

4. Template per applicazioni AI

Per le applicazioni alimentate dall'AI, Microsoft fornisce template specializzati che includono Microsoft Foundry e Foundry Agents. Questi template accelerano il tuo percorso verso la costruzione di applicazioni intelligenti e pronte per la produzione.

Template Microsoft Foundry & Foundry Agents

Seleziona un template qui sotto da distribuire. Ogni template è disponibile su Awesome AZD e può essere inizializzato con un singolo comando.

ModelloDescrizioneComando di distribuzione
AI Chat with RAGApplicazione di chat con Retrieval Augmented Generation usando Microsoft Foundryazd init -t azure-samples/azure-search-openai-demo
Foundry Agent Service StarterCostruisci agenti AI con Foundry Agents per l'esecuzione autonoma di attivitàazd init -t azure-samples/foundry-agent-service-starter
Multi-Agent OrchestrationCoordina più Foundry Agents per flussi di lavoro complessiazd init -t azure-samples/multi-agent-orchestration
AI Document IntelligenceEstrai e analizza documenti con i modelli Microsoft Foundryazd init -t azure-samples/ai-document-processing
Conversational AI BotCrea chatbot intelligenti con integrazione Microsoft Foundryazd init -t azure-samples/ai-chat-protocol
AI Image GenerationGenera immagini usando DALL-E tramite Microsoft Foundryazd init -t azure-samples/ai-image-generation
Semantic Kernel AgentAgenti AI che utilizzano Semantic Kernel con Foundry Agentsazd init -t azure-samples/semantic-kernel-agent
AutoGen Multi-AgentSistemi multi-agente che utilizzano il framework AutoGenazd init -t azure-samples/autogen-multi-agent

Avvio rapido

  1. Sfoglia i template: Visita https://azure.github.io/awesome-azd/ e filtra per AI, Agents, o Microsoft Foundry
  2. Seleziona il tuo template: Scegline uno che corrisponda al tuo caso d'uso
  3. Inizializza: Esegui il comando azd init per il template scelto
  4. Distribuisci: Esegui azd up per provisionare e distribuire

🎯 | ESERCIZIO:
Seleziona uno dei template sopra in base al tuo scenario:

  • Stai costruendo un chatbot? → Inizia con AI Chat with RAG o Conversational AI Bot
  • Hai bisogno di agenti autonomi? → Prova Foundry Agent Service Starter o Multi-Agent Orchestration
  • Elaborazione di documenti? → Usa AI Document Intelligence
  • Vuoi assistenza per il coding AI? → Esplora Semantic Kernel Agent o AutoGen Multi-Agent
azd init -t azure-samples/azure-search-openai-demo
azd up

!!! info "Esplora altri template" La galleria Awesome AZD contiene oltre 250 template. Usa i filtri per trovare template che corrispondono ai tuoi requisiti specifici per linguaggio, framework e servizi Azure.

Dichiarazione di non responsabilità: Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Pur impegnandoci per l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un traduttore umano. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.