QUERY FANOUT retrieval control plane

RETRIEVAL AUTOPSY GUIDE

Design-partner program. Send 3–7 days of search logs; receive a before/after report within 48 hours.

Hosted API and secure upload: API keys issued after design-partner intro. See API docs.

SAMPLE AUTOPSY PREVIEW

Live report from our bundled sample logs — no upload or API key required.

GUARDRAIL

75/100

moderate

SAVINGS

25.0%

$0.08 est.

SEARCHES

40 → 30

8 sample events

PROBE STOPS

1/8

would stop after probe

> VIEW FULL SAMPLE REPORT > DOWNLOAD .JSONL

WHAT YOU GET

Aggregate search spend vs. a governed probe + fanout model
Top over-search patterns by agent and query type
Where a legal / support allow_answer gate would have blocked or escalated
Written report suitable for engineering and compliance stakeholders

Turnaround: 48 hours from validated log receipt. Cost: free during design partner phase.

WHAT TO SEND

One JSON object per line (.jsonl). Minimum ~20 events over 3–7 days.

{"query": "what is photosynthesis", "searches_run": 5, "backend": "tavily", "agent_id": "support-bot", "run_id": "run-001"}

FIELD	REQUIRED	NOTES
`query`	Yes	Search string only — redact PII before export
`searches_run`	Preferred	If missing, autopsy assumes 5 searches per step
`backend`	Optional	`tavily`, `exa`, `brave` — sets cost model
`agent_id`	Optional	Groups results by agent
`run_id`	Optional	Trace / session correlation

Download sample .jsonl

WHAT NOT TO SEND

Do not include: end-user emails, account IDs, API keys, full LLM prompts, or customer PII.

Send search queries and search counts only. Redact or hash identifiers before export.

HOW TO SUBMIT

METHOD	BEST FOR	DETAILS
Email	Fastest start	Reply to your design-partner invite with a `.jsonl` attachment (<500 KB). Or write autopsy@queryfanout.dev.
Secure upload API	Security-conscious teams	We issue a per-prospect API key. See API section below.
Shared folder	Large exports	Google Drive / Dropbox link in email — we validate on receipt.

> REQUEST DESIGN-PARTNER SLOT

SECURE UPLOAD API (TECHNICAL TEAMS)

Available after we issue your prospect API key. Validates logs on upload and returns a markdown report.

curl -X POST "https://queryfanout.dev/autopsy/upload?company=Acme&period=last%207%20days" \
  -H "X-API-Key: <your-prospect-key>" \
  -F "file=@retrieval_logs.jsonl"

Endpoint: POST /autopsy/upload
Auth: X-API-Key header (per-prospect key from Query Fanout team)
Body: multipart field file (.jsonl or .json, max 5 MB)
Response: validation summary + autopsy metrics + full markdown report

Request a key via contact or autopsy@queryfanout.dev.

LANGSMITH / LANGFUSE / CUSTOM LOGS

LangSmith: export traces (JSON), filter tool runs containing search or tavily, convert to JSONL.

Other observability stacks: any export with query + search tool metadata works. Email us the format if unsure.