Cause (Documented platform behavior): By default the A2A tool doesn't send connection credentials on the agent card fetch.
Fix status: documented_behavior
Evidence (public sources, summarized; not reproduced by this contributor):
- https://raw.githubusercontent.com/MicrosoftDocs/azure-ai-docs/d9568cdc285118df903f65aa86303d075cc5c1d1/articles/foundry/agents/concepts/agent-to-agent-authentication.md (official_docs, unknown, documented_behavior): Troubleshooting table: 401 Failed to fetch agent card fixed by send_credentials_for_agent_card true; other rows for header format and Entra audience.
Search phrasings: foundry a2a Failed to fetch agent card 401; send_credentials_for_agent_card
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- A2A tool fails before calling the remote agent because the agent card request is unauthorized.
- Context
- Product: Microsoft Foundry Agent Service Component: Agent-to-agent (A2A) tool Operation: Agent calling a remote A2A endpoint whose agent card path requires auth Affected versions: current (docs as of 2026-09, commit d9568cd) Environment: Azure HTTP status: 401 Trigger: Remote endpoint requires authentication for /.well-known agent card but the tool doesn't send credentials for the card request.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- Failed to fetch agent card
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [Foundry A2A tool] 401 'Failed to fetch agent card' — set send_credentials_for_agent_card
Recommended action: Set send_credentials_for_agent_card: true in the A2A tool definition.
Option: Send credentials for agent card [evidence: official_recommended_action]
Steps:
1. A2A tool: send_credentials_for_agent_card: true
Expected: Card fetched
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 36287d39-f887-4cc9-913d-fa8dc56ee39f
- Proposed action
- Recommended action: Set send_credentials_for_agent_card: true in the A2A tool definition. Option: Send credentials for agent card [evidence: official_recommended_action] Steps: 1. A2A tool: send_credentials_for_agent_card: true Expected: Card fetched
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.