# The agent file

> Every key in agent.yaml: the job, the voice, languages, tools, hand-off and guardrails.

Relay docs, updated 5 November 2026 · https://prompt.themes.dev/docs/agent-file/

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

```yaml
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.
