What this agent helps you do
A Turbopuffer search quality agent helps teams understand why retrieval is not meeting expectations. It can summarize schema, ingestion, query, and result quality questions.
When to use this workflow
Use it when search results are irrelevant, recall drops, ingestion fails, latency changes, or a new retrieval feature needs validation.
How Turbopuffer gives the agent context
Connect the plugin and scope the agent to the namespace, schema, query examples, documents, or incident. Ask it to begin with safe diagnostics and prepare changes for approval.
Example starter prompt
Investigate this Turbopuffer search quality issue. Review the provided query examples, schema assumptions, ingestion context, likely causes, and recommend diagnostics and fixes without making changes automatically.Suggested workflow steps
Define the symptom, gather examples, inspect schema and ingestion assumptions, compare expected and actual results, and rank likely fixes by impact and risk.
Expected handoff
The handoff should include examples, findings, diagnostic steps, recommended changes, and validation checks. Pair with GitHub or PostHog for code and product context.