VFS Toolset¶

The VFS (Virtual File System) toolset provides access to resources defined in your manifest's resources section. It offers a unified interface to query and read from multiple configured filesystems.

Basic Usage¶

First, define resources in your manifest:

resources:
  docs:
    type: uri
    uri: "memory://"
  data: "s3://my-bucket/data"
  code: "github://myorg:myrepo@main"

Then enable the VFS toolset:

agents:
  my_agent:
    toolsets:
      - type: vfs

Available Tools¶

Usage Examples¶

Once configured, agents can access resources like:

# List all available resources
vfs_list()

# List files in a specific resource
vfs_list("docs")

# Read a file
vfs_read("docs/guide.md")

# Read a directory recursively
vfs_read("code/src", recursive=True)

Configuration Reference¶

1
2
3

toolsets:
- type: vfs
  namespace: null  # Optional namespace prefix for tool names

When to Use VFS vs File Access¶