You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"Act" read as theatrical; "Step" fits the causal flow (follow the
signals from Step 1 to Step 2 or Step 3). Renames the three section
headers and the three anchor links in the nav + signals table. No
prose or code changes.
@@ -49,7 +49,7 @@ That's it. You now know whether the answer was grounded, how much of your retrie
49
49
50
50
---
51
51
52
-
## Act 1 — Trace your answers
52
+
## Step 1 — Trace your answers
53
53
54
54
Three lanes, one mental model. Pick the one that matches what your app is doing right now.
55
55
@@ -120,8 +120,8 @@ The numbers above are not diagnostics. They are routing rules:
120
120
121
121
| Signal | Meaning | Next step |
122
122
|---|---|---|
123
-
|`band` amber/red, low `context_coverage_ratio`| The answer isn't grounded in what you retrieved. |**[Upgrade data quality](#act-2--upgrade-data-quality)**— your upstream documents are the bottleneck. |
124
-
| High `context_unused_ratio`, `retrieval_waste_pct > 30%`| You retrieved the wrong chunks. |**[Upgrade retrieval](#act-3--upgrade-retrieval)**— your retriever is the bottleneck. |
123
+
|`band` amber/red, low `context_coverage_ratio`| The answer isn't grounded in what you retrieved. |**[Upgrade data quality](#step-2--upgrade-data-quality)**— your upstream documents are the bottleneck. |
124
+
| High `context_unused_ratio`, `retrieval_waste_pct > 30%`| You retrieved the wrong chunks. |**[Upgrade retrieval](#step-3--upgrade-retrieval)**— your retriever is the bottleneck. |
125
125
|`session_signals.recommendation = "re_anchor"` / `"fresh_chat"` on the code lane | Session drift is compounding. | Reset the agent's context on the next turn. |
126
126
127
127
Full reference: [Trace docs](docs/trace.md) and [SDK tutorial §18](SDK_TUTORIAL.md#18-direct-api-trace-groundedness--phantom-scoring).
@@ -142,7 +142,7 @@ async with AsyncLatence() as client:
142
142
143
143
---
144
144
145
-
## Act 2 — Upgrade data quality
145
+
## Step 2 — Upgrade data quality
146
146
147
147
Trace is showing low coverage or amber/red bands? The model is rarely the problem. It's usually the upstream data: un-OCR'd PDFs, missing entities, unresolved references. The Latence **Data Intelligence Pipeline** cleans that in one call.
148
148
@@ -196,7 +196,7 @@ See [docs/dataset_intelligence.md](docs/dataset_intelligence.md).
196
196
197
197
---
198
198
199
-
## Act 3 — Upgrade retrieval
199
+
## Step 3 — Upgrade retrieval
200
200
201
201
If Trace keeps flagging a high `context_unused_ratio`, or the session rollup shows `retrieval_waste_pct > 30%`, your model isn't the problem —**your retrieval engine is shipping the wrong chunks**.
0 commit comments