A programming framework for agentic AI
Accept path for work_dir in LocalCommandLineCodeExecutor (#1909)
Jack Gerritsf4f9e6c27e4d
diff --git a/autogen/coding/local_commandline_code_executor.py b/autogen/coding/local_commandline_code_executor.pyindex e4712b3dc..e671337bf 100644--- a/autogen/coding/local_commandline_code_executor.py+++ b/autogen/coding/local_commandline_code_executor.py@@ -1,13 +1,14 @@import os+from pathlib import Pathimport reimport uuidimport warnings-from typing import Any, ClassVar, List, Optional-from pydantic import BaseModel, Field, field_validator+from typing import ClassVar, List, Optional, Union+from pydantic import Fieldfrom ..agentchat.agent import LLMAgentfrom ..code_utils import execute_code-from .base import CodeBlock, CodeExtractor, CodeResult+from .base import CodeBlock, CodeExecutor, CodeExtractor, CodeResultfrom .markdown_code_extractor import MarkdownCodeExtractor__all__ = (@@ -25,33 +26,7 @@ class CommandLineCodeResult(CodeResult):)-class LocalCommandLineCodeExecutor(BaseModel):- """(Experimental) A code executor class that executes code through a local command line- environment.-- **This will execute LLM generated code on the local machine.**-- Each code block is saved as a file and executed in a separate process in- the working directory, and a unique file is generated and saved in the- working directory for each code block.- The code blocks are executed in the order they are received.- Command line code is sanitized using regular expression match against a list of dangerous commands in order to prevent self-destructive- commands from being executed which may potentially affect the users environment.- Currently the only supported languages is Python and shell scripts.- For Python code, use the language "python" for the code block.- For shell scripts, use the language "bash", "shell", or "sh" for the code- block.-- Args:- timeout (int): The timeout for code execution. Default is 60.- work_dir (str): The working directory for the code execution. If None,- a default working directory will be used. The default working- directory is the current directory ".".- system_message_update (str): The system message update for agent that- produces code to run on this executor.- Default is `LocalCommandLineCodeExecutor.DEFAULT_SYSTEM_MESSAGE_UPDATE`.- """-+class LocalCommandLineCodeExecutor(CodeExecutor):DEFAULT_SYSTEM_MESSAGE_UPDATE: ClassVar[str] = """@@ -64,12 +39,51 @@ When using code, you must indicate the script type in the code block. The user cIf you want the user to save the code in a file before executing it, put # filename: <filename> inside the code block as the first line. Don't include multiple code blocks in one response. Do not ask users to copy and paste the result. Instead, use 'print' function for the output when relevant. Check the execution result returned by the user."""- timeout: int = Field(default=60, ge=1, description="The timeout for code execution.")- work_dir: str = Field(default=".", description="The working directory for the code execution.")- system_message_update: str = Field(- default=DEFAULT_SYSTEM_MESSAGE_UPDATE,- description="The system message update for agent that produces code to run on this executor.",- )+ def __init__(+ self,+ timeout: int = 60,+ work_dir: Union[Path, str] = Path("."),+ system_message_update: str = DEFAULT_SYSTEM_MESSAGE_UPDATE,+ ):+ """(Experimental) A code executor class that executes code through a local command line+ environment.++ **This will execute LLM generated code on the local machine.**++ Each code block is saved as a file and executed in a separate process in+ the working directory, and a unique file is generated and saved in the+ working directory for each code block.+ The code blocks are executed in the order they are received.+ Command line code is sanitized using regular expression match against a list of dangerous commands in order to prevent self-destructive+ commands from being executed which may potentially affect the users environment.+ Currently the only supported languages is Python and shell scripts.+ For Python code, use the language "python" for the code block.+ For shell scripts, use the language "bash", "shell", or "sh" for the code+ block.++ Args:+ timeout (int): The timeout for code execution. Default is 60.+ work_dir (str): The working directory for the code execution. If None,+ a default working directory will be used. The default working+ directory is the current directory ".".+ system_message_update (str): The system message update for agent that+ produces code to run on this executor.+ Default is `LocalCommandLineCodeExecutor.DEFAULT_SYSTEM_MESSAGE_UPDATE`.++ """++ if timeout < 1:+ raise ValueError("Timeout must be greater than or equal to 1.")++ if isinstance(work_dir, str):+ work_dir = Path(work_dir)++ if not work_dir.exists():+ raise ValueError(f"Working directory {work_dir} does not exist.")++ self._timeout = timeout+ self._work_dir: Path = work_dir+ self._system_message_update = system_message_updateclass UserCapability:"""An AgentCapability class that gives agent ability use a command line@@ -84,18 +98,21 @@ If you want the user to save the code in a file before executing it, put # filenmessage."""agent.update_system_message(agent.system_message + self.system_message_update)- @field_validator("work_dir")- @classmethod- def _check_work_dir(cls, v: str) -> str:- if os.path.exists(v):- return v- raise ValueError(f"Working directory {v} does not exist.")-@propertydef user_capability(self) -> "LocalCommandLineCodeExecutor.UserCapability":"""Export a user capability for this executor that can be added toan agent that produces code to be executed by this executor."""- return LocalCommandLineCodeExecutor.UserCapability(self.system_message_update)+ return LocalCommandLineCodeExecutor.UserCapability(self._system_message_update)++ @property+ def timeout(self) -> int:+ """(Experimental) The timeout for code execution."""+ return self._timeout++ @property+ def work_dir(self) -> Path:+ """(Experimental) The working directory for the code execution."""+ return self._work_dir@propertydef code_extractor(self) -> CodeExtractor:@@ -133,7 +150,7 @@ If you want the user to save the code in a file before executing it, put # filenReturns:CommandLineCodeResult: The result of the code execution."""logs_all = ""- for i, code_block in enumerate(code_blocks):+ for code_block in code_blocks:lang, code = code_block.language, code_block.codeLocalCommandLineCodeExecutor.sanitize_command(lang, code)@@ -144,8 +161,8 @@ If you want the user to save the code in a file before executing it, put # filenexitcode, logs, _ = execute_code(code=code,lang=lang,- timeout=self.timeout,- work_dir=self.work_dir,+ timeout=self._timeout,+ work_dir=str(self._work_dir),filename=filename,use_docker=False,)@@ -154,8 +171,8 @@ If you want the user to save the code in a file before executing it, put # filenexitcode, logs, _ = execute_code(code=code,lang="python",- timeout=self.timeout,- work_dir=self.work_dir,+ timeout=self._timeout,+ work_dir=str(self._work_dir),filename=filename,use_docker=False,)@@ -165,7 +182,8 @@ If you want the user to save the code in a file before executing it, put # filenlogs_all += "\n" + logsif exitcode != 0:break- code_filename = os.path.join(self.work_dir, filename) if filename is not None else None++ code_filename = str(self._work_dir / filename) if filename is not None else Nonereturn CommandLineCodeResult(exit_code=exitcode, output=logs_all, code_file=code_filename)def restart(self) -> None:diff --git a/website/docs/topics/code-execution/cli-code-executor.ipynb b/website/docs/topics/code-execution/cli-code-executor.ipynbindex 60b50ab02..40fc5f08a 100644--- a/website/docs/topics/code-execution/cli-code-executor.ipynb+++ b/website/docs/topics/code-execution/cli-code-executor.ipynb@@ -95,7 +95,7 @@"work_dir = Path(\"coding\")\n","work_dir.mkdir(exist_ok=True)\n","\n",- "executor = LocalCommandLineCodeExecutor(work_dir=str(work_dir))\n",+ "executor = LocalCommandLineCodeExecutor(work_dir=work_dir)\n","print(\n"," executor.execute_code_blocks(\n"," code_blocks=[\n",@@ -354,7 +354,7 @@"name": "python","nbconvert_exporter": "python","pygments_lexer": "ipython3",- "version": "3.11.5"+ "version": "3.11.7"}},"nbformat": 4,