Class Context

src/google/adk/agents/context.py:118–925

The context within an agent run. When used in a workflow, additional fields under the ``Workflow-specific fields`` section are available.

class Context(ReadonlyContext):
  """The context within an agent run.

  When used in a workflow, additional fields under the ``Workflow-specific
  fields`` section are available.
  """

  def __init__(
      self,
      invocation_context: InvocationContext,
      *,
      # Core State & Actions
      event_actions: EventActions | None = None,
      # Tool Execution
      function_call_id: str | None = None,
      tool_confirmation: ToolConfirmation | None = None,
      # Workflow Execution
      parent_ctx: Context | None = None,
      node: BaseNode | None = None,
      node_path: str | None = None,
      run_id: str = '',
      resume_inputs: dict[str, Any] | None = None,
      attempt_count: int = 1,
      use_as_output: bool = False,
  ) -> None:
    """Initializes the Context.

    Args:
      invocation_context: The invocation context.
      event_actions: The event actions for state and artifact deltas.
      function_call_id: The function call id of the current tool call. Required
        for tool-specific methods like request_credential and
        request_confirmation.
      tool_confirmation: The tool confirmation of the current tool call.
      parent_ctx: The parent node's Context.
      node: The current node.
      node_path: The path of the current node in the workflow graph. If not
        provided, it will be derived from parent_ctx and node.
      run_id: The execution ID of the current node.
      resume_inputs: Inputs for resuming node, keyed by interrupt id.
      attempt_count: Number of times this node has been attempted.
      use_as_output: If True, this node's output also represents the parent
        node's output.
    """
    super().__init__(invocation_context)

    self._parent_ctx = parent_ctx
    self._node = node

    from ..events.event_actions import EventActions
    from ..sessions.state import State
    from ..telemetry.node_tracing import TelemetryContext

    # Core State & Actions, Event & Telemetry
    self._event_actions = event_actions or EventActions()

    computed_state_schema = None
    if node and node.state_schema: