This PR implements modifiable tool names and descriptions for both StaticWorkbench and McpWorkbench as requested in the issue. The implementation allows users to customize how tools appear to consumers while maintaining the underlying tool functionality.

Key Features

ToolOverride Model

• New ToolOverride Pydantic model with optional name and description fields
• Supports partial overrides (name only, description only, or both)
• Full serialization/deserialization support

StaticWorkbench Enhancements

• Optional tool_overrides parameter in constructor
• Applies overrides in list_tools() while preserving original tool parameters
• Maps override names back to original names in call_tool() for seamless execution
• Conflict detection prevents duplicate or conflicting override names
• Maintains backward compatibility - existing code continues to work unchanged

McpWorkbench Enhancements

• Client-side tool override mapping for server-side tools
• Override names are mapped back to original server tool names during execution
• Duplicate override name validation
• Preserves all existing MCP functionality

Usage Examples

from autogen_core.tools import StaticWorkbench, ToolOverride

# StaticWorkbench with overrides
overrides = {
    "multiply": ToolOverride(name="calculate_product", description="Advanced multiplication tool"),
    "format": ToolOverride(description="Enhanced text formatting")  # Description only
}
workbench = StaticWorkbench(tools=[multiply_tool, format_tool], tool_overrides=overrides)

# Tools appear with new names/descriptions
tools = await workbench.list_tools()
# tools[0]["name"] == "calculate_product" 
# tools[0]["description"] == "Advanced multiplication tool"

# Call using override name
result = await workbench.call_tool("calculate_product", {"a": 6, "b": 7})

from autogen_ext.tools.mcp import McpWorkbench, ToolOverride

# McpWorkbench with server tool overrides
overrides = {
    "fetch": ToolOverride(name="web_scraper", description="Advanced web content fetching")
}
workbench = McpWorkbench(server_params=params, tool_overrides=overrides)

# Server's "fetch" tool appears as "web_scraper" with new description
# Calls to "web_scraper" are automatically mapped to server's "fetch" tool

Implementation Details

• Reverse mapping: Efficient lookup from override names to original names for tool execution
• Conflict detection: Validates that override names don't conflict with existing tool names or duplicate other overrides
• Type safety: Proper TypedDict handling for ToolSchema creation
• Error handling: Clear error messages for conflicts and missing tools
• Serialization: Full support for saving/loading workbench configurations with overrides

Testing

• Comprehensive test suite covering all functionality and edge cases
• Conflict detection validation
• Serialization/deserialization testing
• Partial override scenarios
• Backward compatibility verification

Backward Compatibility

All existing code continues to work without changes. The tool_overrides parameter is optional and defaults to no overrides.

Fixes #6689.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.