Agent Cards: Ako sa agenti navzájom nachádzajú (A2A Discovery)
Agent Card je strojovo čitateľný JSON dokument v protokole A2A, prostredníctvom ktorého AI agent zverejňuje svoju identitu, endpointy, skilly, capabilities, podporované modality a autentifikačné schémy. Iní agenti túto kartu načítajú, aby sa rozhodli, či a ako daného agenta poveria úlohou. Je základom agent discovery.
Na prvý pohľad
- Agent Card je strojovo čitateľný profil agenta v protokole A2A: identita, endpoint, skilly, capabilities, modality a autentifikácia vo formáte JSON.
- A2A jasne oddeľuje úlohy: MCP riadi prístup k nástrojom a dátam (agent-k-nástroju), A2A riadi spoluprácu medzi agentmi (agent-k-agentovi). Agent Card je mechanizmus discovery protokolu A2A.
- Discovery funguje cez kartu: klientsky agent načíta kartu, overí skilly a auth, potom otvorí A2A task. Vnútorná štruktúra vzdialeného agenta zostáva zámerne nepriehľadná.
- Task prechádza stavmi submitted a working, v prípade potreby sa pozastaví v stave input-required alebo auth-required a končí v stave completed, failed, canceled alebo rejected. Výsledky sa vracajú ako artifacts, medzistavy cez Server-Sent Events.
- Pre agentúry je zverejňovanie Agent Cards najdôležitejšou produktovou pákou roku 2026: iba discoverable agentov možno volať zo Salesforce, SAP Joule alebo Copilot Studio bez vlastnej integrácie.
- Rizikami sú capability drift, narušenie hraníc dôvery (trust boundary) a zosilnenie prompt injection. Každé nové prepojenie agentov je novou útočnou plochou a potrebuje least-privilege tokeny.
Agent Card je strojovo čitateľný JSON dokument v protokole A2A, prostredníctvom ktorého AI agent zverejňuje svoju identitu, svoj endpoint, svoje skilly, capabilities, modality a autentifikačné schémy. Iní agenti túto kartu načítajú, aby sa rozhodli, či a ako daného agenta poveria úlohou. Agent Card je tak ústredným mechanizmom, cez ktorý sa agenti navzájom nachádzajú bez toho, aby ich niekto musel vopred natvrdo prepojiť.
- Čo to je: verejný profil agenta, vizitka a popis rozhrania v jednom.
- Na čo slúži: agent discovery. Klientsky agent overí skilly, modality a auth skôr, než zadá úlohu (task).
- Prečo na nej záleží: bez Agent Card je agent pre iné systémy neviditeľný a dostupný len cez vlastnú integráciu.
A2A, MCP a úloha Agent Card
V protokolovom stacku roku 2026 sa presadili dva otvorené štandardy. Model Context Protocol (MCP), ktorý vyvinula spoločnosť Anthropic, riadi prístup agentov k nástrojom a dátam, teda agent-k-nástroju. Od decembra 2025 je MCP v správe Agentic AI Foundation pod záštitou Linux Foundation. Protokol Agent2Agent (A2A) riadi spoluprácu medzi agentmi, teda agent-k-agentovi. Dokumentácia A2A ich vymedzuje takto: cez MCP agent využíva schopnosti, ako sú nástroje a zdroje, cez A2A agenti pracujú ako partneri na spoločnej úlohe. Oba protokoly sa navzájom dopĺňajú.
Agent Card je stavebným prvkom capability discovery v protokole A2A. Kým MCP server opisuje jednotlivé nástroje, Agent Card opisuje celého agenta ako potenciálneho partnera na spoluprácu. A2A bol predstavený v apríli 2025 na konferencii Google Cloud Next a 23. júna 2025 odovzdaný Linux Foundation, so spoločnosťami AWS, Cisco, Google, Microsoft, Salesforce, SAP a ServiceNow ako zakladajúcimi členmi. Protokol medzitým podporuje viac ako 100 firiem (stav 2026).
Štruktúra Agent Card
Agent Card je JSON dokument, ktorý agent zverejní pod známou cestou svojho hostiteľa. Obsahuje tieto kľúčové súčasti:
Pole | Význam | Príklad obsahu |
|---|---|---|
Identita ( | názov, popis a verzia agenta | "Invoice-Triage-Agent", "2.0.0" |
Rozhrania ( | adresa, protokolový binding a verzia protokolu, na ktorých agent prijíma tasky | https://agents.example.com/a2a, JSONRPC, 1.0 |
Skilly ( | pomenované schopnosti s ID, názvom, popisom a tagmi | "klasifikuj_fakturu", "extrahuj_sumu" |
Capabilities ( | voliteľné funkcie protokolu | streaming, push notifikácie |
Modality ( | podporované vstupné a výstupné formáty ako typy médií | text/plain, application/pdf, application/json |
Autentifikácia ( | akceptované bezpečnostné schémy a to, ktoré z nich sa vyžadujú | OAuth 2.0, OpenID Connect, API kľúč, mTLS |
Rozhodujúci je princíp dizajnu, ktorý za tým stojí: A2A definuje, ako agenti spolu komunikujú, nie ako myslia. Vnútorná štruktúra vzdialeného agenta, teda jeho prompty, model a pamäť, zostáva zámerne nepriehľadná. Práve vďaka tomu môže agent v Salesforce zavolať agenta v SAP bez toho, aby ktorákoľvek strana odhalila svoje prompty, svoj model alebo svoje dáta. Karta je jediná zmluva, ktorú obe strany zdieľajú.
Mechanizmus discovery
Discovery cez Agent Cards prebieha v dvoch typických podobách.
Priame objavovanie (bod-bod). Klientsky agent pozná základnú URL vzdialeného agenta a načíta jeho Agent Card. Overí, či deklarované skilly zodpovedajú úlohe, či je podporovaná potrebná modalita a či dokáže obslúžiť autentifikačnú schému. Až potom otvorí task.
Objavovanie cez adresár (registry). Vo väčších prostrediach sa Agent Cards registrujú centrálne. Open-source projekt AGNTCY, ktorý spustilo Cisco, na to poskytuje Agent Directory: federovaný register, v ktorom možno A2A agentov a MCP servery zverejňovať, overovať a vyhľadávať. Skilly a atribúty opisuje pomocou Open Agentic Schema Framework (OASF). Vďaka tomu agent nájde vhodných partnerov cez adresár namiesto pevne zadrôtovaných adries. SAP združuje porovnateľnú funkciu v SAP AI Agent Hub v rámci SAP LeanIX. Hub je navrhnutý ako riadiace centrum nezávislé od dodávateľa, cez ktoré firmy nachádzajú, inventarizujú a riadia agentov od SAP aj od iných dodávateľov a tiež MCP servery. V októbri 2026 SAP uvádza hub ako všeobecne dostupný.
Keď sa partner nájde, riadenie preberá životný cyklus A2A tasku. Podľa špecifikácie A2A prechádza task stavmi submitted a working, pri doplňujúcich otázkach sa pozastaví v stave input-required alebo pri potrebe dodatočnej autentifikácie v stave auth-required a končí v stave completed, failed, canceled alebo rejected. V JSON špecifikácie 1.0 sa tieto stavy volajú TASK_STATE_SUBMITTED, TASK_STATE_WORKING, TASK_STATE_INPUT_REQUIRED a tak ďalej. Transport prebieha cez JSON-RPC 2.0 a HTTPS, špecifikácia navyše definuje bindingy pre gRPC a HTTP+JSON. Medzistavy sa streamujú cez Server-Sent Events, pre dlhé behy existujú voliteľné push notifikácie. Výsledok tasku sa vracia ako jeden alebo viac artifacts, správy môžu byť viacdielne a multimodálne.
Z výskumnej strany ukazuje projekt NANDA z MIT Media Lab, kam by mohlo dlhodobo smerovať objavovanie agentov: decentralizovaný index agentov s kryptograficky overiteľnými AgentFacts a Zero Trust Agentic Access. K stavu 2026 ide však o výskumnú úroveň (research-grade), nie o podklad pre produkčné rozhodnutia.
Príklad: discovery medzi dvoma agentmi
Predpokladajme, že CRM agent v Salesforce má dať predbežne preveriť prichádzajúce faktúry od dodávateľov a poveriť tým špecializovaného fakturačného agenta jednej agentúry.
Agent Card fakturačného agenta, skrátená a s názvami polí podľa špecifikácie A2A 1.0:
"name": "Invoice-Triage-Agent","version": "2.0.0""supportedInterfaces": [{ "url": "https://agents.example.com/a2a", "protocolBinding": "JSONRPC", "protocolVersion": "1.0" }]"capabilities": { "streaming": true, "pushNotifications": true }"defaultInputModes": ["text/plain", "application/pdf"],"defaultOutputModes": ["application/json"]"securitySchemes": { "oauth": { "oauth2SecurityScheme": { "flows": { … } } } }"skills": [{ "id": "klasifikuj_fakturu", "name": "Klasifikovať faktúru", "description": "Vráti kategóriu a konfidenciu (0 až 1)", "tags": ["faktúra"] }]
Postup:
- CRM agent načíta kartu:
GET https://agents.example.com/.well-known/agent-card.json - Overí si: skill sedí, vstupný formát aj OAuth 2.0 sú podporované.
- Otvorí task cez
POST https://agents.example.com/a2a, task sa začína v staveTASK_STATE_SUBMITTED. - Task prejde stavom
TASK_STATE_WORKINGa skončí v staveTASK_STATE_COMPLETED. Ako artifact sa vráti:{ "kategoria": "Príjem tovaru", "konfidencia": 0.94 }
CRM agent nemusel vedieť nič o internom modeli ani o promptoch fakturačného agenta. Výlučne na základe karty sa rozhodol, že tento agent dokáže úlohu splniť, a potom ho poveril cez štandardizovanú zmluvu tasku. Práve toto oddelenie umožňuje workflowy naprieč dodávateľmi medzi Agentforce, Joule a Copilot Studio. Pre Joule SAP v máji 2026 oznámil, že obojsmerné funkcie A2A sprístupní všeobecne vo štvrtom štvrťroku 2026.
Bezpečnosť a governance
Každé nové prepojenie agentov je novou hranicou dôvery, a tým aj novou útočnou plochou. Osobitne relevantné sú pritom štyri riziká: narušenie hraníc dôvery (trust boundary), pretože každý A2A peer je pre ostatných nepriehľadný; capability drift, keď karta sľubuje viac, než agent reálne dokáže bezpečne zvládnuť; medzery v audit traile, len čo správy prekročia hranice procesov; a zosilnenie prompt injection, pretože každý ďalší kontext agenta je ďalšou príležitosťou na obídenie ochrany. Riziko nepriamej prompt injection (XPIA) rastie s každým agentom, ktorý spracúva nedôveryhodný obsah.
Praktické dôsledky pre nasadenia v regióne DACH: tokeny s obmedzeným rozsahom a krátkou platnosťou pre každý task, least privilege pri skilloch deklarovaných v karte, jednotné correlation ID pre každý A2A task a žiadne proprietárne rozšírenia sémantiky karty alebo tasku, ktoré podkopávajú práve tú prenositeľnosť, kvôli ktorej sa A2A vyberá. Pri regulovaných workflowoch patrí k reprodukovateľnosti protokolovať použité Agent Cards pre každý beh a pinovať verzie modelov.
Pre agentúry a B2B
Pre marketingové a digitálne agentúry v regióne DACH je zverejňovanie Agent Cards najdôležitejšou produktovou pákou roku 2026. Iba agenta, ktorý je cez A2A discoverable, možno priamo zavolať z prostredí Salesforce, SAP Joule alebo Copilot Studio tvojich zákazníkov bez toho, aby bola pre každého zákazníka potrebná vlastná integrácia. Kto Agent Cards preskočí, zostane natrvalo odkázaný na manuálnu integráciu. Naše odporúčanie: disciplína pri kartách od prvého dňa, vynucovať typované výstupné zmluvy (napríklad cez Pydantic alebo JSON Schema) a pre každého produktizovaného agenta vyžadovať kartu pred spustením do prevádzky.
Pre B2B manažérov s rozhodovacou právomocou je kľúčová otázka obstarávania: garantuje tvoja zmluva na Agentforce, Joule alebo Copilot Studio interoperabilitu A2A a súlad so štandardom MCP? A obsahuje klauzuly o zverejňovaní Agent Cards a o ukončení spolupráce (exit)? Blck Alpaca ti pomôže navrhnúť agentov v súlade s A2A, čisto namodelovať Agent Cards a začleniť ich do discovery architektúry pripravenej na governance.
Otvorí chat s pripraveným promptom.
Často kladené otázky
Čo je Agent Card v protokole A2A?
Ako sa A2A líši od MCP pri discovery?
Ako sa agenti navzájom nachádzajú cez Agent Cards?
Aké polia obsahuje Agent Card?
Sú Agent Cards v roku 2026 pripravené na produkčné nasadenie?
Ísť hlbšie?
Získajte nové analýzy priamo do schránky, alebo sa pozrite, ako tieto poznatky nasadzujeme pre firmy.