Azd | The .NET Blog

Hooks d'azd en Python, TypeScript i .NET: adéu als scripts de shell

Emiliano Montesdeoca — Thu, 23 Apr 2026 00:00:00 +0000

Aquesta publicació ha estat traduïda automàticament. Per a la versió original, feu clic aquí.

Si alguna vegada has tingut un projecte completament en .NET i tot i així has hagut d’escriure scripts Bash per als hooks d’azd, coneixes bé aquell dolor. Per què canviar a sintaxi de shell en un pas de pre-provisioning quan tota la resta del projecte és C#?

Aquesta frustració té ara solució oficial. L’Azure Developer CLI acaba de llançar suport multi-llenguatge per a hooks, i és exactament tan bo com sona.

Hooks, breument

Els hooks són scripts que s’executen en punts clau del cicle de vida d’azd — abans del provisioning, després del desplegament, i més. Es defineixen a azure.yaml i permeten injectar lògica personalitzada sense modificar la CLI.

Abans només s’admetien Bash i PowerShell. Ara pots usar Python, JavaScript, TypeScript o .NET — i azd s’encarrega de la resta automàticament.

Com funciona la detecció

Simplement apuntes el hook a un fitxer i azd infereix el llenguatge per l’extensió:

hooks:
 preprovision:
 run: ./hooks/setup.py
 postdeploy:
 run: ./hooks/seed.ts
 postprovision:
 run: ./hooks/migrate.cs

Sense configuració addicional. Si l’extensió és ambigua, pots afegir kind: python (o el que correspongui) per especificar-ho explícitament.

Detalls importants per llenguatge

Python

Col·loca un requirements.txt o pyproject.toml al costat del script (o en qualsevol directori pare) i azd crea un entorn virtual, instal·la dependències i executa l’script.

JavaScript i TypeScript

El mateix patró — posa un package.json a prop del script i azd executarà npm install primer. Per a TypeScript, usa npx tsx sense pas de compilació ni tsconfig.json.

.NET

Dos modes disponibles:

Mode projecte: Si hi ha un .csproj al costat del script, azd executa dotnet restore i dotnet build automàticament.
Mode single-file: En .NET 10+, pots posar un fitxer .cs independent i s’executa directament amb dotnet run script.cs. Sense fitxer de projecte.

Configuració per executor

Cada llenguatge admet un bloc config opcional:

hooks:
 preprovision:
 run: ./hooks/setup.ts
 config:
 packageManager: pnpm
 postprovision:
 run: ./hooks/migrate.cs
 config:
 configuration: Release
 framework: net10.0

Per què importa per a desenvolupadors .NET

Els hooks eren l’últim lloc d’un projecte basat en azd que t’obligava a usar un altre llenguatge. Ara tot el pipeline de desplegament pot viure en un sol llenguatge. Pots reutilitzar les teves utilitats .NET existents als hooks, referenciar llibreries compartides i evitar el manteniment de scripts de shell.

Conclusió

És un d’aquells canvis que semblen petits però que eliminen molta fricció del dia a dia amb azd. El suport multi-llenguatge per a hooks ja està disponible — consulta el post oficial per a la documentació completa.

azd + GitHub Copilot: Configuració de projecte amb IA i resolució intel·ligent d'errors

Emiliano Montesdeoca — Tue, 21 Apr 2026 00:00:00 +0000

Aquest article ha estat traduït automàticament. Per veure la versió original en anglès, fes clic aquí.

Coneixes aquell moment en què vols desplegar una aplicació existent a Azure i et quedes mirant un azure.yaml en blanc, intentant recordar si la teva API Express hauria d’usar Container Apps o App Service? Aquell moment acaba de ser molt més curt.

L’Azure Developer CLI (azd) ara s’integra amb GitHub Copilot de dues maneres concretes: scaffolding assistit per IA durant azd init, i resolució intel·ligent d’errors quan els desplegaments fallen. Les dues funcions es queden completament al terminal — exactament on vull que siguin.

