Skip to main content

Agents

Language model

Choosing the model behind the conversation.

What the language model does

The language model is the reasoning layer of a Finn. It reads the conversation so far — your identity text, style and guardrails, response guidelines, retrieved knowledge base snippets, and every turn of the call — and decides what the agent says next and when to call a tool.

It is one of three AI services behind a call. The other two are text-to-speech, which turns the model's output into audio, and speech-to-text, which turns the caller's audio into text. See text to speech and speech to text.

Where you change it

In the dashboard, open the Finn and go to the Call Settings tab, under AI service configuration. The field is labelled LLM service.

There is no API field for model selection. Model choice is a dashboard operation. The finn API does not expose it.

Every Finn ships with a default model that works for the large majority of use cases. Change it only when you have a specific reason and a way to measure whether the change helped.

What a model change actually affects

AreaEffect of switching models
Instruction adherenceHow reliably the agent honours "never" rules in guardrails
LatencyTime between the caller finishing a sentence and audio starting
Tool callingWhether tools fire at the right moment with the right arguments
Knowledge base useHow well retrieved snippets are woven into an answer rather than read aloud verbatim
Cost per callModel tier is a per-minute cost input

The model does not affect how the agent sounds. Accent, pace, and warmth come from the voice, not the model. If callers say the agent sounds robotic, the fix is in voice or text to speech, not here.

Latency is the real trade-off

Voice is unforgiving about delay in a way that chat is not. A caller hears a pause and starts talking again, which produces an interruption the agent then has to recover from. A model that produces a better answer 400 ms later can measurably degrade a call.

Prompt length compounds this. From the prompting guide:

Prompt lengthLatencyUse case
< 300 wordsLowestSimple confirm, reminder, or survey
300–800 wordsNormalMost agents
800–1500 wordsAcceptableComplex sales or triage
> 1500 wordsSlow and erraticSplit into a workflow

If your agent is slow, shorten the prompt before you change the model. A 2000-word prompt on a fast model is usually slower than a 400-word prompt on a slower one, and the shorter prompt is also more reliable.

Diagnose before you switch

Most behaviour problems blamed on the model are missing-rule bugs. Before changing the LLM service, work through this:

  1. Listen to the recording in call logs. Do not guess from the transcript summary.
  2. Find the first turn where the conversation went wrong. Every later problem usually descends from it.
  3. Check whether a rule covering that exact situation exists in your guardrails or response guidelines. Usually it does not.
  4. Add the rule and one example, then re-test.

If the same failure survives a specific, explicit rule plus an example, that is a genuine model-capability signal and worth acting on. If you have not written the rule yet, a model change is guesswork.

Testing a change

A model change is a configuration change like any other, so the safety rules apply. It affects new calls only. In-flight calls finish under the old configuration.

Test on chat first, in the browser, to check reasoning and tool calls without spending call minutes. Then test on call, because latency and interruption behaviour only show up in real audio. See testing.

Run the same set of scenarios you ran on the old model, including the hostile caller, the confused caller, and the caller who goes off-topic. A model that is better on the happy path can be worse at recovery, and recovery is where calls are lost.

The platform keeps a history of Finn configurations, so you can roll back if a change degrades performance. See versioning.

Measuring the result

Do not judge a model change on a handful of test calls. Deploy it, let real volume accumulate, and compare structured outputs before and after. Post-call analysis fields such as appointment_booked or sentiment give you a comparable number across two configurations. Evaluations and call outcomes cover this in detail.

Which specific models are offered, and their relative cost and latency tiers, are listed in the LLM service dropdown in the dashboard. That list changes, so read it there rather than assuming a model you used previously is still the one selected.