Feature: serp

Conditional Search Tool

Tool binding that only fires Scavio when the agent decides fresh web data is needed, cutting unnecessary calls by 40 to 70%.

What is Conditional Search Tool?

Conditional Search Tool is the Scavio binding pattern where the tool schema includes explicit needs_fresh_data criteria the model evaluates before invoking. Instead of the tool firing on every turn, the model checks whether the answer depends on information that could have changed, whether the context window already contains it, and whether a cheaper tool could satisfy. Teams that adopt the pattern typically cut Scavio call volume 40 to 70% without degrading answer quality, which lowers both spend and latency.

Example Response

JSON
{ "called": true, "reason": "query references 2026 pricing, context lacks freshness", "results": [{ "title": "...", "url": "..." }] }

Use Cases

  • High-volume research agents that cannot afford per-turn search
  • Chat products optimizing for latency
  • Multi-step agents with long context windows
  • Cost-sensitive production deployments

Why Conditional Search Tool Matters

Always-on search binds waste tokens and credits on turns where the model already knows the answer; conditional binding matches spend to actual need.

LangChain Example

Drop conditional search tool data into your LangChain agent in a few lines:

Python
tool = ScavioSearch(invoke_when="needs_fresh_data").bind(llm)

Frequently Asked Questions

Send a search request with the appropriate platform (google) and Scavio returns conditional search tool data in the response. See the example above for the exact field path.

Yes. Scavio fetches conditional search tool data in real time on each request. There is no caching layer and no stale data.

Conditional Search Tool is the Scavio binding pattern where the tool schema includes explicit needs_fresh_data criteria the model evaluates before invoking. Instead of the tool fir

Conditional Search Tool data is returned as part of the standard search response. Each request costs 1 credit. Free tier includes 500 credits/month.

Start Using Conditional Search Tool

Tool binding that only fires Scavio when the agent decides fresh web data is needed, cutting unnecessary calls by 40 to 70%.