Configuració amb Copilot durant azd init

Quan executes azd init, ara apareix l’opció “Set up with GitHub Copilot (Preview)”. Selecciona-la i Copilot analitza el teu codebase per generar l’azure.yaml, les plantilles d’infraestructura i els mòduls Bicep — basant-se en el teu codi real.

azd init
# Selecciona: "Set up with GitHub Copilot (Preview)"

Requisits:

azd 1.23.11 o superior — comprova amb azd version o actualitza amb azd update
Una subscripció activa de GitHub Copilot (Individual, Business o Enterprise)
GitHub CLI (gh) — azd demanarà login si cal

El que trobo genuïnament útil és que funciona en els dos sentits. Construint des de zero? Copilot t’ajuda a configurar els serveis Azure correctes des del principi. Tens una app existent que vols desplegar? Apunta Copilot cap a ella i genera la configuració sense haver de reestructurar res.

El que fa realment

Imagina que tens una API Express en Node.js amb dependència de PostgreSQL. En lloc de decidir manualment entre Container Apps i App Service, i després escriure Bicep des de zero, Copilot detecta el teu stack i genera:

Un azure.yaml amb els ajustaments correctes de language, host i build
Un mòdul Bicep per a Azure Container Apps
Un mòdul Bicep per a Azure Database for PostgreSQL

I fa comprovacions prèvies abans de tocar res — verifica que el teu directori git estigui net, demana consentiment per a les eines del servidor MCP. Res no passa sense que sàpigues exactament què canviarà.

Resolució d’errors amb Copilot

Els errors de desplegament són inevitables. Paràmetres que falten, problemes de permisos, disponibilitat de SKUs — i el missatge d’error rarament et diu l’única cosa que realment necessites saber: com solucionar-ho.

Sense Copilot, el cicle és: copiar l’error → buscar als docs → llegir tres respostes irrellevants de Stack Overflow → executar alguns comandos az CLI → tornar-ho a intentar i rezar. Amb Copilot integrat a azd, aquest cicle s’esfondra. Quan qualsevol comandament azd falla, ofereix immediatament quatre opcions:

Explain — descripció en llenguatge natural del que ha anat malament
Guidance — instruccions pas a pas per solucionar-ho
Diagnose and Guide — anàlisi completa + Copilot aplica la solució (amb la teva aprovació) + reintent opcional
Skip — gestionar-ho tu mateix

El punt clau: Copilot ja té context sobre el teu projecte, el comandament que ha fallat i la sortida de l’error. Les seves suggerències són específiques per a la teva situació.

Configurar un comportament predeterminat

Si sempre tries la mateixa opció, salta el prompt interactiu:

azd config set copilot.errorHandling.category troubleshoot

Valors: explain, guidance, troubleshoot, fix, skip. També pots habilitar auto-fix i reintent:

azd config set copilot.errorHandling.fix allow

Torna al mode interactiu en qualsevol moment:

azd config unset copilot.errorHandling.category

Conclusió

Executa azd update per obtenir la versió més recent i usa azd init en el teu proper projecte. És exactament el tipus d’integració de Copilot que aporta valor real.

Llegeix l’anunci original aquí.

azd update: una comanda per controlar tots els vostres gestors de paquets

Emiliano Montesdeoca — Wed, 15 Apr 2026 00:00:00 +0000

Sabeu que el missatge “Hi ha una versió nova d’azd disponible” que apareix cada poques setmanes? El que descarteu perquè no recordeu si vau instal·lar azd mitjançant winget, Homebrew o aquell script curl que vau executar fa sis mesos? Sí, finalment s’ha arreglat.

Microsoft acaba d’enviar azd update: una ordre única que actualitza l’Azure Developer CLI a la darrera versió, independentment de com l’haveu instal·lat originalment. Windows, macOS, Linux, no importa. Una ordre.

