Skip to content

docs(graphs): clarify dynamic node parameter binding - #2181

Open
LeonMAG wants to merge 1 commit into
google:mainfrom
LeonMAG:docs/clarify-dynamic-node-binding
Open

docs(graphs): clarify dynamic node parameter binding#2181
LeonMAG wants to merge 1 commit into
google:mainfrom
LeonMAG:docs/clarify-dynamic-node-binding

Conversation

@LeonMAG

@LeonMAG LeonMAG commented Aug 27, 2026

Copy link
Copy Markdown

Description

Clarifies the dynamic workflow data-handling example so a function can use a domain-specific parameter name without reading it from workflow state.

With city: str, ADK's default state binding looks for ctx.state["city"] and the workflow fails before the reporting agent runs. The example now uses explicit input binding and passes a dictionary with the matching city key.

Changes

  1. Explain the difference between workflow-state binding and named input binding.

  2. Configure city_time_function to bind its named input explicitly.

  3. Pass matching dictionaries in both uses of the helper and preserve the agent → function → agent flow.

Verification

  • mkdocs build --strict --clean
  • Verified the binding behavior against the official Google ADK v2.6.3 source: the current scalar form fails with a missing city state value, while explicit input binding maps {"city": "Paris"} to city.

Fixes #2100

@google-cla

google-cla Bot commented Aug 27, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Can nodes use other argument names than node_input?

1 participant