Document search_suggestions minimum 3-character query requirement - #876
Document search_suggestions minimum 3-character query requirement#876promptless[bot] wants to merge 1 commit into
Conversation
Correct the search_suggestions MCP tool reference to reflect PR #4654: query is now required and must be at least 3 characters; the tool no longer returns all suggestions when called without a query. Adds a troubleshooting bullet and an August 2026 changelog entry.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
![promptless[bot]](https://avatars.githubusercontent.com/in/979718?s=60&v=4){kind=small}
| ### `search_suggestions` | ||
|
|
||
| Searches your existing suggestions by keyword and status, so you can check whether a change is already covered before starting a new task. `query` (optional) matches a suggestion's title and description; `status` (optional) restricts results to one of `draft`, `open`, `merged`, or `closed`. Both are optional—calling with neither returns all your suggestions. A `draft` or `open` suggestion is still live; a `merged` or `closed` one is already resolved. | ||
| Searches your existing suggestions by keyword and status, so you can check whether a change is already covered before starting a new task. `query` (required) matches a suggestion's title and description, and must be at least 3 characters; `status` (optional) restricts results to one of `draft`, `open`, `merged`, or `closed`. A `draft` or `open` suggestion is still live; a `merged` or `closed` one is already resolved. |
There was a problem hiding this comment.
search_suggestions tool schema: query gains minLength 3 and moves into required; status stays optional with enum draft/open/merged/closed. Backs the doc's claim that query is now required and must be at least 3 characters, and status remains optional restricted to those four values.
| - **Empty `instructions`**: resubmit with a specific `instructions` string. | ||
| - **A `doc_collection_id` that isn't a valid ID (UUID)**: call `list_doc_collections` and pass an `id` from the returned list. | ||
| - **An unrecognized `search_suggestions` status**: use one of `draft`, `open`, `merged`, or `closed`. | ||
| - **A missing `search_suggestions` `query`, or one shorter than 3 characters after trimming**: provide a `query` of at least 3 characters. |
There was a problem hiding this comment.
_search_suggestions handler: rejects a missing/non-string query ("query is required and must be a string") and a trimmed query under 3 characters ("query must be at least 3 characters"). Backs the new Troubleshooting bullet describing this rejection and remedy.
|
|
||
| * **Research breakdown now reads Knowledge Base inline and attributes delegated research:** Each trigger's research breakdown—on the Triggers page and a suggestion's **Triggers & Analysis** tab—now shows Knowledge Base reads inline, in the sequence the agent read them, instead of grouped at the end. Delegated research appears as an attributed branch labeled with the subagent type and its tool-call count. A "research agents" callout appears next to the summary when Promptless delegates research. See [Research breakdown](/docs/work-the-queue/web-interface#research-breakdown). | ||
|
|
||
| * **`search_suggestions` now requires a search query:** The MCP `search_suggestions` tool now requires a `query` of at least 3 characters and no longer returns all your suggestions when you call it without one. See [MCP triggers](/docs/connect/triggers/mcp). |
There was a problem hiding this comment.
SuggestionStore.search_dashboard_rows_for_org: query parameter loses its = None default (now required), strips and rejects queries under 3 characters, and the title/description ilike filter is now unconditional (previously only applied when a query was given). Backs the changelog claim that search_suggestions now requires a query of at least 3 characters and no longer returns all suggestions when called without one.
1 participant
Open in Promptless
Source PR Promptless/promptless#4654 changes the behavior of the
search_suggestionsMCP tool:queryis now required and must be at least 3 characters (after trimming), and the tool no longer returns all of an organization's suggestions when called without a query. This corrects the MCP tool reference, which previously describedqueryas optional and stated that calling with neitherquerynorstatusreturned all suggestions.Changes:
src/content/docs/docs/connect/triggers/mcp.mdx: thesearch_suggestionsreference now describesqueryas required with a 3-character minimum, and drops the now-false "returns all your suggestions" sentence; a troubleshooting bullet covers the missing/too-short query rejection.src/content/changelog/changelogs/august-2026.mdx: an Improvements entry noting the required-query change (folded into the existing MCP-related changelog rather than a standalone suggestion).Trigger Events