From bb3b41412c27badbb04b90881771c9369bdcc5dd Mon Sep 17 00:00:00 2001
From: Alessandro <155005371+3clyp50@users.noreply.github.com>
Date: Sat, 9 May 2026 17:36:08 +0200
Subject: [PATCH] Clarify search engine query guidance

---
 prompts/agent.system.tool.search_engine.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/prompts/agent.system.tool.search_engine.md b/prompts/agent.system.tool.search_engine.md
index b544f41cd..f6953f971 100644
--- a/prompts/agent.system.tool.search_engine.md
+++ b/prompts/agent.system.tool.search_engine.md
@@ -1,7 +1,16 @@
 ### search_engine
 find live news, prices, and other real-time web data
-arg: `query` (text search query)
+arg: `query` (keyword-based text search query)
 returns urls, titles, and descriptions
+
+query rules:
+- use keywords, names, exact phrases, model/version numbers, dates, and domains
+- do not write a natural-language question or sentence
+- omit filler words like "what", "who", "can you tell me", "find information about"
+- use 3-10 high-signal terms; add alternatives only when they improve recall
+- bad: "What is the latest LiteLLM release and what changed?"
+- good: "LiteLLM latest release notes changelog"
+
 example:
 ~~~json
 {
@@ -9,7 +18,7 @@ example:
   "headline": "Searching the web",
   "tool_name": "search_engine",
   "tool_args": {
-    "query": "latest LiteLLM release notes"
+    "query": "LiteLLM latest release notes changelog"
   }
 }
 ~~~