Agentic.ModelRouter.Preference (agentic v0.2.2)

Defines model selection preferences and the scoring logic for each.

User preferences control how the Selector ranks candidate models:

:optimize_price — prefer cheaper models; only upgrade when the analysis demands it (complex tasks, vision, etc.)
:optimize_speed — prefer faster models; prioritize throughput and low latency, willing to spend more

The preference is combined with an Analyzer.analysis() result to produce a scoring function used by Selector.rank/3.

Summary

preference()

default()

Return the default preference.

parse(other)

Parse a preference from user input.

Compute a score for a model given a preference and analysis.

@type preference() :: :optimize_price | :optimize_speed

@spec default() :: preference()

Return the default preference.

@spec parse(term()) :: {:ok, preference()} | {:error, term()}

Parse a preference from user input.

@spec score(
  Agentic.LLM.Model.t(),
  preference(),
  Agentic.ModelRouter.Analyzer.analysis()
) :: float()

Compute a score for a model given a preference and analysis.

Lower scores are better. The scoring considers: