Execution Environment Toolset¶

The Execution Environment toolset provides tools for executing code and shell commands within a configured environment.

Basic Usage¶

agents:
  coder:
    toolsets:
      - type: execution
        environment:
          type: local

Environment Types¶

The toolset supports various execution environments:

Local¶

Execute on the local machine:

toolsets:
  - type: execution
    environment:
      type: local
      cwd: /workspace

Docker¶

Execute in a Docker container:

toolsets:
  - type: execution
    environment:
      type: docker
      image: python:3.12
      volumes:
        /workspace: /app

Remote¶

Execute on remote machines via SSH or other protocols.

Available Tools¶

Tool	Description
`execute_code`	Execute code in a specific language
`execute_command`	Run shell commands
`start_process`	Start a background process
`get_process_output`	Get output from a running process
`wait_for_process`	Wait for process completion
`kill_process`	Terminate a running process

Tool Selection¶

You can limit which tools are exposed:

toolsets:
  - type: execution
    environment:
      type: local
    tools:
      - execute_command
      - execute_code

Configuration Reference¶

Execution Environment Toolset¶

Configuration for execution environment toolset (code + process management).

Execution Environment Toolset (YAML)
toolsets:
- type: execution
  environment: null  # Optional execution environment configuration (defaults to local).
  tools: null  # Optional tool filter to enable/disable specific tools.
  namespace: null  # Optional namespace prefix for tool names

Security Considerations¶

Use Docker or sandboxed environments for untrusted code
Limit available tools to only what's needed
Set appropriate working directories and permissions