Ένα αρχείο εντοπισμού για πράκτορες δεν διαβάζεται
Ένα αρχείο που αναζητούν οι πράκτορες κάτω από το /.well-known/ απαντά, αλλά δεν διαβάζεται: agent-card.json (κάρτα πράκτορα A2A), mcp.json (περιγραφέας server MCP), api-catalog (RFC 9727) ή, σε καταστήματα, ucp. Δεν είναι έγκυρο JSON ή του λείπει ένα απαραίτητο πεδίο, όπως το name της κάρτας πράκτορα ή το linkset του καταλόγου API.
Τι σημαίνει
Ένα αρχείο κάτω από το /.well-known/ που αναζητούν οι πράκτορες (η κάρτα πράκτορα, ο περιγραφέας MCP, ο κατάλογος API ή το προφίλ UCP) απαντά, αλλά όχι με έγκυρο JSON ή χωρίς τα πεδία που χρειάζεται. Οι πράκτορες που το βρίσκουν σταματούν εκεί. Διορθώστε το αρχείο ή αφαιρέστε το.
Γιατί έχει σημασία για την αναζήτηση AI
Αυτά τα αρχεία λένε στους πράκτορες τι προσφέρει ένας ιστότοπος: έναν πράκτορα για συνομιλία, έναν server MCP, ένα API, έναν τρόπο αγοράς. Ένας πράκτορας που βρίσκει ένα από αυτά και δεν μπορεί να το αναλύσει τα παρατάει αντί να μαντέψει.
Οι περισσότεροι ιστότοποι δεν χρειάζονται κανένα, οπότε ένα αρχείο που λείπει δεν αναφέρεται ποτέ. Ένα αρχείο που υπάρχει αλλά είναι χαλασμένο συνήθως προέρχεται από μια δοκιμή, ένα πρότυπο ή ένα plugin που ρυθμίστηκε και ξεχάστηκε.
Πώς να το διορθώσετε
- Ανοίξτε κάθε αρχείο από τα αποδεικτικά στοιχεία και περάστε το από έναν επικυρωτή JSON.
- Διορθώστε τη σύνταξη και προσθέστε τα υποχρεωτικά πεδία, σύμφωνα με την προδιαγραφή του αρχείου.
- Σερβίρετέ το με
Content-Type: application/json(application/linkset+jsonγια τον κατάλογο API). - Αν ο ιστότοπος δεν προσφέρει αυτό που περιγράφει το αρχείο, διαγράψτε το αρχείο. Πατήστε «Έλεγχος ξανά» στην αναφορά της σελίδας για να επιβεβαιώσετε το αποτέλεσμα.
Παράδειγμα
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Πώς επιβεβαιώνετε τη διόρθωση
Μετά την αλλαγή, πατήστε «Έλεγχος ξανά» στην αναφορά: θα δείτε τι διορθώθηκε και πώς άλλαξε η βαθμολογία.