feat(integrations): 添加 tool_resource 函数支持多框架集成

在多个集成模块中添加了 `tool_resource` 函数的支持，允许用户将 ToolResource 封装为不同 AI 框架所需的工具格式，包括 CrewAI、LangChain、PydanticAI、LangGraph 和 AgentScope。同时更新了相关初始化文件以导出新功能。

Co-developed-by: Aone Copilot <noreply@alibaba-inc.com>
Signed-off-by: Sodawyx <sodawyx@126.com>

Author: Sodawyx

agentrun/integration/agentscope/__init__.py

@@ -3,11 +3,18 @@
 提供 AgentRun 模型与沙箱工具的 AgentScope 适配入口。 / 提供 AgentRun 模型with沙箱工具的 AgentScope 适配入口。
 """
 
-from .builtin import knowledgebase_toolset, model, sandbox_toolset, toolset
+from .builtin import (
+    knowledgebase_toolset,
+    model,
+    sandbox_toolset,
+    tool_resource,
+    toolset,
+)
 
 __all__ = [
     "model",
     "toolset",
     "sandbox_toolset",
     "knowledgebase_toolset",
+    "tool_resource",
 ]

agentrun/integration/agentscope/builtin.py

@@ -14,10 +14,12 @@
 from agentrun.integration.builtin import model as _model
 from agentrun.integration.builtin import ModelArgs
 from agentrun.integration.builtin import sandbox_toolset as _sandbox_toolset
+from agentrun.integration.builtin import tool_resource as _tool_resource
 from agentrun.integration.builtin import toolset as _toolset
 from agentrun.integration.utils.tool import Tool
 from agentrun.model import ModelProxy, ModelService
 from agentrun.sandbox import TemplateType
+from agentrun.tool.tool import Tool as ToolResourceType
 from agentrun.toolset import ToolSet
 from agentrun.utils.config import Config
 
@@ -50,6 +52,24 @@ def toolset(
     )
 
 
+def tool_resource(
+    name: Union[str, ToolResourceType],
+    *,
+    prefix: Optional[str] = None,
+    modify_tool_name: Optional[Callable[[Tool], Tool]] = None,
+    filter_tools_by_name: Optional[Callable[[str], bool]] = None,
+    config: Optional[Config] = None,
+) -> List[Any]:
+    """将 ToolResource 封装为 AgentScope 工具列表。 / AgentScope Built-in ToolResource Integration"""
+
+    ts = _tool_resource(input=name, config=config)
+    return ts.to_agentscope(
+        prefix=prefix,
+        modify_tool_name=modify_tool_name,
+        filter_tools_by_name=filter_tools_by_name,
+    )
+
+
 def sandbox_toolset(
     template_name: str,
     *,

agentrun/integration/builtin/__init__.py

@@ -7,12 +7,14 @@
 from .knowledgebase import knowledgebase_toolset
 from .model import model, ModelArgs
 from .sandbox import sandbox_toolset
+from .tool_resource import tool_resource
 from .toolset import toolset
 
 __all__ = [
     "model",
     "ModelArgs",
     "toolset",
+    "tool_resource",
     "sandbox_toolset",
     "knowledgebase_toolset",
 ]

agentrun/integration/crewai/__init__.py

@@ -4,10 +4,16 @@
 CrewAI 与 LangChain 兼容，因此直接复用 LangChain 的转换逻辑。 / CrewAI with LangChain 兼容，因此直接复用 LangChain 的转换逻辑。
 """
 
-from .builtin import knowledgebase_toolset, model, sandbox_toolset
+from .builtin import (
+    knowledgebase_toolset,
+    model,
+    sandbox_toolset,
+    tool_resource,
+)
 
 __all__ = [
     "model",
     "sandbox_toolset",
     "knowledgebase_toolset",
+    "tool_resource",
 ]

agentrun/integration/crewai/builtin.py

@@ -14,10 +14,12 @@
 from agentrun.integration.builtin import model as _model
 from agentrun.integration.builtin import ModelArgs
 from agentrun.integration.builtin import sandbox_toolset as _sandbox_toolset
+from agentrun.integration.builtin import tool_resource as _tool_resource
 from agentrun.integration.builtin import toolset as _toolset
 from agentrun.integration.utils.tool import Tool
 from agentrun.model import ModelProxy, ModelService
 from agentrun.sandbox import TemplateType
+from agentrun.tool.tool import Tool as ToolResourceType
 from agentrun.toolset import ToolSet
 from agentrun.utils.config import Config
 
@@ -50,6 +52,24 @@ def toolset(
     )
 
 
