agentscope.service.execute_code.exec_shell 源代码

# -*- coding: utf-8 -*-
"""Service to execute shell commands."""
import subprocess

from loguru import logger

from agentscope.service.service_status import ServiceExecStatus
from agentscope.service.service_response import ServiceResponse


[文档] def execute_shell_command(command: str) -> ServiceResponse: """ Executes a given shell command. Args: command (str): The shell command to execute. Returns: ServiceResponse: Contains either the output from the shell command as a string if sucessful, or an error message include the error type. Note: Use any bash/shell commands you want (e.g. find, grep, cat, ls), but note that : 1. interactive session commands (e.g. python, vim) or commands that change current state (e.g. cd that change the current directory) are NOT supported yet, so please do not invoke them. 2. be VERY CAREFUL when using commands that will change/edit the files current directory (e.g. rm, sed). ... """ if any(_ in command for _ in execute_shell_command.insecure_commands): logger.warning( f"The command {command} is blocked for security reasons. " f"If you want to enable the command, try to reset the " f"insecure command list by executing " f'`execute_shell_command.insecure_commands = ["xxx", "xxx"]`', ) return ServiceResponse( status=ServiceExecStatus.ERROR, content=f"The command {command} is blocked for security reasons.", ) try: result = subprocess.run( command, shell=True, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, ) return ServiceResponse( status=ServiceExecStatus.SUCCESS, content=result.stdout.strip() if result.stdout else "Success.", ) except subprocess.CalledProcessError as e: error_message = ( e.stderr.strip() if e.stderr else "An error occurred \ while executing the command." ) return ServiceResponse( status=ServiceExecStatus.ERROR, content=error_message, ) except Exception as e: return ServiceResponse( status=ServiceExecStatus.ERROR, content=str(e), )
# Security check: Block insecure commands execute_shell_command.insecure_commands = [ # System management "shutdown", "kill", "reboot", "pkill", # User management "useradd", "userdel", "usermod", # File management "rm -rf", ]