NewDutch, Flemish and Polish voices are live: Maren and Tomasz.

Skip to content
Relay

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.

NextTools →