Issue reference
Your agent card is at the old address
- A2A_AGENT_CARD_LEGACY_PATH
- Any
- A2A
- Medium
What it means
It concerns A2A, the agent discovery. Agent-to-Agent. It lets other agents find and talk to any agent you publish.
What it does to an agent
Agents can usually carry on, but more slowly or less sure of what they found, and an unsure agent is likelier to recommend another store.
How to fix it
Serve the Agent Card at /.well-known/agent-card.json. A spec-compliant A2A 1.0 client never requests the older /.well-known/agent.json, so a card published only there is invisible to every current client while looking correct to a human.
Check the fix
Run the check that reported A2A_AGENT_CARD_LEGACY_PATH again after the change. The scan needs no account; an issue found during an AI shopping test needs that test run again.
npx @tragent/cli scan https://your-store.com