ANP-protokolla: hajautettu agenttiverkosto did:wba-identiteetillä

Mistä ANP:ssä on kyse

Agent Network Protocol (ANP) on hajautettu agenttiverkoston standardi joka mahdollistaa agenttien yhteistyön yli organisaatiorajojen ilman keskitettyjä välittäjiä tai rekistereitä. ANP-spesifikaation pohja on W3C DID (Decentralized Identifiers), JSON-LD ja kryptografisesti allekirjoitetut viestit.

ANP eroaa keskitetystä A2A:sta yhdellä periaatekysymyksellä: kumpikin agentti voi löytää, tunnistaa ja kommunikoida toisensa kanssa ilman että ne ovat samassa keskitetyssä rekisterissä. Käytännössä jokainen agentti julkaisee oman identiteettinsä DID-dokumentissa omalla verkkotunnuksellaan, ja toiset agentit voivat verifioida sen suoraan.

did:wba: yksinkertaisin tapa julkaista agentti

ANP:n suosima DID-metodi on did:wba (DID web-based agent). Idea on yksinkertainen: agentin DID-dokumentti julkaistaan agentin oman verkkotunnuksen alla osoitteessa /.well-known/did.json.

Esimerkiksi:

did:wba:tekoalydani.com → https://tekoalydani.com/.well-known/did.json

DID-dokumentti sisältää:

• Julkisen avaimen (Ed25519-suositus) viestien verifiointiin
• Viittauksen agentin self-description-tiedostoon
• Listan tuetuista palvelu-endpointeista (MCP, A2A, ACP)

Etu W3C DID -spesifikaatioon nähden: did:wba on yksinkertainen ottaa käyttöön (vain HTTPS ja kelvollinen JSON-LD), eikä vaadi blockchain-pohjaista verifiointia. Haitta: identiteetti on yhtä luotettava kuin domain ja sen TLS-sertifikaatti.

JSON-LD self-description: agentin semanttinen kuvaus

ANP-agentit julkaisevat itsestään semanttisesti rikkaan kuvauksen JSON-LD-formaatissa. Kuvauksessa kerrotaan:

• Agentin nimi ja kuvaus
• Tuetut kyvykkyydet (capability)
• Tuetut protokollat (MCP, A2A, ACP, UCP, AP2)
• Kontaktitiedot (sähköposti, yhteydenottolomake)
• Palvelu-endpointit URL-muodossa

Schema-pohjana käytetään tyypillisesti schema.org laajennettuna ANP-spesifeillä luokilla. Tämä tarkoittaa että self-description on samalla AEO-yhteensopiva: Google AI Overview ja Perplexity voivat lukea sen ja käyttää tietoja vastauksissaan.

Allekirjoitetut viestit: päästä päähän verifioitavissa

Kun ANP-agentti lähettää viestin toiselle ANP-agentille, viesti allekirjoitetaan kryptografisesti (EdDSA-suositus). Vastaanottaja:

1. Resolvoi lähettäjän DID (esim. did:wba:kuljetus.fi → https://kuljetus.fi/.well-known/did.json)
2. Hakee julkisen avaimen DID-dokumentista
3. Verifioi viestin allekirjoituksen julkisella avaimella

Allekirjoitus toimii päästä päähän ilman välittäjiä. Tämä tarkoittaa että vaikka viesti kulkisi ASF-/queue-/proxy-järjestelmien läpi, vastaanottaja voi olla varma että viesti tulee nimenomaan oikealta lähettäjältä eikä keksitty.

Milloin ANP on järkevämpi kuin A2A

Kolme tilannetta jolloin ANP voittaa keskitetyn A2A:n:

B2B-supply-chain. Kauppa ja kuljetusyhtiö eivät kuulu samaan keskitettyyn agenttirekisteriin. ANP-pohjaisessa skenaariossa kauppa luottaa kuljetusyhtiön domainiin ja TLS-sertifikaattiin, ja allekirjoitettu tilausvahvistus kulkee suoraan agenttien välillä ilman että kummankin pitää rekisteröityä samaan A2A-routeriin.

Hajautettu marketplace. Marketplace ei pakota kaikkia osallistujia samaan A2A-routeriin. ANP-verkostossa myyjät julkaisevat self-descriptionin omilla domaineillaan, ja ostaja-agentti voi hakea sopivia myyjiä semanttisten kyvykkyysten perusteella. Marketplace on virtuaalinen, ei keskitetty palvelu.

Julkishallinto. Suomi.fi-pohjainen identiteetti voidaan kytkeä did:wba:hen ja viranomaisagentit voivat allekirjoittaa viestinsä tunnistetusti. Ei keskitettyä agenttirekisteriä, mutta päästä päähän verifioitavissa.

ANP yhdessä muiden protokollien kanssa

ANP on identiteetti- ja löydettävyys-kerros, ei viestintä- tai työkalu-kerros. Käytännössä:

• ANP löytää ja autentikoi agentin (vastaa kysymykseen "kuka tämä on?")
• A2A tai MCP hoitaa varsinaisen viestinnän työkalujen ja tehtävien tasolla
• UCP, ACP, AP2 hoitavat kaupankäynnin yksityiskohdat kun maksu on ajankohtainen

Self-description voi sisältää viittaukset kaikkiin näihin: mcp_endpoint: https://..., a2a_endpoint: https://..., acp_supported: true. Agentti saa yhdellä lookupilla tietoonsa missä muut palvelut sijaitsevat.

Suomalaisen verkkokaupan ANP-stack

Käytännön toteutus suomalaiseen verkkokauppaan vie tyypillisesti seuraavat askeleet:

1. Avainparin generointi Ed25519-algoritmilla. Yksityinen avain talteen turvallisesti (HSM tai vähintään KMS).
2. DID-dokumentin luonti ja julkaisu osoitteessa https://kauppasi.fi/.well-known/did.json.
3. JSON-LD self-description osoitteessa https://kauppasi.fi/.well-known/agent-description.jsonld. Schema.org laajennettuna ANP-luokilla.
4. Viestiallekirjoituksen kytkentä kaikkiin ulospäin lähteviin agenttiviesteihin (MCP, A2A, ACP, UCP).
5. Verifiointilogiikka sisääntuleville agenttiviesteille: resolvoi DID, hae avain, verifioi allekirjoitus.

Tekoäly-Dani toteuttaa nämä osana laajempaa agenttivalmius-projektia. ANP rakennetaan MCP- ja A2A-toteutusten päälle, ei sijaan: hajautettu identiteetti ja löydettävyys täydentää muita protokollia.

Yhteenveto

ANP ratkaisee löydettävyysongelman tilanteessa jossa agentit kuuluvat eri organisaatioihin tai järjestelmiin. did:wba antaa kryptografisen identiteetin yksinkertaisella tavalla, JSON-LD self-description kuvaa kyvykkyydet, ja allekirjoitetut viestit takaavat että tunnistetun lähettäjän viesti ei ole väärennettyjä.

Useimmissa tavanomaisissa verkkokauppa- ja SaaS-tilanteissa A2A riittää. ANP on lisäkerros kun kyseessä on aito hajautettu skenaario: B2B-supply-chain, hajautetut marketplacet, julkishallinto. Suomalainen verkkokauppa voi liittyä ANP-verkkoon kun haluaa kommunikoida agenttien välillä myös ilman keskitettyä rekisteriä.

Aloita keskustelu omasta tilanteestasi yhteydenotolla tai pyydä AAIO Audit (990 €, sisältää AEO Auditin), joka kartoittaa kuinka pitkällä kauppasi on agenttivalmiudessa.