Un fichier de découverte pour agents est illisible

Réponse courte

Un fichier que les agents recherchent sous /.well-known/ répond, mais est illisible : agent-card.json (une carte d'agent A2A), mcp.json (un descripteur de serveur MCP), api-catalog (RFC 9727) ou, sur les boutiques, ucp. Ce n'est pas du JSON valide, ou il manque un champ requis, comme le name de la carte d'agent ou le linkset du catalogue d'API.

agent.discovery_invalid · Priorité: P2

Ce que cela signifie

Un fichier sous /.well-known/ que les agents recherchent (la carte d'agent, le descripteur MCP, le catalogue d'API ou le profil UCP) répond, mais pas avec un JSON valide, ou sans les champs requis. Les agents qui le trouvent s'arrêtent là. Corrigez le fichier ou supprimez-le.

Pourquoi c'est important pour la recherche IA

Ces fichiers disent aux agents ce qu'un site propose : un agent à qui parler, un serveur MCP, une API, un moyen d'acheter. Un agent qui en trouve un et ne peut pas l'analyser abandonne au lieu de deviner.

La plupart des sites n'en ont besoin d'aucun : un fichier absent n'est donc jamais signalé. Un fichier présent mais cassé vient en général d'un test, d'un modèle ou d'un plugin installé puis oublié.

Comment corriger

  1. Ouvrez chaque fichier indiqué dans les preuves et passez-le dans un validateur JSON.
  2. Corrigez la syntaxe et ajoutez les champs requis, en suivant la spécification propre au fichier.
  3. Servez-le avec Content-Type: application/json (application/linkset+json pour le catalogue d'API).
  4. Si le site ne propose pas ce que décrit le fichier, supprimez le fichier. Lancez « Revérifier » dans le rapport de la page pour confirmer le résultat.

Exemple

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

Comment confirmer le correctif

Après la modification, cliquez sur « Revérifier » dans le rapport : il indique ce qui a été corrigé et comment le score a évolué.

Vérifier ma page →

Guides associés

Tous les constats et le fonctionnement du score