Skip to content

AI Skills

Soliplex loads instruction-only Agent Skills as native Pydantic AI capabilities.

See:

Filesystem-based skills are loaded from directories containing a SKILL.md specification file.

Configuring Filesystem Skill Search Paths

At the installation level, define the directories to be searched for SKILL.md spec files using the filesystem_skills_paths entry in the installation configuration file.

Discovered filesystem skills can be queried using the InstallationConfig.available_filesystem_skill_configs attribute.

Selecting Available Skills

All discovered skills are enabled by default. To restrict an installation to selected skills, use the skill_configs stanza in the installation configuration file.

Configuring Room-Specific Skills

Soliplex also provides native capability configuration types for RAG and sandbox execution. Because these capabilities require room-specific parameters, they are defined using the skill_configs stanza of the room configuration's skills entry.

bwrap_sandbox

skills:
  skill_configs:
    - kind: "bwrap_sandbox"
      environment: "pandas-only"
      execution_timeout_seconds: 60.0
      max_output_chars: 20000

  • environment (optional, default bare) -- the sandbox environment every execution in this room runs in, named after a subdirectory of the installation's environments_path. The model does not select it.

  • execution_timeout_seconds (optional, default 30.0) -- how long one execution may run before it is cut off.

  • max_output_chars (optional, default 10000) -- how much of each of an execution's output streams reaches the model. Output past it is truncated. Where the model is told to put the rest depends on the installation's workdirs_path: a file under /sandbox/work when that workspace persists, and a printed summary when it does not.

  • volumes (optional) -- extra host directories to mount, keyed by the name they take under /sandbox/volumes:

    volumes:
      reference:
        host_path: /srv/reference
        writable: false