Ένα αρχείο εντοπισμού για πράκτορες δεν διαβάζεται

Σύντομη απάντηση

Ένα αρχείο που αναζητούν οι πράκτορες κάτω από το /.well-known/ απαντά, αλλά δεν διαβάζεται: agent-card.json (κάρτα πράκτορα A2A), mcp.json (περιγραφέας server MCP), api-catalog (RFC 9727) ή, σε καταστήματα, ucp. Δεν είναι έγκυρο JSON ή του λείπει ένα απαραίτητο πεδίο, όπως το name της κάρτας πράκτορα ή το linkset του καταλόγου API.

agent.discovery_invalid · Προτεραιότητα: P2

Τι σημαίνει

Ένα αρχείο κάτω από το /.well-known/ που αναζητούν οι πράκτορες (η κάρτα πράκτορα, ο περιγραφέας MCP, ο κατάλογος API ή το προφίλ UCP) απαντά, αλλά όχι με έγκυρο JSON ή χωρίς τα πεδία που χρειάζεται. Οι πράκτορες που το βρίσκουν σταματούν εκεί. Διορθώστε το αρχείο ή αφαιρέστε το.

Γιατί έχει σημασία για την αναζήτηση AI

Αυτά τα αρχεία λένε στους πράκτορες τι προσφέρει ένας ιστότοπος: έναν πράκτορα για συνομιλία, έναν server MCP, ένα API, έναν τρόπο αγοράς. Ένας πράκτορας που βρίσκει ένα από αυτά και δεν μπορεί να το αναλύσει τα παρατάει αντί να μαντέψει.

Οι περισσότεροι ιστότοποι δεν χρειάζονται κανένα, οπότε ένα αρχείο που λείπει δεν αναφέρεται ποτέ. Ένα αρχείο που υπάρχει αλλά είναι χαλασμένο συνήθως προέρχεται από μια δοκιμή, ένα πρότυπο ή ένα plugin που ρυθμίστηκε και ξεχάστηκε.

Πώς να το διορθώσετε

  1. Ανοίξτε κάθε αρχείο από τα αποδεικτικά στοιχεία και περάστε το από έναν επικυρωτή JSON.
  2. Διορθώστε τη σύνταξη και προσθέστε τα υποχρεωτικά πεδία, σύμφωνα με την προδιαγραφή του αρχείου.
  3. Σερβίρετέ το με Content-Type: application/json (application/linkset+json για τον κατάλογο API).
  4. Αν ο ιστότοπος δεν προσφέρει αυτό που περιγράφει το αρχείο, διαγράψτε το αρχείο. Πατήστε «Έλεγχος ξανά» στην αναφορά της σελίδας για να επιβεβαιώσετε το αποτέλεσμα.

Παράδειγμα

{
  "name": "Example support agent",
  "description": "Answers questions about orders",
  "url": "https://example.com/a2a",
  "version": "1.0.0",
  "skills": []
}

Πώς επιβεβαιώνετε τη διόρθωση

Μετά την αλλαγή, πατήστε «Έλεγχος ξανά» στην αναφορά: θα δείτε τι διορθώθηκε και πώς άλλαξε η βαθμολογία.

Έλεγχος της σελίδας μου →

Σχετικοί οδηγοί

Όλα τα ευρήματα και πώς λειτουργεί η βαθμολογία