datafile sample

File Sample

file_sample

Selects a small random sample of local files from a directory. Use when an agent needs representative files for exploration without reading an entire tree. Scope: local filesystem only and read-only; skips common dependency/build directories. Set seed for a reproducible sample.

How to use file_sample

Provide only the required inputs below. Start with the smallest scope that answers the task, then review the risk properties before an agent executes the call.

Risk and execution properties

Read only: yes

Destructive: no

Idempotent: yes

Open world: no — operates locally or through configured services

Inputs

pathstringrequired

Directory to sample.

countinteger

Number of paths to return. Max: 100.

Default: 5

file_extensionsarray

Optional extension filter.

seedstring

Optional seed for reproducible selection.

Example input

{
  "path": "<string>",
  "count": 5,
  "file_extensions": "<array>",
  "seed": "<string>"
}

Browse or search the full 74-tool reference to choose the smallest suitable capability.

Browse all tools →