Resolve a crop name to a supported crop

This function attempts to map a user-provided crop name or synonym to a supported crop name using exact/synonym matching, heuristics, and optionally an LLM (AI) fallback.

resolve_crop(crop_input, use_ai = TRUE, use_cache = TRUE)

Arguments

crop_input

Character string. The crop name or description to resolve.

use_ai

Logical. Whether to use AI fallback if no match is found. Default: TRUE.

use_cache

Logical. Whether to use caching for AI responses. Default: TRUE.

Value

A list with elements: crop (resolved crop name), source ("direct_match", "heuristic", or "ai_resolution"), raw_input (original input), assumption (description of how the resolution was made).

Details

The function first checks for exact matches against a predefined list of supported crops and their synonyms. If no match is found, it applies simple heuristics (e.g., substring matching). If still unresolved and use_ai is TRUE, it constructs a prompt to an LLM to attempt resolution. The output includes the resolved crop name, the source of the resolution, the original input, and any assumptions made.

The output is a list with the following fields:

list( crop = "wheat" | "known" | "categorical" | "unknown", source = "direct_match" | "heuristic" | "ai_resolution" | "unresolvable", raw_input = "wheat", assumptions = NULL )

Examples

resolve_crop("wheat")
#> $crop
#> [1] "wheat"
#> 
#> $source
#> [1] "direct_match"
#> 
#> $raw_input
#> [1] "wheat"
#> 
#> $assumption
#> [1] "matched against synonyms: wheat, bread wheat, spring wheat, winter wheat"
#> 
resolve_crop("Winter Wheat")
#> $crop
#> [1] "wheat"
#> 
#> $source
#> [1] "direct_match"
#> 
#> $raw_input
#> [1] "Winter Wheat"
#> 
#> $assumption
#> [1] "matched against synonyms: wheat, bread wheat, spring wheat, winter wheat"
#> 
# resolve_crop("unknown crop", use_ai = FALSE) # should error

# With AI fallback (if configured)
# resolve_crop("unknown crop", use_ai = TRUE)