save_to_shortlist
Save a site with its objectives and current score to a persistent shortlist for later re-scoring against the evolving national baseline.
Instructions
Save a site into a PERSISTENT, named shortlist that survives across conversations (Phase 5 statefulness). Snapshots the site's objectives + its current percentile objective_score, so you can re-score it later against the evolving national baseline. Use to build a durable siting shortlist across days/weeks; the list is scoped to your API key. Pair with get_shortlist to re-score + see drift. site should carry lat/lng/capacity_mw + the analyze_site metric fields (risk_resilience, fiber_connectivity, water score, etc.) you ranked on.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | Yes | Site object: {site_ref?, lat, lng, capacity_mw, <metric fields from analyze_site>} — the metrics are what get re-scored later | |
| notes | No | Optional free-text note, e.g. "strong fiber, acceptable water" | |
| objectives | Yes | The {field: signedWeight} objectives this site was ranked under (+maximize/-minimize) — stored so re-scoring uses the same criteria | |
| shortlist_name | No | Name of the shortlist, e.g. "Q3-2026-1GW-targets" — created if new |