ANML: il nuovo linguaggio che stravolge il web per gli AI Agent

Il Web ha un problema di pubblico

Per trent'anni l'HTML ha risolto un'esigenza precisa: far arrivare le informazioni agli occhi delle persone. Tabelle, paragrafi, immagini e form erano pensati per essere letti e interpretati da esseri umani. Un approccio semplice, ma efficace.

Oggi però sta cambiando tutto. I principali fruitori dei contenuti web non sono più solo le persone. Sono gli agenti autonomi, sistemi di intelligenza artificiale che analizzano dati, prendono decisioni e agiscono di conseguenza. E qui arriva il problema: l'HTML non è stato progettato per loro.

Quando un agente si imbatte in una pagina classica, deve:

• Decifrare una struttura visiva che non ha senso logico per una macchina
• Indovinare cosa sia importante attraverso calcoli probabilistici
• Ricostruire i flussi di lavoro smontando form e pulsanti
• Fare supposizioni su privacy, consenso e autorizzazioni

Ogni supposizione aggiunge rischio. Ogni inferenza ha un costo.

Il linguaggio che parla la lingua degli agenti

Qui entra in scena ANML, Agentic Notation Markup Language. La Fondazione ANML usa un'immagine semplice ma potente: un'anatra che scivola sull'acqua. Sopra la superficie sembra tutto facile. Sotto, invece, lavora un sistema complesso e coordinato.

Un documento ANML — chiamato "duckument" — funziona allo stesso modo. Per un essere umano è leggibile e pulito. Per un agente autonomo contiene tutto ciò che serve:

• Capacità del servizio esplicitate, non da dedurre
• Vincoli leggibili dalle macchine, non sperati
• Scambio di conoscenza strutturato, non dati grezzi
• Confini di privacy chiari, non documenti ignorati

ANML non toglie niente alla leggibilità umana. La rafforza.

Architettura pensata per le macchine, ma utile nella realtà

Le API tradizionali mettono gli agenti in difficoltà. Devono ridurre al minimo le inferenze e ottenere risultati prevedibili. ANML aiuta proprio in questo.

Un servizio di biglietti per concerti, ad esempio, non lascia all'agente il compito di scoprire lo sconto early-bird. Lo dichiara in modo chiaro, con tempi, limiti e condizioni. In questo modo l'agente agisce con certezza, non con猜测.

Allo stesso tempo, ANML incorpora il principio "privacy by design". I vincoli di disclosure e le regole di consent sono parte della struttura stessa. Gli agenti li valutano e li rispettano. Gli utenti restano in controllo.

Due formati, un solo documento

ANML non è legato a un formato solo. Supporta sia XML che JSON.

XML è ideale per chi deve leggere e scrivere il documento direttamente. È più verboso, ma la sua struttura è chiara e auto-documentata.

JSON è perfetto per la generazione automatica e per il consumo da parte degli agenti. Il backend lo produce, gli agenti lo consumano, le pipeline CI/CD lo validano.

Entrambi i formati sono ugualmente validi. Non c'è una traduzione necessaria.

Cosa contiene un duckument

Un documento ANML descrive un servizio per gli agenti. Ha cinque elementi chiave:

Information: Dati strutturati e semantici che non richiedono interpretazione. Non "click here to buy", ma prezzi, disponibilità e condizioni dichiarati in modo esplicito.

Interactions: Operazioni con binding esplicito a metodi HTTP, endpoint e parametri richiesti. Gli agenti sanno esattamente cosa fare.

Knowledge: Scambio bidirezionale di informazioni. Il servizio indica sia cosa conosce che cosa vuole ricevere dall'agente.

Constraints: Regeln che gli agenti devono seguire. Limiti di disclosure, requisiti di consent e gates di autorizzazione. Questi sono valutati direttamente dalle macchine.

State: Metadati che mostrano lo stadio del workflow. Agenti comprendendo se sono al primo passo di tre, quali decisioni hanno preso e quale è il prossimo passo.

Persona: Guida comportamentale e tonale per gli agenti. Aift ihnen, la voce del brand e il pattern di interazione appropriato.

Perché interessa il tuo stack

Se stai costruendo servizi che in futuro saranno interagiti da agenti — e la statistica dice che è likely — ANML rappresenta un'evoluzione importante.

Oggi la maggior parte dei servizi non è pensata per gli agenti. È stata progettata per developers umani. Quando gli agenti cercano di interagire, cercano di indovinare. È come usare un telefono con i guanti.

ANML è l'alternative. Ti permette di designare servizi che gli agenti capiscono in modo nativo.

Per te, come developer, significa:

• Affidabilità migliore quando gli agenti esterni interact con i tuoi servizi
• Specifiche API più chiare, sia per umani che per macchine
• Privacy che si può enforcement
• Riduzione del overhead di inferenza per le AI che lavorano con i tuoi dati

Il quadro più grande

Il web sta emergendo come "agentic web" — una layer parallela ottimier per autonome Systeme, come il current web è ottimier per Humans.

HTML non è scomparso quando i frameworks JavaScript arrivando. È evoluto. HTTP non è sparito quando REST diventò dominante — coesistono.

ANML non è sostitutivo di HTML. È una nuova layer di abstraction per l'interaktion fra services e agents.

La question non è se adottare ANML oggi. È se essere ready quando agents i servizi consume, transazioni fanno e workflows execute.

Il duck si sta gliding sul tuo surface. Assicurati di capire il underneath.