Files
controls-web/ai_agents/cane_agent/context/value_hints.yaml
2026-02-17 09:29:34 -06:00

77 lines
2.2 KiB
YAML

# Enum hints and typical ranges sourced from the SugarScale MSSQL sandbox.
# Update these after running profiling queries to keep the agent grounded.
columns:
dbo.SugarLoadData.LoadType:
values:
- Sugar
- Molases
notes: "Free-text field; normalize casing before comparisons."
dbo.SugarLoadData.TrailerTypeID:
values:
- Dump
notes: "Derived from manual entry; expect misspellings such as 'hopper' or 'Dump Trailer'."
dbo.SugarLoadData.LoadingLocation:
values:
- Hopper
- WH1
- WH2
- WH3
- BB
notes: "Locations map to historian area tags; keep a lookup table in sync with operations."
dbo.SugarLoadData.Destination:
values:
- Baldwin 3
- CSC
- BB
- Railcar
- LSR
- WH1
- WH2
- Barge
- Caldwell
- Other
notes: "Destination names align with production reporting dashboards; treat nulls as 'Unassigned'."
dbo.SugarLoadData.TCompanyName:
values:
- AOA
- JJAG,LLC
- Michael Durand
- Atchafalaya Seafood
- CSC
- Southern Prestige ENT
- LACA
- RALPH CALLIER
- ASR
- 14-1
- BIGDAWG
- Lasuca
- Earl Pania
- J Bradley
notes: "Company names align with production reporting dashboards; treat nulls as 'Unassigned'."
ranges:
dbo.SugarLoadData.GrossWt:
units: pounds
typical_min: 20000
typical_max: 88000
notes: "Scale enforces 40-ton cap; values above 90000 suggest sensor error."
dbo.SugarLoadData.TareWt:
units: pounds
typical_min: 14000
typical_max: 45000
notes: "Use stored vehicle tare when this column is null; sudden drops >20% flag for review."
dbo.SugarLoadData.Tons:
units: short_tons
typical_min: 5
typical_max: 40
notes: "Calculated payload; negative values indicate data entry mistakes."
confidence_flags:
dbo.SugarLoadData.VehicleId_Fk:
null_meaning: "Manual override or unregistered vehicle"
mitigation: "Join to SugarVehicles only after filtering nulls or alias to 'UNKNOWN_VEHICLE'."
dbo.SugarLoadData.DateOut:
null_meaning: "Truck has not exited; treat as active load."
mitigation: "Filter out null DateOut when reporting completed deliveries."