From f511352508e9f57fe9e2f0f33e9d7692361586cf Mon Sep 17 00:00:00 2001 From: Shangjie Chen Date: Wed, 5 Nov 2025 19:30:19 -0800 Subject: [PATCH] chore: Clarify the usage of agent_state Co-authored-by: Shangjie Chen PiperOrigin-RevId: 828733706 --- src/google/adk/events/event_actions.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/google/adk/events/event_actions.py b/src/google/adk/events/event_actions.py index da55c873..d79a71a7 100644 --- a/src/google/adk/events/event_actions.py +++ b/src/google/adk/events/event_actions.py @@ -100,10 +100,11 @@ class EventActions(BaseModel): end_of_agent: Optional[bool] = None """If true, the current agent has finished its current run. Note that there can be multiple events with end_of_agent=True for the same agent within one - invocation when there is a loop.""" + invocation when there is a loop. This should only be set by ADK workflow.""" agent_state: Optional[dict[str, Any]] = None - """The agent state at the current event.""" + """The agent state at the current event, used for checkpoint and resume. This + should only be set by ADK workflow.""" rewind_before_invocation_id: Optional[str] = None """The invocation id to rewind to. This is only set for rewind event."""