Search Web Node
A search engine. Useful for when you need to answer questions about current events. Input should be a search query.
Search Web gives an AI Agent access to current, public web-search results. Connect the node's Tool output to an AI Agent's tools input; the agent supplies a search query when it decides the tool is useful.
What Search Web does
Search Web sends the agent's query to SerpApi, which returns parsed Google Search results. BotDojo then formats those results for the agent according to the selected Search Mode. It is useful for current events, public facts, company and product research, and finding pages that are discoverable through web search.
The agent calls the tool with one required value:
| Input | Description |
|---|---|
| query | The web-search query. The agent creates this value from its instructions and the user's request. |
Search modes
| Mode | Best for | Result behavior |
|---|---|---|
| Quick Answer | A concise answer to a factual or current-information question. | Uses a direct answer or another rich Google Search result when one is available. It can use answer boxes, news, events, sports, job results, questions and answers, shopping results, local results, a knowledge panel, or the first organic result. This is the default mode. |
| Top Results | Research where the agent should compare or cite multiple sources. | Returns organic results with each page's title, URL, and search-result snippet. Choose this mode when source visibility matters. |
Search Web performs one search each time the agent calls it. The agent may call it more than once when its prompt and iteration limit allow additional research.
Settings
| Setting | What it controls |
|---|---|
| Search Mode | Selects Quick Answer or Top Results and determines how provider results are formatted for the agent. |
| Tool Name | Sets the function name visible to the agent. The default is searchweb. Keep it short, unique among the agent's tools, and descriptive. |
| Tool Description | Tells the agent when and how to use the tool. Customize it when the agent should search for a narrower purpose, such as competitor news or regulatory updates. |
| Create Citation References | Available in Top Results mode. When enabled, BotDojo creates citation records for result titles, URLs, and snippets so supported chat responses can refer to those sources. It is enabled by default. |
Turning off Create Citation References does not remove source URLs from Top Results; it stops BotDojo from creating citation records for those results.
Output and limitations
The node outputs a Web Search Tool, not the final answer. Connect that output to an AI Agent. The agent decides when to call the tool and synthesizes the tool result into its response.
- Results are limited to public information available through Google Search and SerpApi at call time.
- A search-result snippet is not the full source page. Ask the agent to be precise about what the result establishes.
- Citation references contain the result title, URL, and snippet; they do not prove that BotDojo read the complete page.
- Search quality depends on the query. Include a company name, domain, role, location, or date when those constraints matter.
- A provider error or an empty result set leaves the agent without web evidence for that call. Test representative queries in Studio and instruct the agent how to respond when no useful result is found.
Output
| Label | Property | Type | Description |
|---|---|---|---|
| Tool | tool | botdojo/interface/tool | Web Search Tool |