ఏజెంట్ డిస్కవరీ ఫైల్ను చదవలేకపోయాం
ఏజెంట్లు /.well-known/ కింద వెతికే ఫైల్ జవాబిస్తుంది, కానీ చదవలేం: agent-card.json (A2A agent card), mcp.json (MCP server descriptor), api-catalog (RFC 9727) లేదా, షాప్లలో, ucp. అది సరైన JSON కాదు, లేదా agent card name లేదా API catalog linkset లాంటి అవసరమైన ఫీల్డ్ లేదు.
దీని అర్థం ఏమిటి
ఏజెంట్లు వెతికే /.well-known/ కింది ఫైల్ (agent card, MCP descriptor, API catalog లేదా UCP profile) జవాబిస్తుంది, కానీ సరైన JSONగా కాదు, లేదా అవసరమైన ఫీల్డ్లు లేకుండా. దాన్ని కనుగొన్న ఏజెంట్లు అక్కడే ఆగిపోతాయి. ఫైల్ను సరిచేయండి లేదా తీసివేయండి.
AI సెర్చ్కు ఇది ఎందుకు ముఖ్యం
సైట్ ఏమి అందిస్తుందో ఈ ఫైల్లు ఏజెంట్లకు చెబుతాయి: మాట్లాడటానికి ఒక ఏజెంట్, ఒక MCP server, ఒక API, కొనే మార్గం. ఒకదాన్ని కనుగొని parse చేయలేని ఏజెంట్ ఊహించకుండా వదిలేస్తుంది.
చాలా సైట్లకు వీటిలో ఏదీ అవసరం లేదు, కాబట్టి లేని ఫైల్ను ఎప్పుడూ నివేదించం. ఉండి పాడైన ఫైల్ సాధారణంగా సెటప్ చేసి మరచిపోయిన టెస్ట్, template లేదా plugin నుంచి వస్తుంది.
దీన్ని ఎలా సరిచేయాలి
- ఆధారాల్లోని ప్రతి ఫైల్ను తెరిచి JSON validatorతో తనిఖీ చేయండి.
- ఫైల్ సొంత స్పెసిఫికేషన్ను అనుసరించి syntaxను సరిచేసి, అవసరమైన ఫీల్డ్లను జోడించండి.
- దాన్ని
Content-Type: application/jsonతో అందించండి (API catalog కోసంapplication/linkset+json). - ఫైల్ వివరించేది సైట్ అందించకపోతే, ఫైల్ను తొలగించండి. ఫలితాన్ని నిర్ధారించడానికి పేజీ రిపోర్ట్లో "మళ్లీ తనిఖీ చేయండి" నడపండి.
ఉదాహరణ
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} పరిష్కారాన్ని ఎలా నిర్ధారించాలి
మార్పు తర్వాత రిపోర్ట్లో "మళ్లీ తనిఖీ చేయండి" నొక్కండి: ఏమి సరిచేయబడిందో, స్కోర్ ఎలా మారిందో అది చూపిస్తుంది.