ANML tar över webben – bortom HTML och AI-agenter

Webben har ett agentproblem

HTML har i trettio år handlat om att visa information för människor. Tabeller, texter, bilder och formulär är optimerade för att vi ska kunna läsa och fatta beslut. Det är enkelt och effektivt – så länge mottagaren är en människa.

Men läget håller på att ändras. Allt fler interaktioner på webben sker inte mellan människor, utan mellan tjänster och autonoma agenter. AI-system som tolkar data, fattar beslut och utför åtgärder. Problemet är att vanlig HTML inte är byggd för dem.

En agent som möter en vanlig webbsida måste gissa sig fram. Den behöver tolka visuella ledtrådar, räkna ut vad som är viktigt och försöda förstå arbetsflöden genom att analysera formulär. Varje gissning kostar tid och ökar risken för fel.

Där kommer ANML in – Agentic Notation Markup Language.

En and som förklarar konceptet

ANML Foundation använder en enkel bild: en and som glider över vattnet. På ytan ser det ut som om ingenting händer. Under ytan arbetar ett helt system av rörelser och samordning.

Så fungerar en ANML-dokumentation – eller "duckument" som de kallar det. För en människa ser den ut som en vanlig text. Men för en agent innehåller den allt som behövs:

• Tydligt deklarerade funktioner i stället för gissade arbetsflöden
• Maskinläsbara begränsningar i stället för policydokument
• Strukturerad kunskapsutbyte i stället för lösa data
• Inbyggda integritetsgränser som agenten måste följa

ANML tar inte bort läsbarheten för människor. Den lägger bara till ett lager som maskiner förstår.

Från minimerad gissning till tydlig struktur

Många API:er är inte byggda för agenter. De kräver att AI-systemet ska tolka och gissa. ANML ändrar det genom att göra avsikten explicit.

En biljettservice behöver inte låta agenten räkna ut att det finns en tidig rabatt. Den deklarerar rabatten direkt – med villkor, tidpunkt och begränsningar. Det minskar både fördröjning och felmarginal.

Samtidigt ger ANML en struktur som gör beteendet förutsägbart. Agenten behöver inte tolka vad du "troligen" menar. Den får veta exakt vad du menar. Och eftersom integritet är inbyggt, kan tjänsten styra vad agenten får se och vad den får dela.

XML och JSON – två sidor av samma sak

ANML använder både XML och JSON, men inte som två olika versioner. Båda formaten är lika giltiga.

XML passar bäst när en utvecklare ska läsa eller skriva dokumentet direkt. Det är mer ordrikt, men strukturen talar för sig själv.

JSON används när systemet ska generera eller ta emot data. Backend genererar det, agenter läser det och pipelines kontrollerar det.

Det betyder att du inte behöver välja mellan läsbarhet och automatisering. Du får båda.

Vad innehåller en ANML-dokumentation?

En ANML-dokumentation beskriver hur en agent ska interagera med en tjänst. Den täcker fem huvudområden:

• Information: Data som är tydligt strukturerad och inte kräver tolkning. Priser, villkor och tidsbegränsningar är deklarerade direkt.
• Interaktioner: Operationer med koppling till HTTP-metoder, endpoints och parametrar. Agenten vet exakt hur att göra utan att gissa.
• Kunskap: Bidirektionell utbyte. Tjänsten anger vad den behöver veta från agentens användare, simultaneously as the agent receives clear information from the service.
• Begränsningar: Regler som agenten måste följa. Integritetsgränser, samtycke och tillåtna åtgärder.
• Tillstånd: Metadata som visar var agenten är i ett arbetsflöde. Första steg, andra steg – och vad som kommer nästa.
• Persona: Riktlinjer för hur agenten ska bete sig och representera tjänsten. Det är inte bindande, men helps the agent maintain brand tone.

Vad betyder det för din tekniska stack?

Om du byggar tjänster som agenter kommer att använda – och det lär du dig till att göra – är ANML en förändring i hur du tänker på API-design.

De flesta tjänster är stilla built for human developers. När agenter försöker använda dem, försöder de att gissa sig fram. Det fungerar ibland, men det är not optimal.

ANML är ett alternativ. Det står för tjänster som agenter förstår direkt, med explicit struktur, inbyggd integritet och klar arbetsflöde.

För dig som utvecklare betyder det att:

• Agentsammanhang är more reliable
• API-specifikationer blir clearer för både människor och maskiner
• Integritet kan faktiskt enforced
• Minskad tolkningstid för AI-system som arbetar med din data

Vad händer på längre sikt?

Vi ser början på en "agentic web" – en parallell lager på internet som är optimerad för autonoma system, mycket likt hur den nuvarande webben är optimerad för människor.

HTML gjorde inte försvinner när REST-API:er kom. Det evoluerade. HTTP blev inte borttaget. ANML är not ersättning för HTML. Det är en ny abstraktionslager som är specifikt byggd för agentinteraktioner.

Du behöver inte adopt ANML nu. Men när agenter blir normal sättet att consume din data, make transactions och execute workflows – då är det viktig att vara klar.

Anden glider över ytan. Du måste förstå vad händer under ytan.

Hur du börjar

If you think about agent-first architecture, API-design eller tjänster som spieler med autonoma system – då är det tidpunkt att se ANML Foundation's specification.

The shift from human-first to agent-capable architecture is just beginning. Att vara en early adopter puts you ahead of the curve, especially in fintech, e-commerce, SaaS platforms eller any domain where multi-step workflows and privacy-respecting automation matter.

Framtidens API:er handlar inte bara om REST-endpoints och documentation. Det handlar om explicit, machine-executable instructions that respect both user autonomy and service boundaries.

Duckuments är på väg. Är din klar?