Nie da się odczytać pliku wykrywania dla agentów
Plik, którego agenci szukają w /.well-known/, odpowiada, ale nie da się go odczytać: agent-card.json (karta agenta A2A), mcp.json (deskryptor serwera MCP), api-catalog (RFC 9727) albo, w sklepach, ucp. Nie jest poprawnym JSON lub brakuje mu wymaganego pola, takiego jak name karty agenta albo linkset katalogu API.
Co to oznacza
Plik w /.well-known/, którego szukają agenci (karta agenta, deskryptor MCP, katalog API lub profil UCP), odpowiada, ale nie poprawnym JSON albo bez wymaganych pól. Agenci, którzy go znajdą, na tym kończą. Napraw plik lub go usuń.
Dlaczego to ważne dla wyszukiwarek AI
Te pliki mówią agentom, co oferuje witryna: agenta do rozmowy, serwer MCP, API, sposób zakupu. Agent, który znajdzie taki plik i nie umie go przetworzyć, rezygnuje zamiast zgadywać.
Większość witryn nie potrzebuje żadnego z nich, więc brak pliku nigdy nie jest zgłaszany. Plik, który istnieje, ale jest zepsuty, zwykle pochodzi z testu, szablonu albo wtyczki, które ktoś skonfigurował i o nich zapomniał.
Jak to naprawić
- Otwórz każdy plik z dowodów i sprawdź go walidatorem JSON.
- Popraw składnię i dodaj wymagane pola zgodnie ze specyfikacją danego pliku.
- Udostępniaj go z
Content-Type: application/json(application/linkset+jsondla katalogu API). - Jeśli witryna nie oferuje tego, co opisuje plik, usuń go. Uruchom „Sprawdź ponownie” w raporcie strony, aby potwierdzić wynik.
Przykład
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Jak potwierdzić poprawkę
Po zmianie kliknij „Sprawdź ponownie” w raporcie: zobaczysz, co zostało naprawione i jak zmienił się wynik.