Repository navigation
Conversation
Demonstrate how to forward client-side session state to a remote ADK
agent over the A2A protocol via request metadata. The client uses a
RequestInterceptor to copy whitelisted state keys into A2A metadata,
and the server injects them back into session state through a
before_agent_callback so that instruction template placeholders like
{user_name} resolve correctly.
adk-bot
added
the
core
rohityan
added
the
community repo
Contributor
Author
|
Hi @rohityan, thanks for the triage! I noticed the
Would you reconsider keeping this here alongside the other A2A samples? If there's a specific concern with the PR I'm happy to address it. Thanks! |
copybara-service Bot
pushed a commit
that referenced
this pull request
Sep 9, 2026
Merge #5356 Adds a sample demonstrating how to forward client-side session state to a remote ADK agent over A2A via request metadata. PiperOrigin-RevId: 978607602
Collaborator
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
session.stateto a remote ADK agent over the A2A protocol via request metadataRequestInterceptorcopies whitelisted state keys into A2A request metadatabefore_agent_callbackreadsrun_config.custom_metadata['a2a_metadata']and injects the values back into session state so thatinstructiontemplate placeholders (e.g.{user_name}) resolve correctlyRelates to #3098
Test plan
adk api_server --a2a --port 8001 contributing/samples/a2a_state_forwarding/remote_a2aadk web contributing/samples/a2a_state_forwardingagent and send "greet me" → confirmsHello Alice! How are you doing today?is returneduser_namefromALLOWED_FORWARD_KEYS→ confirms the template remains unresolved (whitelist is effective)