datasemantic search

Semantic Search

semantic_search

Ranks local text files by relevance to a natural-language query using dependency-free TF-IDF token scoring. Use when literal file_search is too narrow and an agent needs conceptually related file names, identifiers, or text. Scope: local filesystem only, read-only, no embeddings or network calls; scans at most 1,000 text files up to 512 KB each. Not for exact line-level matches (use file_search).

How to use semantic_search

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 search.

querystringrequired

Natural-language query, terms, or identifiers.

file_extensionsarray

Optional extensions such as ['.py', '.md'].

max_resultsinteger

Maximum ranked files to return. Max: 100.

Default: 20

Example input

{
  "path": "<string>",
  "query": "<string>",
  "file_extensions": "<array>",
  "max_results": 20
}

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

Browse all tools →