Enh - Use handoff_description as Default Fallback for Tool Description in as_tool() of agents

[Kunmeer-SyedMohamedHyder]

Summary

Replaced the default fallback value for description_override in the as_tool() method of the Agent class from an empty string ("") to self.handoff_description. This ensures that when no explicit tool description is provided, the agent's handoff_description is used as a meaningful and human-readable default. This improves clarity, reduces the need for redundant arguments, and aligns with the DRY principle.

Issue number

Checks

• I've added new tests (if relevant)
• I've added/updated the relevant documentation
• I've run make lint and make format
• I've made sure tests pass

[seratch]

Thanks for sending this. Indeed, using an empty string as the default is not effective, but the handoff_description is meant to be used when the agent itself is the destination of the handoff. So, when this tool is used as a tool, the workflow differs.

I’m proposing to make the tool name and description required parameters to clarify things, as mentioned at #1174 (comment) I believe that’s the best way to configure agents as tools.

[Kunmeer-SyedMohamedHyder]

Right! Makes sense. Like you have mentioned in the other PR, making name and description mandatory could be a breaking change. But if we are going ahead with the mandatory fields, this PR can be closed.