Hyppää sisältöön
agenteille · agent interfaces

Agenteille: kokeiltavat rajapinnat.

Tekoalydani.com on itsessään agenttirajapinta. Tällä sivulla on kaikki tuotannossa olevat, kokeiltavat endpointit yhtenä hakemistona: luonnollisen kielen kysely (NLWeb), työkalukutsut (MCP), agenttien välinen viestintä (A2A), agenttikaupan protokollat (ACP, UCP), agenttiverkosto (ANP) ja maksumandaatit (AP2). Jokaisella rajapinnalla on metodi, polku, lyhyt kuvaus ja valmis curl-komento jonka voit ajaa heti.

Kaikki alla olevat endpointit on verifioitu toimiviksi. Jos rakennat agentille integraatiota, aloita discovery-tiedostoista tai kokeile /ask-kenttää suoraan tällä sivulla.

Discovery: mistä agentti aloittaa.

Nämä koneluettavat tiedostot kuvaavat rajapinnat. Ne palvelevat kaikki HTTP 200, GET-metodilla.

Kokeiltavat endpointit.

Jokainen kortti sisältää metodin, polun, kuvauksen ja valmiin curl-komennon.

POST

/ask

NLWeb /ask

Kysy sivustolta luonnollisella kielellä, vastaus tulee schema.org ItemList -muodossa (SSE-tuki, 30 kyselyä/min/IP).

discovery: /.well-known/nlweb

curl -X POST https://tekoalydani.com/ask \
  -H "Content-Type: application/json" \
  -d '{"query":"Mitä palveluita tarjoatte?"}'
POST

/api/mcp

MCP

Model Context Protocol JSON-RPC: listaa ja kutsu työkaluja (tools/list, tools/call), resources ja prompts.

discovery: /.well-known/mcp/server-card.json

curl -X POST https://tekoalydani.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
POST

/api/a2a

A2A

Agent-to-Agent JSON-RPC: lähetä viesti toiselle agentille (message/send) ja seuraa tehtävän tilaa (tasks/*).

discovery: /.well-known/agent-card.json

curl -X POST https://tekoalydani.com/api/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"message/send","id":1,
       "params":{"message":{"role":"user",
       "parts":[{"kind":"text","text":"Listaa palvelut"}]}}}'
POST

/api/acp/checkout-sessions

ACP

Agentic Commerce Protocol (Stripe-yhteensopiva): luo agentin ostosessio. Vaatii API-Version- ja Idempotency-Key-headerit.

discovery: /.well-known/acp.json

curl -X POST https://tekoalydani.com/api/acp/checkout-sessions \
  -H "Content-Type: application/json" \
  -H "API-Version: 2026-04-17" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"items":[{"product_id":"aeo-audit","quantity":1}],
       "buyer":{"email":"[email protected]"}}'
GET

/api/ucp/catalog

UCP-katalogi

Universal Commerce Protocol -tuoteluettelo, jonka agentti voi lukea ennen ostoa.

discovery: /.well-known/ucp.json

curl https://tekoalydani.com/api/ucp/catalog
POST

/api/ucp/checkout-sessions

UCP-ostosessio

Universal Commerce Protocol: luo ostosessio line_items-riveistä ja ostajan tiedoista.

discovery: /.well-known/ucp.json

curl -X POST https://tekoalydani.com/api/ucp/checkout-sessions \
  -H "Content-Type: application/json" \
  -d '{"line_items":[{"item":{"id":"aeo-audit"},"quantity":1}],
       "buyer":{"email":"[email protected]"}}'
POST

/api/anp/meta-protocol

ANP

Agent Network Protocol: neuvottele tuetuista protokollista (list_supported_protocols, describe_protocol, negotiate_protocol).

discovery: /.well-known/agents

curl -X POST https://tekoalydani.com/api/anp/meta-protocol \
  -H "Content-Type: application/json" \
  -d '{"method":"list_supported_protocols"}'
POST

/api/ap2/mandates/intent

AP2

Agent Payments Protocol: luo Ed25519-allekirjoitettu intent-mandaatti (myös cart- ja payment-mandaatit).

discovery: /.well-known/ap2

curl -X POST https://tekoalydani.com/api/ap2/mandates/intent \
  -H "Content-Type: application/json" \
  -d '{"intent":{"purpose":"Osta AEO-auditointi"}}'
POST

/api/checkout

Stripe Checkout

Luo Stripe Checkout -sessio diagnostiikkapaketin ostoon ja palauttaa maksulinkin.

curl -X POST https://tekoalydani.com/api/checkout \
  -H "Content-Type: application/json" \
  -d '{"package":"aeo-audit","customer_email":"[email protected]"}'
POST

/api/inquiry

Yhteydenotto

Jätä yhteydenotto ohjelmallisesti (nimi, sähköposti, viesti).

curl -X POST https://tekoalydani.com/api/inquiry \
  -H "Content-Type: application/json" \
  -d '{"name":"Ostaja-agentti","email":"[email protected]",
       "message":"Pyyntö agenttivalmiuskartoituksesta"}'

Kokeile suoraan selaimessa.

Alla oleva lomake kutsuu NLWeb /ask -endpointtia. Se on myös WebMCP-työkalu: WebMCP:tä tukeva selainagentti näkee lomakkeen kutsuttavana toimintona.

Käytämme Google Analytics 4:ää ja Microsoft Clarityä sivuston käytön ymmärtämiseen. Evästeitä käytetään vain suostumuksellasi. Tietosuojakäytäntö