+def tool_resource(
+    name: Union[str, ToolResourceType],
+    *,
+    prefix: Optional[str] = None,
+    modify_tool_name: Optional[Callable[[Tool], Tool]] = None,
+    filter_tools_by_name: Optional[Callable[[str], bool]] = None,
+    config: Optional[Config] = None,
+) -> List[Any]:
+    """将 ToolResource 封装为 CrewAI 工具列表。 / CrewAI Built-in ToolResource Integration"""
+
+    ts = _tool_resource(input=name, config=config)
+    return ts.to_crewai(
+        prefix=prefix,
+        modify_tool_name=modify_tool_name,
+        filter_tools_by_name=filter_tools_by_name,
+    )
+
+
 def sandbox_toolset(
     template_name: str,
     *,

agentrun/integration/google_adk/__init__.py

@@ -3,11 +3,18 @@
 提供与 Google Agent Development Kit 的模型与沙箱工具集成。 / 提供with Google Agent Development Kit 的模型with沙箱工具集成。
 """
 
-from .builtin import knowledgebase_toolset, model, sandbox_toolset, toolset
+from .builtin import (
+    knowledgebase_toolset,
+    model,
+    sandbox_toolset,
+    tool_resource,
+    toolset,
+)
 
 __all__ = [
     "model",
     "toolset",
     "sandbox_toolset",
     "knowledgebase_toolset",
+    "tool_resource",
 ]

agentrun/integration/google_adk/builtin.py

@@ -14,10 +14,12 @@
 from agentrun.integration.builtin import model as _model
 from agentrun.integration.builtin import ModelArgs
 from agentrun.integration.builtin import sandbox_toolset as _sandbox_toolset
+from agentrun.integration.builtin import tool_resource as _tool_resource
 from agentrun.integration.builtin import toolset as _toolset
 from agentrun.integration.utils.tool import Tool
 from agentrun.model import ModelProxy, ModelService
 from agentrun.sandbox import TemplateType
+from agentrun.tool.tool import Tool as ToolResourceType
 from agentrun.toolset import ToolSet
 from agentrun.utils.config import Config
 
@@ -50,6 +52,24 @@ def toolset(
     )
 
 
+def tool_resource(
+    name: Union[str, ToolResourceType],
+    *,
+    prefix: Optional[str] = None,
+    modify_tool_name: Optional[Callable[[Tool], Tool]] = None,
+    filter_tools_by_name: Optional[Callable[[str], bool]] = None,
+    config: Optional[Config] = None,
+) -> List[Any]:
+    """将 ToolResource 封装为 Google ADK 工具列表。 / Google ADK Built-in ToolResource Integration"""
+
+    ts = _tool_resource(input=name, config=config)
+    return ts.to_google_adk(
+        prefix=prefix,
+        modify_tool_name=modify_tool_name,
+        filter_tools_by_name=filter_tools_by_name,
+    )
+
+
 def sandbox_toolset(
     template_name: str,
     *,

agentrun/integration/langchain/__init__.py

@@ -20,12 +20,19 @@
     AgentRunConverter,
 )  # 向后兼容
 
-from .builtin import knowledgebase_toolset, model, sandbox_toolset, toolset
+from .builtin import (
+    knowledgebase_toolset,
+    model,
+    sandbox_toolset,
+    tool_resource,
+    toolset,
+)
 
 __all__ = [
     "AgentRunConverter",
     "model",
     "toolset",
     "sandbox_toolset",
     "knowledgebase_toolset",
+    "tool_resource",
 ]

agentrun/integration/langchain/builtin.py

@@ -14,10 +14,12 @@
 from agentrun.integration.builtin import model as _model
 from agentrun.integration.builtin import ModelArgs
 from agentrun.integration.builtin import sandbox_toolset as _sandbox_toolset
+from agentrun.integration.builtin import tool_resource as _tool_resource
 from agentrun.integration.builtin import toolset as _toolset
 from agentrun.integration.utils.tool import Tool
 from agentrun.model import ModelProxy, ModelService
 from agentrun.sandbox import TemplateType
+from agentrun.tool.tool import Tool as ToolResourceType
 from agentrun.toolset import ToolSet
 from agentrun.utils.config import Config
 
@@ -50,6 +52,24 @@ def toolset(
     )
 
 
+def tool_resource(
+    name: Union[str, ToolResourceType],
+    *,
+    prefix: Optional[str] = None,
+    modify_tool_name: Optional[Callable[[Tool], Tool]] = None,
+    filter_tools_by_name: Optional[Callable[[str], bool]] = None,
+    config: Optional[Config] = None,
+) -> List[Any]:
+    """将 ToolResource 封装为 LangChain ``StructuredTool`` 列表。 / LangChain Built-in ToolResource Integration"""
+
+    ts = _tool_resource(input=name, config=config)
+    return ts.to_langchain(
+        prefix=prefix,
+        modify_tool_name=modify_tool_name,
+        filter_tools_by_name=filter_tools_by_name,
+    )
+
+
 def sandbox_toolset(
     template_name: str,
     *,

agentrun/integration/langgraph/__init__.py

@@ -25,12 +25,19 @@
 """
 
 from .agent_converter import AgentRunConverter
-from .builtin import knowledgebase_toolset, model, sandbox_toolset, toolset
+from .builtin import (
+    knowledgebase_toolset,
+    model,
+    sandbox_toolset,
+    tool_resource,
+    toolset,
+)
 
 __all__ = [
     "AgentRunConverter",
     "model",
     "toolset",
     "sandbox_toolset",
     "knowledgebase_toolset",
+    "tool_resource",
 ]