Step 3 — Run the structured (GDF) arm

Point your agent or retrieval pipeline at the structured export:

# Full document
curl -sS "https://guides.co/g/{slug}/gdf"

# One chunk per page (recommended for RAG)
curl -sS "https://guides.co/g/{slug}/gdf?format=jsonl"

# Single page
curl -sS "https://guides.co/g/{slug}/{item_id}/gdf"

If the guide is private, use the API with your key:

curl -sS -H "Authorization: Bearer $GDF_API_KEY" \
  "https://guides.co/api/gdf/v1/guides/{slug}"

For each gold question:

  1. Retrieve top-k chunks (your vector store, agent tool, or manual jsonl scan).
  2. Record which item_ids were retrieved.
  3. Generate an answer; record cited ids.

Log model id, prompt, and timestamp for reproducibility.