Back to Agent Zero

Agent.System.Tool.Code Exe

plugins/_code_execution/prompts/agent.system.tool.code_exe.md

1.132.7 KB
Original Source

code_execution_tool

run terminal, python, or nodejs commands args:

  • runtime: terminal, python, nodejs, or output
  • code: command or script code
  • session: terminal session id; default 0
  • reset: kill a session before running; true or false rules:
  • place the command or script in code
  • use runtime=output to poll running work
  • use input for interactive terminal prompts
  • if a session is stuck, call again with the same session and reset=true
  • check dependencies before running code
  • replace placeholder or demo data with real values before execution
  • use print() or console.log() when you need explicit output
  • do not interleave other tools while waiting
  • ignore framework [SYSTEM: ...] info in output examples: 1 terminal command
json
{
    "thoughts": [
        "Need to do...",
        "Need to install...",
    ],
    "headline": "Installing zip package via terminal",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "terminal",
        "session": 0,
        "reset": false,
        "code": "apt-get install zip",
    }
}

2 execute python code

json
{
    "thoughts": [
        "Need to do...",
        "I can use...",
        "Then I can...",
    ],
    "headline": "Executing Python code to check current directory",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "python",
        "session": 0,
        "reset": false,
        "code": "import os\nprint(os.getcwd())",
    }
}

3 execute nodejs code

json
{
    "thoughts": [
        "Need to do...",
        "I can use...",
        "Then I can...",
    ],
    "headline": "Executing Javascript code to check current directory",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "nodejs",
        "session": 0,
        "reset": false,
        "code": "console.log(process.cwd());",
    }
}

4 wait for output with long-running scripts

json
{
    "thoughts": [
        "Waiting for program to finish...",
    ],
    "headline": "Waiting for long-running program to complete",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "output",
        "session": 0,
    }
}

2 python snippet

json
{
  "thoughts": ["A short Python check is faster than using the shell."],
  "headline": "Running Python snippet",
  "tool_name": "code_execution_tool",
  "tool_args": {
    "runtime": "python",
    "session": 0,
    "reset": false,
    "code": "import os\nprint(os.getcwd())"
  }
}

3 wait for running output

json
{
  "thoughts": ["The previous command is still running, so I should poll for output."],
  "headline": "Waiting for command output",
  "tool_name": "code_execution_tool",
  "tool_args": {
    "runtime": "output",
    "session": 0
  }
}