fix(transfer_to_agent): update docstring for clarity and accuracy

AlankritVerma01 · copybara-github · commit 854a54406145 · 2025-05-29T16:57:27.000-07:00
Copybara import of the project: -- e246af5 by Alankrit Verma <alankrit386@gmail.com>: tools: allow transfer_to_agent to accept extra kwargs transfer_to_agent now takes **kwargs to swallow unexpected keyword args Added integration tests covering single and multiple extra kwargs. Fixes google#458. -- 55fea78 by Alankrit Verma <alankrit386@gmail.com>: fix(tests): correct indentation in test_transfer.py for better readability -- 0c04f2d by Alankrit Verma <alankrit386@gmail.com>: fix(transfer_to_agent): restore strict two-arg signature and clarify usage Revert the earlier **kwargs change so transfer_to_agent again only accepts (agent_name, tool_context). Improve the doc-string to make clear that no other parameters should be passed to this tool. Fixes google#458 -- d37448d by Alankrit Verma <alankrit386@gmail.com>: fix(transfer_to_agent): update docstring for clarity and accuracy -- ea827af by Wei Sun (Jack) <Jacksunwei@gmail.com>: Update transfer_to_agent_tool docstring for better prompt -- a144069 by Wei Sun (Jack) <Jacksunwei@gmail.com>: Update transfer_to_agent_tool.py COPYBARA_INTEGRATE_REVIEW=google#466 from AlankritVerma01:tools/transfer-accept-kwargs 686d436 PiperOrigin-RevId: 764940463
diff --git a/src/google/adk/tools/transfer_to_agent_tool.py b/src/google/adk/tools/transfer_to_agent_tool.py
@@ -16,5 +16,12 @@
 
 
 def transfer_to_agent(agent_name: str, tool_context: ToolContext):
-  """Transfer the question to another agent."""
+  """Transfer the question to another agent.
+
+  This tool hands off control to another agent when it's more suitable to 
+  answer the user's question according to the agent's description.
+  
+  Args:
+    agent_name: the agent name to transfer to.
+  """
   tool_context.actions.transfer_to_agent = agent_name