Com funciona

azd update

Això és tot. Si voleu un accés anticipat a noves funcions, podeu canviar a la creació diària d’insiders:

azd update --channel daily
azd update --channel stable

L’ordre detecta el vostre mètode d’instal·lació actual i utilitza el mecanisme d’actualització adequat sota el capó. No més “espera, he fet servir winget o choco en aquesta màquina?”

La petita captura

azd update s’envia a partir de la versió 1.23.x. Si teniu una versió anterior, haureu de fer una darrera actualització manual mitjançant el vostre mètode d’instal·lació original. Després d’això, azd update s’encarrega de tot el futur.

Comproveu la vostra versió actual amb azd version. Si necessiteu una instal·lació nova, els documents d’instal·lació us cobreixen.

Per què és important

Aquesta és una petita millora de la qualitat de vida, però per a aquells de nosaltres que utilitzem azd diàriament per desplegar agents d’IA i aplicacions Aspire a Azure, mantenir-se al dia significa menys moments “aquest error ja s’ha solucionat a la darrera versió”. Una cosa menys per pensar.

Llegiu l’anunci complet i la immersió més profunda de Jon Gallant per a més context.

azd ara us permet executar i depurar agents d'IA localment: aquí teniu el que va canviar el març de 2026

Emiliano Montesdeoca — Thu, 02 Apr 2026 00:00:00 +0000

Set llançaments en un mes. Això és el que va impulsar l’equip de l’Azure Developer CLI (azd) el març de 2026, i la funció de titular és la que estava esperant: un bucle local d’execució i depuració per als agents d’IA.

PC Chan va publicar el resum complet i, tot i que hi ha moltes coses, permeteu-me filtrar-ho fins al que realment importa per als desenvolupadors de.NET que creen aplicacions basades en IA.

Executeu i depureu agents d’IA sense desplegar-los

Aquest és el gran. La nova extensió azure.ai.agents afegeix un conjunt d’ordres que us ofereixen una experiència de bucle interior adequada per als agents d’IA:

azd ai agent run: inicia el vostre agent localment
azd ai agent invoke: li envia missatges (locals o desplegats)
azd ai agent show: mostra l’estat i la salut del contenidor
azd ai agent monitor: transmet els registres dels contenidors en temps real

Abans d’això, provar un agent d’IA significava desplegar-lo a Microsoft Foundry cada vegada que feies un canvi. Ara podeu iterar localment, provar el comportament del vostre agent i només implementar-lo quan estigueu preparat. Si heu estat creant agents amb Microsoft Agent Framework o Semantic Kernel, això canvia el vostre flux de treball diari.

L’ordre d’invocació funciona amb agents locals i desplegats, la qual cosa significa que podeu utilitzar el mateix flux de treball de prova independentment d’on s’executi l’agent. Aquest és el tipus de detall que us estalvia mantenir dos conjunts de scripts de prova.

GitHub Copilot arma el vostre projecte azd

azd init ara ofereix una opció “Configura amb GitHub Copilot (vista prèvia)”. En lloc de respondre manualment les sol·licituds sobre l’estructura del vostre projecte, un agent de Copilot us encarrega la configuració. Comprova si hi ha un directori de treball brut abans de modificar res i demana el consentiment de l’eina del servidor MCP per endavant.

Quan una ordre falla, azd ara ofereix una resolució de problemes assistida per IA: trieu una categoria (explica, orienta, soluciona problemes o salta), deixeu que l’agent suggereixi una solució i torneu-ho a provar, tot sense sortir del terminal. Per a configuracions d’infraestructures complexes, això suposa un estalvi de temps real.

Feines de l’aplicació de contenidors i millores en el desplegament

Algunes funcions de desplegament que cal destacar:

Fines d’aplicacions de contenidors: azd ara desplega Microsoft.App/jobs mitjançant la configuració existent host: containerapp. La vostra plantilla de bíceps determina si l’objectiu és una aplicació de contenidor o una feina, sense cap configuració addicional.
Temps d’espera de desplegament configurables: nova marca --timeout a azd deploy i un camp deployTimeout a azure.yaml. Ja no cal endevinar el límit predeterminat de 1200 segons.
Recurs de compilació remota: quan la compilació remota d’ACR falla, azd torna automàticament a la compilació local de Docker/Podman.
Validació local de preflight: els paràmetres de bíceps es validen localment abans de desplegar-se, capturant els paràmetres que falten sense un viatge d’anada i tornada a Azure.

Polit de l’experiència del desenvolupador

Algunes millores més petites que sumen:

Detecció automàtica de pnpm/fils per a projectes JS/TS
Compatibilitat amb pyproject.toml per a l’embalatge de Python
Directoris de plantilles locals — azd init --template ara accepta camins del sistema de fitxers per a la iteració fora de línia
Millors missatges d’error en mode --no-prompt: tots els valors que falten es reporten alhora amb ordres de resolució
Variables d’entorn de compilació injectades a tots els subprocessos de creació de marcs (.NET, Node.js, Java, Python)

Aquesta última és subtil però important: la vostra compilació.NET ara té accés a les variables d’entorn azd, la qual cosa significa que podeu fer una injecció de configuració en temps de compilació sense scripts addicionals.

Tancant

El bucle de depuració de l’agent d’IA local és l’estrella d’aquesta versió, però l’acumulació de millores en el desplegament i la poliment DX fa que azd se senti més madur que mai. Si esteu desplegant aplicacions.NET a Azure, especialment agents d’IA, aquesta actualització val la pena instal·lar-la.

Comproveu les notes completes de la versió per a cada detall o comenceu amb instal·lació d’azd.

De l'ordinador portàtil a la producció: desplegament d'agents d'IA a Microsoft Foundry amb dues ordres

Emiliano Montesdeoca — Thu, 26 Mar 2026 00:00:00 +0000

Coneixeu aquesta bretxa entre “funciona a la meva màquina” i “està desplegat i atén el trànsit”? Per als agents d’IA, aquesta bretxa ha estat dolorosament àmplia. Heu de subministrar recursos, desplegar models, connectar la identitat, configurar la supervisió, i això és abans que ningú pugui trucar al vostre agent.

L’Azure Developer CLI acaba de convertir-ho en un assumpte de dos comandaments.

El nou flux de treball `azd ai agent`

Permeteu-me explicar com és realment això. Teniu un projecte d’agent d’IA, diguem-ne un agent de consergeria d’hotel. Funciona localment. Voleu que funcioni a Microsoft Foundry.

azd ai agent init
azd up

Això és tot. Dues ordres. azd ai agent init arma la infraestructura com a codi al vostre dipòsit i azd up proveeix tot a Azure i publica el vostre agent. Obteniu un enllaç directe al vostre agent al portal de Foundry.

Què passa sota el capó

L’ordre init genera plantilles de bíceps reals i inspeccionables al vostre repositori:

Un Recurs de Foundry (contenidor de primer nivell)
Un Projecte de Foundry (on viu el vostre agent)
Configuració del model de desplegament (GPT-4o, etc.)
Identitat gestionada amb assignacions de rol RBAC adequades
azure.yaml per al mapa de serveis
agent.yaml amb metadades de l’agent i variables d’entorn

Aquí teniu la part clau: sou el propietari de tot això. Està versionat Bicep al teu repositori. Podeu inspeccionar-lo, personalitzar-lo i confirmar-lo juntament amb el vostre codi d’agent. Sense capses negres màgiques.

El bucle intern del desenvolupament

El que m’agrada molt és la història del desenvolupament local. Quan esteu iterant la lògica de l’agent, no voleu tornar a desplegar cada vegada que canvieu una sol·licitud:

azd ai agent run

