Open
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
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
2 participants
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)