AUTOPILOT. Its configuration has two parts: the
agent itself, sent as intelligence.config, and the application fields around it, such as
speech, recording, amd and the fallback. For a guided walk through these settings, see
Build an Autopilot agent.
Fonoster checks the agent when you save it. Unknown fields are refused, and so are fields from 0.27,
with a message that says where each one moved. See Removed fields.
The agent
The agent has three top-level keys.
In a CLI agent file (
--agent agent.yaml), these keys are at the top of the file. With the SDK,
they go in intelligence.config. The eval file that fonoster applications:eval reads is
different: it nests the agent and its testCases under intelligence.config. See
Test your agent.
Conversation settings
What the agent says before it hangs up: when the model uses the
hangup tool, when the caller
stays silent too long, or when the call reaches maxSessionDuration. The caller can’t
interrupt it.Whether the agent stops talking when the caller talks over it. See
Turn-taking and barge-in.
The longest a call can last, in milliseconds. A positive integer. The default is 30 minutes. When
the call reaches it, the agent says the goodbye message and hangs up.
What the agent does when the caller goes quiet. Without it, the agent never prompts a silent
caller.
Turns on the built-in
transfer tool. See Give your agent tools.Keypad digits the agent sends when the call connects, before the first message. Only
0–9,
* and #.How long the agent waits before it decides the caller has finished:
low, normal or high.
The agent sends its value only when it isn’t normal, so with normal the application’s
speech.patience applies. See Turn-taking and barge-in.Words that help speech recognition, such as names and brands. Up to 100 entries, none empty.
Language model
A catalog ID in the form
<provider>/<model>, such as openai/gpt-5.4-mini. It must match
^[a-z0-9-]+/.+. Live calls run models with an OpenAI-compatible API. See
Providers and models.Sampling temperature, from
0 to 2. Lower is more consistent. A model with the fixed-sampling
feature ignores it.HTTP tools the model can call. See Tools.
PDF documents the agent searches before each reply. See
Add a knowledge base.
Tools
Each entry inlanguageModel.tools is an HTTP tool. The built-in hangup and transfer tools
aren’t listed here. See Give your agent tools.
The tool’s name. The dashboard accepts letters, numbers,
_ and -, up to 64 characters, and
reserves hangup and transfer.Test cases
testCases holds scenarios for Test your agent. They run outside calls and never
call your tool endpoints.
Removed fields
These 0.27 fields are refused with a message that names the replacement. See Migrate from 0.27.The application
These application fields apply to an Autopilot agent. Set them on the application with the SDK (createApplication, updateApplication) or with CLI flags.
The agent, as described in The agent.
Speech
The voice, as a catalog ID that isn’t retired. It can also be any
<provider>/<id> that isn’t
in the catalog, such as a voice from the vendor’s own library, when speech.ttsModel names a
model of the same provider. Fonoster doesn’t check that ID: a wrong one fails when the agent
speaks. Without speech.ttsModel the save fails with
voice <id> is not in the catalog; set speech.ttsModel. See
Providers and models. CLI: --voice.The language the caller speaks, from 2 to 64 characters, such as
es-MX. It belongs to the
transcriber: pick one of the speech-to-text model’s languages. CLI: --language.The text-to-speech model the vendor gets, as a catalog ID, such as
deepgram/aura-2. It applies
when the voice runs on it, and it’s required for a voice that isn’t in the catalog. When unset,
the voice’s first model is used. CLI: --tts-model.How fast the agent speaks, from
0.7 to 1.2, such as 1.1. Unset (or 0) is 1.0, the
voice’s normal pace. A value out of range fails with
speech.speed must be between 0.7 and 1.2. Some models ignore it; see
Providers and models. CLI: --speed.The base stretch of caller silence, in milliseconds, that the turn detector works from. From
100 to 120000. Leave it out to use the platform’s default. CLI: --silence-timeout.Recording
off or on. Leave it out and calls aren’t recorded. See
Record calls. CLI: --recording.Answering-machine detection
Off when unset. See Detect answering machines.
Fallback
When Fonoster can’t reach the agent, the call goes to the fallback application. If there is none, or it can’t be reached either, the caller hears the fallback message and the call ends. Without a message, the call ends at once.The ref of another application in the same workspace. Up to 64 characters. An application can’t
be its own fallback. CLI:
--fallback-app.What the caller hears when no application answers, in the application’s voice. Up to 1000
characters. CLI:
--fallback-message.Full example
This creates an Autopilot agent with every group set, using the SDK:create-agent.js
agent.yaml