Come insegnare a un assistente AI a comprendere Azure come un Solutions Architect
Recentemente mi sono ritrovato a pensare: ci siamo abituati al fatto che GitHub Copilot o Claude Code sappiano quasi tutto, ma non appena si tratta di specificità cloud, iniziano le allucinazioni. La rete neurale potrebbe fornirvi una configurazione di Azure Functions che è obsoleta da circa tre anni, oppure suggerire un'architettura che viola i limiti integrati della sottoscrizione. Il problema è che la conoscenza del modello è limitata al momento del suo addestramento, e la documentazione di Microsoft Learn cambia quasi quotidianamente.
Mi sono imbattuto nel repository Agent-Skills dei ragazzi di Microsoft. L'idea è semplice ma incredibilmente utile: invece di far "ricordare" la documentazione all'AI, le fornite competenze strutturate. È come una guida di riferimento per l'agente che risiede direttamente nel vostro progetto e gli dice: "Quando lavorate con Azure, guardate qui, usate questi pattern, e non dimenticate questi limiti."
Cos'è in pratica
Il progetto è un enorme catalogo di quasi duecento competenze pronte all'uso per lavorare con Azure. Non sono solo link alla documentazione. Ogni competenza è un insieme di istruzioni in formato Markdown che l'assistente AI legge prima di suggerirvi del codice.
Gli sviluppatori di Microsoft hanno optato per l'approccio "documentazione come codice". Hanno preso una montagna di contenuti da Microsoft Learn — best practice, alberi decisionali, errori comuni e requisiti di sicurezza — e li hanno impacchettati in istruzioni compatibili con gli LLM. Di conseguenza, l'agente non si limita a scrivere codice; comprende il contesto del servizio specifico.
Perché preoccuparsi di aggiungere questo al vostro progetto
Se lavorate con Azure, sapete quanti sono i dettagli sfumati. Ad esempio, potete configurare Azure Container Apps in una dozzina di modi, ma solo un paio di questi soddisferanno gli standard Enterprise.
Ecco cosa vi offrono queste competenze nella pratica:
- L'agente smette di indovinare e inizia a usare i pattern API attuali.
- Le risposte includono link diretti alle sezioni rilevanti di Microsoft Learn.
- L'AI inizia ad avvisarvi sui limiti e sulle particolarità di configurazione prima che distribuite una configurazione errata.
- L'agente ottiene checklist pronte all'uso per la risoluzione dei problemi.
Come funziona internamente
Al suo centro c'è uno standard aperto per Agent Skills. Ogni competenza risiede nella propria cartella all'interno della directory skills/. La struttura dei file SKILL.md è qualcosa del genere:
---
name: azure-functions
description: Инструкции по разработке и развертыванию Azure Functions
---
# Azure Functions
## Инструкции
[Тут идут конкретные шаги для агента]
## Примеры
[Примеры правильного использования сервиса]
Interessante, il sistema funziona secondo un principio di rivelazione progressiva. Per prima cosa, l'agente vede solo il nome e la breve descrizione nell'header YAML. Se la vostra richiesta corrisponde all'argomento della competenza, l'agente "srotola" l'istruzione completa e inizia ad agire di conseguenza. Questo risparmia la finestra di contesto del modello senza appesantirla con elementi non necessari.
Come far funzionare questa cosa
Il modo più semplice è installare tutto come plugin. Per VS Code, lo fate attraverso la tavolozza dei comandi: selezionate Chat: Install Plugin From Source e incollate il link del repository https://github.com/MicrosoftDocs/agent-skills.
Se preferite il pieno controllo o usate Cursor, potete semplicemente clonare il repository e copiare le cartelle necessarie da skills/ alla directory del vostro progetto. Il percorso varia per ogni strumento:
- GitHub Copilot:
.github/skills/ - Cursor:
.cursor/skills/ - Claude Code:
.claude/skills/
A proposito, per VS Code dovete ricordarvi di abilitare l'impostazione chat.agent.skills, altrimenti la magia non accadrà.
Vantaggi pratici e categorie
Il repository attualmente ha 193 competenze. Sono suddivise per categoria, quindi non dovete portarvi dietro tutto — potete scegliere solo ciò che vi serve per il vostro stack specifico:
- Compute (13 competenze): App Service, Functions, Batch.
- AI & ML (23 competenze): tutto su Azure AI Services e i bot.
- Security (19 competenze): Active Directory, Key Vault e altro.
- Infrastructure (52 competenze): qui c'è roba seria — AKS, Arc e configurazioni di rete.
Se non sapete da dove cominciare, la cartella docs/BUNDLES.md ha raccolte curate. Ad esempio, il bundle "Quick Start" include 7 servizi di base che saranno utili a qualsiasi sviluppatore Azure.
Vale la pena provare
Il progetto sembra un ottimo modo per "ancorare" gli assistenti AI ai task reali. Invece di copiare-incollare snippet di documentazione nella chat di Copilot ogni volta, connettete il repository una volta e ottenete un assistente competente che conosce le regole del gioco nell'ecosistema Microsoft.
Questo sarà particolarmente utile per i team che stanno migrando ad Azure o che iniziano a usare servizi complessi come Durable Functions o Azure API Management. È facile configurarli male, e correggerli dopo è dispendioso in termini di tempo e costoso.
L'unico svantaggio è che il progetto è ancora in preview, e alcune funzionalità richiedono l'abilitazione di flag sperimentali nell'IDE. Ma anche in modalità manuale, copiare i file .md necessari nel vostro progetto dà un miglioramento evidente nella qualità della generazione del codice. Se siete fortemente investiti in Azure, questo repository merita sicuramente un posto nei vostri segnalibri.
Progetti correlati