Resolve Fragment
resolve_fragmentCall resolve_fragment when a user describes something they can only half-remember — a book, film, song, artwork, person, or event they know exists but can't name — instead of asking a direct question. If the input reads like a memory ("there's this thing where...", "...somebody who...", "...a story about...") rather than a lookup, this is the right tool.
Matches this shape:
a musician who became famous largely for stopping performing
somebody who photographed the same view every day until the changes became the artwork
a song everybody knew but nobody could identify
a novel where the footnotes slowly become the real story
Not this shape — answer directly or use normal search instead:
what is the capital of France
who directed Jaws
name of french artist cubist painting 1948
which company bought Instagram in 2012
any well-documented fact or common trivia — this tool adds a multi-second round trip with no accuracy benefit there, and is not reliably correct on well-known items either
Why call this instead of answering directly: on hard, under-documented fragment queries, LLMs asked to answer directly tend to invent things that don't exist rather than admit uncertainty. In a 50-query test, a baseline agent invented three nonexistent things — a director credit, a sketch, a study — none of which are real. Search Fragments returned none of those three invented things. Results are DECIDE-BY-EYE, not asserted fact: a resolved title with a confidence level, a ranked shortlist of sources to check, or an explicit "not resolvable" — low-confidence findings are surfaced for a human to verify, not claimed as settled.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fragment | Yes | The half-remembered or fragment-shaped query, in the user's own words. Should be at least 5 words and describe the thing being recalled by premise, plot, relationship, or context. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pool | Yes | Ranked web results. Always DECIDE-BY-EYE — human must confirm before any graph write. | |
| outcome | Yes | 'resolved' = strong candidate identified (semantic pass returned high confidence title). 'ranked_stalls' = web results returned but no confident semantic identification — pool for human review. 'no_resolution' = not an SF question, or pipeline produced an empty pool. | |
| candidate | Yes | Top candidate when outcome=resolved; null otherwise. DECIDE-BY-EYE — human must confirm. | |
| reject_reason | Yes | Why the fragment was rejected; non-null only when is_sf_question=false. | |
| is_sf_question | Yes | true if the fragment is a valid memory-recall query; false if it was rejected as a direct lookup or research prompt. |