---
title: "ANP-protokolla: hajautettu agenttiverkosto did:wba-identiteetillä | Tekoäly-Dani Daily"
canonical_url: "https://tekoalydani.com/daily/anp-agent-network-protocol-hajautettu-agenttiverkosto/"
summary: "Agent Network Protocol (ANP) on hajautettu standardi agenttien yhteistyölle yli organisaatiorajojen. W3C DID -pohjainen identiteetti, JSON-LD self-description ja allekirjoitetut viestit. Milloin ANP on järkevämpi kuin keskitetty A2A."
generated: "2026-10-05"
source_format: text/html
---

[Daily Report](https://tekoalydani.com/daily/)

Opas 23. toukokuuta 2026 8 min lukuaika

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

Agent Network Protocol (ANP) on hajautettu standardi agenttien yhteistyölle yli organisaatiorajojen. W3C DID -pohjainen identiteetti, JSON-LD self-description ja allekirjoitetut viestit. Milloin ANP on järkevämpi kuin keskitetty A2A.

## 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](https://tekoalydani.com/ota-yhteytta/) tai pyydä [AAIO Audit](https://tekoalydani.com/palvelut/aeo-seo/) (1290 €, sisältää AEO Auditin), joka kartoittaa kuinka pitkällä kauppasi on agenttivalmiudessa.

[Takaisin Daily Reportiin](https://tekoalydani.com/daily/)
