Hindi mabasa ang isang discovery file para sa mga agent
Sumasagot ang isang file na hinahanap ng mga agent sa ilalim ng /.well-known/, pero hindi ito mabasa: agent-card.json (A2A agent card), mcp.json (MCP server descriptor), api-catalog (RFC 9727) o, sa mga tindahan, ucp. Hindi ito valid na JSON, o kulang ito ng field na kailangan, gaya ng name ng agent card o linkset ng API catalog.
Ano ang ibig sabihin nito
Sumasagot ang isang file sa ilalim ng /.well-known/ na hinahanap ng mga agent (ang agent card, ang MCP descriptor, ang API catalog o ang UCP profile), pero hindi valid na JSON, o kulang ang mga field na kailangan nito. Doon na humihinto ang mga agent na nakakita nito. Ayusin ang file o alisin ito.
Bakit ito mahalaga para sa AI search
Sinasabi ng mga file na ito sa mga agent kung ano ang iniaalok ng site: isang agent na makakausap, isang MCP server, isang API, isang paraan para bumili. Ang agent na nakahanap ng isa at hindi ito ma-parse ay sumusuko sa halip na manghula.
Karamihan sa mga site ay hindi nangangailangan ng alinman sa mga ito, kaya hindi kailanman iniuulat ang file na wala. Ang file na naroon pero sira ay kadalasang galing sa isang test, template o plugin na na-set up at nakalimutan.
Paano ito ayusin
- Buksan ang bawat file mula sa ebidensya at patakbuhin ito sa isang JSON validator.
- Ayusin ang syntax at idagdag ang mga kinakailangang field, ayon sa sariling specification ng file.
- Ibigay ito na may
Content-Type: application/json(application/linkset+jsonpara sa API catalog). - Kung hindi iniaalok ng site ang inilalarawan ng file, burahin ang file. Patakbuhin ang "Suriin muli" sa ulat ng pahina para makumpirma ang resulta.
Halimbawa
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Paano kumpirmahin ang ayos
Pagkatapos ng pagbabago, pindutin ang "Suriin muli" sa ulat: inililista nito kung ano ang naayos at paano nagbago ang score.