What this agent helps you do
A Turbopuffer ingestion health agent reviews whether documents and vectors are entering the search system as expected. It focuses on ingestion failures, schema mismatches, missing metadata, and validation examples.
When to use this workflow
Use it after pipeline changes, when retrieval quality drops, before launching a new search feature, or when documents are missing from results.
How Turbopuffer gives the agent context
Connect Turbopuffer and scope the task to the namespace, schema, document batch, ingestion window, or symptom. Ask the agent to begin with diagnostics and keep schema or write changes approval-ready.
Example starter prompt
Review Turbopuffer ingestion health for this namespace. Identify missing or malformed records, schema risks, failed batches, diagnostic checks, and validation steps before we change production data.
Suggested workflow steps
The agent gathers examples, checks schema assumptions, compares expected and actual records, and prepares diagnostics ranked by risk.
Expected handoff
The handoff should include ingestion findings, example records, diagnostic steps, recommended fixes, and validation checks. Pair with GitHub for pipeline code context.