Build the agent · 7 min · updated 5 November 2026
The agent file
Every key in agent.yaml: the job, the voice, languages, tools, hand-off and guardrails.
An agent is one YAML file. Relay reads it on every deploy; the console shows the same settings and writes them back.
The job
job is the agent’s instructions in plain sentences. Write it as you would brief a new colleague on their first day: what to do, what never to do, when to pass the call on.
Voice and languages
voice is one of the voices on the voices page. languages lists the languages the agent may speak; it answers in the caller’s language when that is on the list, and in the first one otherwise.
Hand-off
handoff:
number: "+31 30 555 0182"
with_summary: true
when: [pain, billing, asks_for_person]
Guardrails
never lists topics the agent will not discuss. Each one is checked on every turn, before the reply is spoken.