CodesnipToolkit

https://github.com/bytedance/SandboxFusion https://bytedance.github.io/SandboxFusion/docs/docs/get-started

CodesnipToolkit

Bases: AsyncBaseToolkit

源代码位于： utu/tools/codesnip_toolkit.py

class CodesnipToolkit(AsyncBaseToolkit):
    def __init__(self, config: ToolkitConfig = None) -> None:
        super().__init__(config)
        self.server_url = self.config.config.get("server_url")

    @register_tool
    async def run_code(self, code: str, language: str = "python") -> str:
        """Run code in sandbox and return the result.
        Supported languages: python, cpp, nodejs, go, go_test, java, php, csharp, bash, typescript, sql, rust, cuda,
         lua, R, perl, D_ut, ruby, scala, julia, pttest, junit, kotlin_script, jest, verilog, python_gpu, lean, swift,
         racket

        Args:
            code (str): The code to run.
            language (str, optional): The language of the code. Defaults to "python".
        Returns:
            str: The result of the code.
        """
        payload = {
            "code": code,
            "language": language,
        }
        response = requests.post(f"{self.server_url}/run_code", json=payload)
        result = response.json()
        logger.info(f"[tool] run_code ```{oneline_object(payload)}``` got result: {oneline_object(result)}")
        return str(result)

tools_map property

tools_map: dict[str, Callable]

Lazy loading of tools map. - collect tools registered by @register_tool

run_code async

run_code(code: str, language: str = 'python') -> str

Run code in sandbox and return the result. Supported languages: python, cpp, nodejs, go, go_test, java, php, csharp, bash, typescript, sql, rust, cuda, lua, R, perl, D_ut, ruby, scala, julia, pttest, junit, kotlin_script, jest, verilog, python_gpu, lean, swift, racket

参数：

名称	类型	描述	默认
code	str	The code to run.	必需
language	str	The language of the code. Defaults to "python".	'python'

Returns: str: The result of the code.

源代码位于： utu/tools/codesnip_toolkit.py

@register_tool
async def run_code(self, code: str, language: str = "python") -> str:
    """Run code in sandbox and return the result.
    Supported languages: python, cpp, nodejs, go, go_test, java, php, csharp, bash, typescript, sql, rust, cuda,
     lua, R, perl, D_ut, ruby, scala, julia, pttest, junit, kotlin_script, jest, verilog, python_gpu, lean, swift,
     racket

    Args:
        code (str): The code to run.
        language (str, optional): The language of the code. Defaults to "python".
    Returns:
        str: The result of the code.
    """
    payload = {
        "code": code,
        "language": language,
    }
    response = requests.post(f"{self.server_url}/run_code", json=payload)
    result = response.json()
    logger.info(f"[tool] run_code ```{oneline_object(payload)}``` got result: {oneline_object(result)}")
    return str(result)

get_tools_map_func

get_tools_map_func() -> dict[str, Callable]

Get tools map. It will filter tools by config.activated_tools if it is not None.

源代码位于： utu/tools/base.py

def get_tools_map_func(self) -> dict[str, Callable]:
    """Get tools map. It will filter tools by config.activated_tools if it is not None."""
    if self.config.activated_tools:
        assert all(tool_name in self.tools_map for tool_name in self.config.activated_tools), (
            f"Error config activated tools: {self.config.activated_tools}! available tools: {self.tools_map.keys()}"
        )
        tools_map = {tool_name: self.tools_map[tool_name] for tool_name in self.config.activated_tools}
    else:
        tools_map = self.tools_map
    return tools_map

get_tools_in_agents

get_tools_in_agents() -> list[FunctionTool]

Get tools in openai-agents format.

源代码位于： utu/tools/base.py

def get_tools_in_agents(self) -> list[FunctionTool]:
    """Get tools in openai-agents format."""
    tools_map = self.get_tools_map_func()
    tools = []
    for _, tool in tools_map.items():
        tools.append(
            function_tool(
                tool,
                strict_mode=False,  # turn off strict mode
            )
        )
    return tools

get_tools_in_openai

get_tools_in_openai() -> list[dict]

Get tools in OpenAI format.

源代码位于： utu/tools/base.py

def get_tools_in_openai(self) -> list[dict]:
    """Get tools in OpenAI format."""
    tools = self.get_tools_in_agents()
    return [ChatCompletionConverter.tool_to_openai(tool) for tool in tools]

get_tools_in_mcp

get_tools_in_mcp() -> list[Tool]

Get tools in MCP format.

源代码位于： utu/tools/base.py

def get_tools_in_mcp(self) -> list[types.Tool]:
    """Get tools in MCP format."""
    tools = self.get_tools_in_agents()
    return [MCPConverter.function_tool_to_mcp(tool) for tool in tools]

call_tool async

call_tool(name: str, arguments: dict) -> str

Call a tool by its name.

源代码位于： utu/tools/base.py

async def call_tool(self, name: str, arguments: dict) -> str:
    """Call a tool by its name."""
    tools_map = self.get_tools_map_func()
    if name not in tools_map:
        raise ValueError(f"Tool {name} not found")
    tool = tools_map[name]
    return await tool(**arguments)