Això inicia el vostre agent localment. Vinculeu-lo amb azd ai agent invoke per enviar sol·licituds de prova i teniu un bucle de comentaris ajustat. Edita el codi, reinicia, invoca, repeteix.

L’ordre invoke també és intel·ligent pel que fa a l’encaminament: quan s’executa un agent local, l’orienta automàticament. Quan no ho és, arriba al punt final remot.

Monitorització en temps real

Aquesta és la característica que em va vendre. Un cop desplegat el vostre agent:

azd ai agent monitor --follow

Cada sol·licitud i resposta que flueix pel vostre agent es transmet al vostre terminal en temps real. Per depurar problemes de producció, això és inestimable. Sense investigar l’analítica de registres, sense esperar que les mètriques s’agreguin; veuràs què està passant ara mateix.

El conjunt d’ordres complet

Aquí teniu la referència ràpida:

Comandament	Què fa
`azd ai agent init`	Armar un projecte d’agent de Foundry amb IaC
`azd up`	Proveïu els recursos d’Azure i implementeu l’agent
`azd ai agent invoke`	Envieu sol·licituds a l’agent local o remot
`azd ai agent run`	Executeu l’agent localment per al desenvolupament
`azd ai agent monitor`	Transmet els registres en temps real de l’agent publicat
`azd ai agent show`	Comproveu l’estat i l’estat de l’agent
`azd down`	Netegeu tots els recursos d’Azure

Per què això és important per als desenvolupadors de.NET

Tot i que la mostra de l’anunci està basada en Python, la història de la infraestructura és independent del llenguatge. El vostre agent.NET obté la mateixa bastida Bíceps, la mateixa configuració d’identitat gestionada, la mateixa canalització de monitorització. I si ja esteu utilitzant azd per a les vostres aplicacions.NET Aspire o implementacions d’Azure, això s’adapta perfectament al vostre flux de treball existent.

La bretxa de desplegament dels agents d’IA ha estat un dels punts de fricció més grans de l’ecosistema. Passar d’un prototip de treball a un punt final de producció amb una identitat, una xarxa i un seguiment adequats no hauria de requerir una setmana de treball DevOps. Ara requereix dues ordres i uns minuts.

Tancant

azd ai agent ja està disponible. Si heu postergat la implementació dels vostres agents d’IA perquè la configuració de la infraestructura us semblava massa feina, proveu-ho. Fes una ullada a la tutorial completa per veure el pas a pas complet, inclosa la integració de l’aplicació de xat frontal.

Azd | The .NET Blog

Hooks d'azd en Python, TypeScript i .NET: adéu als scripts de shell

Hooks, breument

Com funciona la detecció

Detalls importants per llenguatge

Python

JavaScript i TypeScript

.NET

Configuració per executor

Per què importa per a desenvolupadors .NET

Conclusió

azd + GitHub Copilot: Configuració de projecte amb IA i resolució intel·ligent d'errors

Configuració amb Copilot durant azd init

El que fa realment

Resolució d’errors amb Copilot

Configurar un comportament predeterminat

Conclusió

azd update: una comanda per controlar tots els vostres gestors de paquets

Com funciona

La petita captura

Per què és important

azd ara us permet executar i depurar agents d'IA localment: aquí teniu el que va canviar el març de 2026

Executeu i depureu agents d’IA sense desplegar-los

GitHub Copilot arma el vostre projecte azd

Feines de l’aplicació de contenidors i millores en el desplegament

Polit de l’experiència del desenvolupador

Tancant

De l'ordinador portàtil a la producció: desplegament d'agents d'IA a Microsoft Foundry amb dues ordres

El nou flux de treball azd ai agent

Què passa sota el capó

El bucle intern del desenvolupament

Monitorització en temps real

El conjunt d’ordres complet

Per què això és important per als desenvolupadors de.NET

Tancant

El nou flux de treball `azd ai agent`