Stan na 21 listopada 2026 · logi z 8 serwisów za 1–20 listopada 2026
W poradnikach o „gotowości na agentów AI” pojawił się nowy plik do wdrożenia: /.well-known/ard.json. Wcześniej tę samą rolę pełnił ai-catalog.json. Brzmi jak kolejny llms.txt, więc wraca znane pytanie: czy moja strona go potrzebuje?
Krótka odpowiedź brzmi: jeśli masz bloga, stronę firmową albo sklep bez własnego API i serwera MCP, dziś nie potrzebujesz ard.json. Plik nie opisuje treści strony, a jest spisem narzędzi, które agent AI może wywołać: serwerów MCP, agentów, skilli i rejestrów. Strona bez takich narzędzi po prostu nie ma czego w nim wpisać.
Co to jest ARD
Nazwa: Agentic Resource Discovery, czyli specyfikacja tego, jak agent AI ma znaleźć narzędzia, które udostępnia firma albo serwis.
Kto: autorzy to Junjie Bu (Google), R.V. Guha (w ogłoszeniu Microsoftu podpisany jako Technical Fellow w Microsofcie) i Shaun Smith (Hugging Face). Ogłoszenie 17 czerwca 2026, tego samego dnia na blogach Google, Microsoftu i Hugging Face.
Status: wersja v0.91 z 26 sierpnia 2026, oznaczona jako „Proposal”. To zatem propozycja, nie wdrożony standard.
Gdzie: plik /.well-known/ard.json albo link <link rel="ard"> w kodzie strony.
Co opisuje: serwery MCP, karty agentów A2A, skille i rejestry. Nie zawiera artykułów, produktów czy kategorii.
Logi serwera, 1–20 listopada 2026, 8 serwisów, które prowadzę: blog o SEO, blog kulinarny i przewodniki turystyczne po polsku, angielsku i niemiecku. Żadnego z tych plików nie mam, więc prawie wszystkie odpowiedzi to 404.
Kto o ard.json pyta? Odpowiedzi z moich logów
W logach 8 serwisów, które prowadzę, ard.json i ai-catalog.json padły od 1 do 20 listopada 194 razy. Pierwsza moja myśl? Agenci już szukają! Ale po weryfikacji: 192 z tych żądań to audyty Lighthouse i WebPageTest. 130 przyszło od Lighthouse uruchamianego z serwerów Google (tak działają narzędzia Google, na przykład PageSpeed Insights), a 62 od WebPageTest. Te z Lighthouse mają w logu podpis Chrome-Lighthouse, a nie Googlebot, więc adres Google nie oznacza, że wyszukiwarka zaczęła czytać ard.json.
Kto uruchamiał te audyty? W większości ja, testując własne strony. Resztę dorzucili, jak podejrzewam, znajomi SEOwcy 😉 Wniosek przyda się w każdej analizie logów: zanim uznasz, że agenci szukają nowego pliku, to sprawdź, czy to nie Ty go szukasz audytami.
Skąd Lighthouse w tej historii? Od wersji 13.5 z września 2026 ma audyt ARD w eksperymentalnej kategorii Agentic Browsing (do testów potrzebny jest Chrome 150 lub nowszy). Od wersji 13.6 z 27 października szuka manifestu tak, jak opisuje specyfikacja v0.91: w robots.txt, w linku rel="ard", w nagłówku HTTP, pod /.well-known/ard.json, a na końcu w starych miejscach (ai-catalog.json i rel="ai-catalog"), za które daje ostrzeżenie. Dlatego w logach pytania o oba pliki przychodzą parami. Gdy niczego nie znajdzie, audyt dostaje status „nie dotyczy” i nie wpływa na wynik. Ta sama kategoria sprawdza też llms.txt.
Botów było jak na lekarstwo. Andi-SearchBot (wyszukiwarka Andi) 3 listopada zapytał na podrez.pl o oba pliki przy okazji kilkunastu innych adresów dla agentów. AgentTrustBot, który buduje katalog agentów, 5 i 6 listopada pytał na czterech przewodnikach o karty agentów i serwerów MCP, ale już nie o ard.json. Boty ChatGPT, Claude, Gemini i Perplexity o ten plik nie pytały wcale.
Nie znalazłam też dokumentacji, w której OpenAI, Anthropic, Google albo Microsoft piszą, że ich asystenci czytają ard.json ze stron. Google zapowiada natywną obsługę ARD w najbliższych miesiącach w Agent Registry na Gemini Enterprise Agent Platform, czyli w narzędziu dla firm. O wyszukiwarce Google ogłoszenie nie wspomina. Instrukcje „Connect a chatbot” na stronie specyfikacji podpinają do Claude, ChatGPT czy Copilota wyszukiwarkę narzędzi (GitHub Agent Finder albo Hugging Face Discover). Według specyfikacji plik ze strony ma pobrać crawler rejestru, a chatbot pyta już ten rejestr. Tak działa na przykład Agent Finder w GitHub Copilot: szuka narzędzi w rejestrze, który wybierasz Ty albo Twoja firma. Dla pomiaru to ważne. W logach widzę, kto pytał o plik na moim serwerze, ale ewentualne późniejsze pytanie asystenta do rejestru odbywa się już poza moją domeną.
W podziękowaniach specyfikacji są osoby z AWS, Cisco, Databricks, GitHuba, GoDaddy, Google, Microsoftu, Nvidii, Salesforce i Snowflake. Autorzy dziękują im za wkład i uwagi, ale to nie jest lista firm, które plik wdrożyły.
ard.json czy ai-catalog.json?
Jeśli w jakimś poradniku widoczności w AI widzisz ai-catalog.json, to nie jest to pomyłka, tylko starsza wersja pliku. Poprzednik ARD używał adresu /.well-known/ai-catalog.json. Od wersji v0.91 obowiązuje jeden adres: /.well-known/ard.json. Narzędzia mogą nadal zaglądać pod stary adres (w specyfikacji „MAY”), ale wydawcy powinni przenieść plik pod nowy („SHOULD”). Część poradników wciąż opisuje starą nazwę.
Oprócz pliku specyfikacja opisuje jeszcze cztery drogi: link rel="ard" w sekcji <head>, linię Agentmap: w robots.txt, wpisy w JSON-LD na stronie opisującej narzędzie i rekordy DNS.
Co jest w środku
Plik to JSON z jedną wymaganą tablicą entries. Każdy wpis opisuje jedno narzędzie i musi mieć cztery rzeczy:
identifier, czyli identyfikator w formacieurn:air:domena:nazwa,displayName, czyli nazwę dla ludzi,type, czyli typ opisu, na przykładapplication/mcp-server-card+jsondla karty serwera MCP alboapplication/a2a-agent-card+jsondla karty agenta,urlalbodata: adres opisu albo opis wpisany na miejscu (dokładnie jedno z nich).
Zalecane są też representativeQueries: od 2 do 5 przykładowych pytań, przy których agent powinien sięgnąć po to narzędzie. Do tego opcjonalnie opis, tagi i wersja.
Dla kontrastu: traffic-advice, plik, który ma czytelnika
W tych samych logach jest plik z .well-known, o który ktoś pyta codziennie: /.well-known/traffic-advice. Przez 20 dni Chrome zapytał o niego 1583 razy, na wszystkich 8 serwisach. To Private Prefetch Proxy Chrome. Zanim proxy zestawi połączenie dla strony pobieranej z wyprzedzeniem, na przykład z wyników Google, sprawdza w tym pliku, czy serwis nie chce ograniczyć takiego ruchu.
Na moich serwisach odpowiedź to 404 i tak zostaje, bo brak pliku oznacza zachowanie domyślne. Co ten plik robi, co jeszcze wyszło przy nim w logach i kiedy warto go dodać, opisałam we wpisie traffic-advice w logach. Już teraz widać jednak różnicę: jeden plik ma prawdziwego czytelnika, a drugi czyta głównie Lighthouse.
Kiedy ard.json ma sens
- Masz publiczny serwer MCP (na przykład z wyszukiwarką produktów, rezerwacjami albo danymi) i chcesz, żeby agenci go znaleźli.
- Udostępniasz agenta A2A z kartą agenta albo pakiet skilli.
- Masz API dla agentów i opisujesz je kartą serwera MCP albo agenta.
- Prowadzisz rejestr albo katalog narzędzi dla agentów.
Tak mógłby wyglądać plik bloga kulinarnego, który ma własny serwer MCP z wyszukiwarką przepisów. To mój przykład, a nie fragment specyfikacji:
{
"entries": [
{
"identifier": "urn:air:example.com:mcp:przepisy",
"displayName": "Wyszukiwarka przepisów",
"type": "application/mcp-server-card+json",
"url": "https://example.com/.well-known/mcp/server-card.json",
"description": "Serwer MCP do wyszukiwania przepisów.",
"representativeQueries": [
"przepis na chleb bez glutenu",
"obiad keto w 30 minut"
]
}
]
}
Zwróć uwagę na url. Prowadzi do karty serwera MCP, czyli kolejnego pliku, który trzeba mieć. A karta prowadzi do działającego serwera. Bez niego ard.json jest drogowskazem donikąd.
Nawet wtedy pamiętaj, że to propozycja w wersji v0.91. Typy nie są jeszcze zarejestrowane w IANA, a autorzy zastrzegają, że format może się zmienić, więc wdrożenie warto traktować jak test.
Sprawdź swoją stronę
Czy Twoja strona ma ard.json albo starszy ai-catalog.json, sprawdzisz w moim narzędziu Czy boty AI mogą czytać Twoją stronę? Pokazuje, czy plik jest, ile ma wpisów i jakiego typu, na przykład serwer MCP. Zgłasza też wpisy bez wymaganych pól. Wynik jest informacyjny i nie zmienia ocen dostępu botów.
Przykład z 21 listopada 2026: github.com nie ma ard.json, ale ma stary ai-catalog.json z jednym serwerem MCP. Temu wpisowi brakuje pola displayName, więc według ARD nie jest kompletny.
Co zrobić zamiast tego przy stronie z treścią
- Sprawdź, czy boty AI w ogóle mogą czytać stronę. Narzędzie Czy boty AI mogą czytać Twoją stronę? pokazuje, na co botom AI i wyszukiwarkom pozwalają robots.txt, meta tagi i nagłówki.
- Zdecyduj o trenowaniu modeli. Jedną regułę w robots.txt opisałam we wpisie o regule __usage_ai-training.
- Zajrzyj do logów. Od tego, kto naprawdę przychodzi, zaczyna się analiza logów serwera. Boty AI w swoich logach sprawdzisz też narzędziem Boty AI w logach.
Podsumowując: ard.json to wizytówka dla narzędzi, a nie dla treści. Jeśli Twoja strona nie ma czego agentom podać do ręki, plik zostanie pusty, a głównym gościem będzie Lighthouse.
Najczęstsze pytania
Czym jest plik ard.json?
To manifest ze specyfikacji Agentic Resource Discovery (ARD), umieszczany pod adresem /.well-known/ard.json. Opisuje narzędzia, które agent AI może wywołać: serwery MCP, karty agentów A2A, skille i rejestry. Nie opisuje treści strony.
Czy ard.json pomaga w widoczności w ChatGPT albo Google?
Nie ma na to dowodów. Nie znalazłam dokumentacji, z której wynikałoby, że ChatGPT, Claude, Gemini czy Copilot czytają ten plik ze stron (GitHub Copilot może szukać narzędzi przez Agent Finder, ale pyta wtedy rejestr, a nie Twoją stronę). W logach 8 moich serwisów z 1–20 listopada 2026 nie pytał o niego żaden bot ChatGPT, Claude, Gemini ani Perplexity. Lighthouse sprawdza go w eksperymentalnej kategorii Agentic Browsing, ale brak pliku nie wpływa na wynik.
Czym różni się ard.json od ai-catalog.json?
ai-catalog.json to adres z poprzednika ARD. Od wersji v0.91 z 26 sierpnia 2026 obowiązuje /.well-known/ard.json. Programy mogą nadal sprawdzać stary adres, ale wydawcy powinni przejść na nowy.
GitHub ards-project, schemat ard-entry.schema.json, odczyt 21.11.2026.
Google for Developers Blog, Announcing the Agentic Resource Discovery specification, 17.06.2026.
Microsoft (R. Guha), Introducing the Agentic Resource Discovery specification, 17.06.2026.
Hugging Face, Agentic Resource Discovery: Let agents search for tools, skills, and other agents, 17.06.2026.
GitHub Changelog, Agent finder for GitHub Copilot now available, 17.06.2026.
GoogleChrome/lighthouse, wydania 13.5.0 i 13.6.0, 17.09.2026 i 27.10.2026.
ARD, Connect a chatbot, odczyt 21.11.2026.
Chrome for Developers, ard.json, aktualizacja 20.10.2026.
Chrome for Developers, Lighthouse agentic browsing scoring, aktualizacja 5.05.2026.
Chrome for Developers (K. Hempenius, K. Baheux, M. Buettner), Private prefetch proxy in Chrome, aktualizacja 11.05.2022.
Private Prefetch Proxy, Traffic Advice, opis propozycji, odczyt 21.11.2026.
Dane własne: logi serwera 8 serwisów, 1–20.11.2026, odczyt 21.11.2026.
Chcesz częściej widzieć moje wpisy w Google?
Dodaj podrez.pl do preferowanych źródeł w GoogleWięcej w temacie: AI Search i GEO


