Back to catalog / Agent interoperability
Configure interceptors and response conversion for a remote A2A agent
Control outbound requests, required auth headers, and conversion of remote replies to local events when calling a remote agent.
Goal
Connect to a remote A2A agent while keeping request boundaries and response handling reviewable.
Steps
- Verify the remote agent card, advertised capabilities, and expected service domain. [a2a]
- Set
request_interceptors,card_request_interceptors, and response converters inRemoteA2aAgent(config=A2aRemoteAgentConfig(...)). [a2a] - Limit data sent to the remote agent and validate response events before returning them to the caller. [a2a]
- Test success, timeout, and malformed-response cases against a test endpoint without leaking auth headers. [a2a]
How to verify
Outbound requests use only the intended domain and least privilege; response events match the local contract and credentials stay out of logs.
Troubleshooting
If a reply cannot be mapped, check the event converter and protocol version; for auth failures inspect the credential provider, not hard-coded tokens.
Permissions
Prerequisites
- Python 3.11+, google-adk compatible with the pinned revision, and an isolated test environment
- Configured model-provider credentials for live inference; never place them in code or logs
Permissions
- Use authorized test data only; isolate sessions and credentials per user; obtain human authorization before external side effects
Limitations
This procedure follows Google ADK at the pinned revision; other versions, models, or remote services may differ in APIs and event semantics. Recheck permissions, retention, and recovery before production.
Pinned upstream source
- Repository
- google/adk-python
- File path
- docs/guides/a2a/agent/config/index.md
- Pinned commit
e9b74d36140f2594b24c481fb7a3825b2cb01e96- Source checked
- 2026-10-14 · Reviewed against the pinned upstream source
Repository metrics
These values describe the upstream repository, not popularity or likes for an individual skill or playbook.
- Stars
- Not collected
- Forks
- Not collected
- Observed at
- Not collected
No metrics snapshot is available yet.
License: Apache-2.0
Main topic
Make Agent behavior safer and easier to verify