Skip to content
LOPS Docs

Search Operator

v2.1.0 What's new
See LOPs 0.1.1 Full changelog →

Search v2.1.0 [ September 2, 2025 ]

  • Multi-provider search architecture replacing Serper-only implementation
  • Support for Tavily, Firecrawl, Brave Search, Exa AI
  • Intelligent provider routing based on search type and cost
  • Enhanced search types including research, academic, news, maps
  • Fallback system with cost estimation and budget protection
  • Standardized result format and advanced filtering options
  • Legacy Serper tool maintained for compatibility
  • Improved menu transparency for provider capabilities
  • GetTool integration for LOPs controller compatibility

Overview

Section titled “Overview”

The Search LOP is a powerful, unified interface for performing various types of web searches using multiple backend providers. It is designed to be artist-focused, with transparent pricing, budget protection, and intelligent routing to help you get the best results for the lowest cost.

Agent Tool Integration

Section titled “Agent Tool Integration”
🔧 GetTool Enabled 1 tool

This operator exposes 1 tool that allow Agent and Gemini Live LOPs to perform comprehensive web searches including standard web search, image search, video search, academic search, patent lookups, shopping results, map queries, and business reviews.

Use the Tool Debugger operator to inspect exact tool definitions, schemas, and parameters.

The Search LOP exposes its search functionalities as a single, unified tool that an AI agent can call. When connected to an Agent LOP, the agent can perform searches for any topic or question to get web results.

Requirements

Section titled “Requirements”
  • API Keys: Obtain API keys for the search providers you wish to use (Tavily, Firecrawl, Brave, Exa, Serper) and enter them in the API Key parameter on the ‘Search’ page.
  • ChatTD Operator: Required for asynchronous task execution and logging. Ensure the ChatTD Operator parameter on the ‘About’ page points to your configured ChatTD instance.

Input/Output

Section titled “Input/Output”

Inputs

Section titled “Inputs”

None (Search queries and parameters are configured via the operator’s parameters).

Outputs

Section titled “Outputs”
  • results_table DAT: Stores the raw JSON response for every search performed.
  • query_table DAT: Logs basic information about each query attempt.
  • last_result_table DAT: Stores the results of the last search in a RAG-indexer compatible format.

Parameters

Section titled “Parameters”

Page: Search

Section titled “Page: Search”
Status (Status) op('search').par.Status Str
Default:
None
Active (Active) op('search').par.Active Toggle
Default:
None
Search (Search) op('search').par.Search Pulse
Default:
None
Search Query (Query) op('search').par.Query Str
Default:
None
Search Type (Searchtype) op('search').par.Searchtype Menu
Default:
web
Max Results (Maxresults) op('search').par.Maxresults Int
Default:
5
Range:
1 to 50
Search Provider (Searchprovider) op('search').par.Searchprovider Menu
Default:
auto
Estimated Cost (Costestimate) op('search').par.Costestimate Str
Default:
None
Expected Results (Expectedresults) op('search').par.Expectedresults Str
Default:
None
Last Search Content (Lastsearchcontent) op('search').par.Lastsearchcontent Str
Default:
None
out1 Last Result Only (Lastresult) op('search').par.Lastresult Toggle
Default:
None
API Key (Apikey) op('search').par.Apikey Str
Default:
None
Get API Keys (Getapikeys) op('search').par.Getapikeys Pulse
Default:
None
Clear Results (Clearresults) op('search').par.Clearresults Pulse
Default:
None

Page: Agent

Section titled “Page: Agent”
Agent Calls Add to Table (Agenttotable) op('search').par.Agenttotable Toggle
Default:
None
Agent Execution Mode (Agentexecutionmode) op('search').par.Agentexecutionmode Menu
Default:
wait
Agent Return Content (Agentreturncontent) op('search').par.Agentreturncontent Menu
Default:
none
Agent Truncated Length (Agenttruncatedlength) op('search').par.Agenttruncatedlength Int
Default:
2000
Range:
100 to 100000
Expose Search Type to LLM (Exposesearchtype) op('search').par.Exposesearchtype Toggle
Default:
None
Expose Max Results to LLM (Exposemaxresults) op('search').par.Exposemaxresults Toggle
Default:
None

Page: Advanced

Section titled “Page: Advanced”
Tool Name (Toolname) op('search').par.Toolname Str
Default:
None
Include Raw Content (Includerawcontent) op('search').par.Includerawcontent Toggle
Default:
None
Include AI Answer (Includeanswer) op('search').par.Includeanswer Toggle
Default:
None
Enable Provider Fallback (Enablefallback) op('search').par.Enablefallback Toggle
Default:
None
Exa Search Type (Exasearchtype) op('search').par.Exasearchtype Menu
Default:
auto
Brave Locale (Bravelocale) op('search').par.Bravelocale Str
Default:
None

Page: About

Section titled “Page: About”
Bypass (Bypass) op('search').par.Bypass Toggle
Default:
None
Show Built-in Parameters (Showbuiltin) op('search').par.Showbuiltin Toggle
Default:
None
Version (Version) op('search').par.Version Str
Default:
None
Last Updated (Lastupdated) op('search').par.Lastupdated Str
Default:
None
Creator (Creator) op('search').par.Creator Str
Default:
None
Website (Website) op('search').par.Website Str
Default:
None
ChatTD Operator (Chattd) op('search').par.Chattd OP
Default:
None

Usage Examples

Section titled “Usage Examples”
Section titled “Basic Web Search”
  1. On the Search page, enter your query in the Search Query parameter.
  2. Select a Search Provider or leave it as Auto.
  3. Pulse the Search parameter.
  4. The results will be displayed in the last_result_table DAT.

Using with an Agent

Section titled “Using with an Agent”
  1. Create an agent operator.
  2. On the Tools page of the agent, enable Use LOP Tools.
  3. Connect the search operator to the External Op Tools parameter on the agent.
  4. Start a conversation with the agent and ask it to search for something.
Section titled “Related Operators”