A2A schránka

Cybermindnet má veřejnou A2A schránku, kam může AI agent poslat požadavek jménem svého uživatele. Typické požadavky zahrnují fakturu, upomínku, žádost, obchodní nabídku nebo dotaz. Strojový kanál je pro obě strany jednodušší než e-mail nebo robotický telefonát. Schránka je zatím zkušební, chceme zjistit, kolik agentů ji bude používat.

Adresa

Adresa schránky: https://a2a.cybermindnet.eu/
Agent Card: cybermindnet.eu/.well-known/agent-card.json

Co je A2A

A2A (Agent2Agent) je otevřený standard pro komunikaci mezi nezávislými AI agenty, které mohou pocházet od různých výrobců. Agent si nejdřív přečte takzvanou Agent Card: krátký popis druhého agenta ve formátu JSON, co umí a na jaké adrese přijímá zprávy. Pak pošle zprávu a dostane zpět úkol (task) s identifikátorem a stavem. Na stav úkolu se může kdykoli později zeptat. Schránka používá A2A ve verzi 1.0 a přijímá i starší verzi 0.3.

Jak to zadat svému agentovi

Pokud používáte AI agenta, který umí volat webové služby (například Claude Code nebo jiný programovací asistent), stačí mu říct, co má poslat. Dejte mu adresu schránky a odkaz na Agent Card Cybermindnetu; obojí je uvedeno výše. Agent si z Agent Card zjistí, jak zprávu poslat, a vrátí vám identifikátor úkolu. Tento identifikátor si uschovejte, podle něj se dá zjistit stav.

Ukázka volání

curl -sS https://a2a.cybermindnet.eu/ \
  -H 'Content-Type: application/json' \
  -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "SendMessage",
       "params": {"message": {"messageId": "m-1", "role": "ROLE_USER",
         "parts": [{"text": "Dobrý den, posílám fakturu za říjen."}]}}}'

{"jsonrpc": "2.0", "id": 1, "result": {"task": {"id": "3f0c…", "contextId": "3f0c…",
  "status": {"state": "TASK_STATE_SUBMITTED", "timestamp": "…"}}}}

curl -sS https://a2a.cybermindnet.eu/ \
  -H 'Content-Type: application/json' \
  -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "GetTask", "params": {"id": "3f0c…"}}'

Co se s požadavkem stane

Po přijetí požadavek uložíme a vrátíme úkol ve stavu „přijato“ (submitted). Žádný automat ho nečte, nevykonává ani nikam nepřeposílá. Přečte ho člověk. Po vyřízení se stav změní na „vyřízeno“ (completed) nebo „odmítnuto“ (rejected). Schránka sama neodpovídá, pro odpověď uveďte v požadavku kontakt. Požadavky mažeme po 90 dnech.

Pravidla

Jeden požadavek může mít nejvýš 2 MB.
Přílohy: nejvýš 5, ve formátech PDF, prostý text, CSV, Markdown, JSON, PNG, JPEG a WebP.
Z jedné adresy přijmeme nejvýš 20 požadavků za hodinu.
Podpis požadavku (HTTP Message Signatures, Web Bot Auth) nevyžadujeme. Když ho agent pošle, ověříme ho a zaznamenáme.

Zpracování údajů

Správcem údajů, které schránka přijme, je Cybermindnet s.r.o., IČO 07126042, Vícenice 24, 339 01 Klatovy. Ukládáme IP adresu a síť (ASN), ze které požadavek přišel, User-Agent a další hlavičky požadavku, text a přílohy požadavku a podpis, pokud ho agent pošle. Údaje slouží k vyřízení požadavku, k ochraně proti zneužití a k vyhodnocení provozu služby. Všechno mažeme po 90 dnech. Dotazy ke zpracování údajů pošlete na info@cybermindnet.eu.

Nemáte agenta?

Váš asistent vám napíše e-mail. Pošlete ho na info@cybermindnet.eu.