Skip to content

Web search

Optional web evidence for ontology rendering and critique.

WEB_SEARCH_ENABLED

Default: false · Type: bool

Enable optional web grounding. Node execution still starts without search and only searches when node output requests it.

WEB_SEARCH_PROVIDER

Default: duckduckgo · Type: one of duckduckgo

Search engine queried for evidence when web search is enabled.

WEB_SEARCH_TOP_K

Default: 3 · Type: int

Search results fetched per query.

WEB_SEARCH_TIMEOUT_SECONDS

Default: 8.0 · Type: float

Seconds to wait for one search request, rounded down to whole seconds.

WEB_SEARCH_MAX_SNIPPET_CHARS

Default: 400 · Type: int

Characters kept from each result's snippet; the rest is cut.

WEB_SEARCH_MAX_TOTAL_CHARS

Default: 1800 · Type: int

Characters of search evidence added to one prompt, across all results.

WEB_SEARCH_ONTOLOGY_RENDER_ENABLED

Default: true · Type: bool

Allow search-eligible retries for ontology render prompts (first pass remains no-search).

WEB_SEARCH_ONTOLOGY_CRITIC_ENABLED

Default: true · Type: bool

Allow search-eligible retries for ontology critic prompts (first pass remains no-search).

WEB_SEARCH_FACTS_RENDER_ENABLED

Default: false · Type: bool

Allow search-eligible retries for facts render prompts (first pass remains no-search).

WEB_SEARCH_FACTS_CRITIC_ENABLED

Default: false · Type: bool

Allow search-eligible retries for facts critic prompts (first pass remains no-search).

WEB_SEARCH_PLANNER_ENABLED

Default: true · Type: bool

Enable LLM planner for web-search decisions

WEB_SEARCH_PLANNER_MAX_QUERIES

Default: 3 · Type: int

Maximum focused search queries per node

WEB_SEARCH_PLANNER_MIN_QUERY_CHARS

Default: 12 · Type: int

Minimum query length accepted by guardrails

WEB_SEARCH_PLANNER_MIN_CONFIDENCE

Default: 0.35 · Type: float

Minimum planner confidence to run search

WEB_SEARCH_REUSE_EVIDENCE_ACROSS_ATTEMPT

Default: true · Type: bool

Reuse node-scoped evidence between retries for the same unit.

WEB_SEARCH_MIN_SNIPPET_CHARS

Default: 40 · Type: int

Minimum snippet length to keep a search hit

WEB_SEARCH_ALLOWED_DOMAINS

Default: empty · Type: list[str]

Optional allowlist of source domains for evidence: comma-separated or a JSON list

WEB_SEARCH_BLOCKED_DOMAINS

Default: empty · Type: list[str]

Optional blocklist of source domains for evidence: comma-separated or a JSON list

WEB_SEARCH_REGION

Default: wt-wt · Type: str

DuckDuckGo region code, such as us-en or de-de; wt-wt means no region.

WEB_SEARCH_SAFESEARCH

Default: moderate · Type: str

DuckDuckGo safe-search mode: on, moderate or off.