Skip to content

Agent Card inaccessible via legacy path after a2a-sdk upgrade #2535

@ftnext

Description

@ftnext

Describe the bug
When using get_fast_api_app(a2a=True)1 to serve a remote agent, the Agent Card becomes inaccessible via the legacy path /.well-known/agent.json after upgrading a2a-sdk from v0.2.x to v0.3.x. This breaks backward compatibility for existing clients that expect the old Agent Card path.

To Reproduce
Steps to reproduce the behavior:

  1. Install a2a-sdk v0.2.x and google-adk
  2. Create a remote agent using get_fast_api_app(a2a=True)
  3. Verify Agent Card is accessible at /.well-known/agent.json
  4. Upgrade a2a-sdk to v0.3.x
  5. Restart the agent server
  6. Access /.well-known/agent.json - returns 404 error
  7. Access /.well-known/agent-card.json - works correctly

Expected behavior
The Agent Card should be accessible via both the new path (/.well-known/agent-card.json) and the legacy path (/.well-known/agent.json) to maintain backward compatibility, similar to how a2a-sdk itself handles this transition.

Screenshots
N/A

Desktop (please complete the following information):

  • OS: macOS
  • Python version: 3.13.0
  • ADK version: 1.10.0
  • a2a-sdk version: v0.3.1

Model Information:
Any model can be used to reproduce this issue.

Additional context

Proposed solution
Add support for PREV_AGENT_CARD_WELL_KNOWN_PATH from a2a-sdk to serve the Agent Card on both the current and legacy paths, maintaining backward compatibility similar to a2a-sdk's approach.

Metadata

Metadata

Assignees

Labels

bot triaged[Bot] This issue is triaged by ADK botweb[Component] This issue will be transferred to adk-web

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions