Add Interoperable protocol and implement tool import from multiple frameworks

[davorrunje]

Why are these changes needed?

This PR introduces several new functionality to the AG2:

1. New class Tool with methods register_for_execution and register_for_llm.

2. The new Interoperable protocol to enable interoperability with other frameworks and the new Interoperability class to expose interoperability classes implementing the Interoperable protocol. The following frameworks are supported for tool import:

   • CrewAI
   • LangChain
   • Pydantic AI

Install

Available extras are: interop-crewai, interop-langchain and interop-pydantic.

An example on how to install support forCrewAI tools:

pip install ag2[interop-crewai]

Usage

An example on how to convert FileReadTool and register it for execution and LLM:

from crewai_tools import 

# create CrewAI tool
crewai_tool = FileReadTool()

# converts CrewAI tool into AG2 Tool
tool = Interoperability.convert_tool(type="crewai", tool=crewai_tool)

# register AG2 tool for LLM and execution
tool.register_for_execution(user_proxy)
tool.register_for_llm(chatbot)

The list of supported frameworks can be dynamically retrieved using the Interoperability.get_supported_types method:

supported_types = Interoperability.get_supported_types()
print(supported_types)
# expected output
# ["crewai", "langchain", "pydanticai"]

Related issue number

Closes #208

Checks

• I've included any doc changes needed for https://ag2ai.github.io/ag2/. See https://ag2ai.github.io/ag2/docs/Contribute#documentation to build and test documentation locally.
• I've added tests (if relevant) corresponding to the changes introduced in this PR.
• I've made sure all auto checks have passed.

[marklysze]

Great PR, thanks, let's go!