Hindi mabasa ang isang discovery file para sa mga agent

Maikling sagot

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.

agent.discovery_invalid · Priyoridad: P2

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

  1. Buksan ang bawat file mula sa ebidensya at patakbuhin ito sa isang JSON validator.
  2. Ayusin ang syntax at idagdag ang mga kinakailangang field, ayon sa sariling specification ng file.
  3. Ibigay ito na may Content-Type: application/json (application/linkset+json para sa API catalog).
  4. 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.

Suriin ang pahina ko →

Mga kaugnay na gabay

Lahat ng natuklasan at paano gumagana ang score