```python
call.set_language_mode(
    primary: Language = "english",
    secondary: list[Language] | None = None,
)
```

```typescript
await call.setLanguageMode({
  primary?: Language,   // default: "english"
  secondary?: Language[],
})
```

```python
@agent.on_call_start
def on_call_start(call: guava.Call):
    call.set_persona(organization_name="Harper Valley Property Insurance")
    call.set_language_mode(primary="english", secondary=["spanish"])
    call.set_task(
        task_id="intro",
        objective="Answer questions regarding property insurance policy.",
    )
```

```typescript
agent.onCallStart(async (call: guava.Call) => {
  await call.setPersona({ organizationName: "Harper Valley Property Insurance" });
  await call.setLanguageMode({ primary: "english", secondary: ["spanish"] });
  await call.setTask({
    taskId: "intro",
    objective: "Answer questions regarding property insurance policy.",
  });
});
```

```python
call.set_language_mode(
    primary="english",
    secondary=["spanish", "french", "german"],
)
```

```typescript
await call.setLanguageMode({
  primary: "english",
  secondary: ["spanish", "french", "german"],
});
```

## set_language_mode()

Configures the voice agent to understand and respond in additional languages beyond English. The agent starts in the primary language and switches to a secondary language when the caller requests it or speaks in that language.

### Example: single secondary language

```python
<CodeTabs
  python={{ code: SET_LANGUAGE_MODE_EX1_PY, filename: "example.py" }}
  typescript={{ code: SET_LANGUAGE_MODE_EX1_TS, filename: "example.ts" }}
/>
```

```typescript
<CodeTabs
  python={{ code: SET_LANGUAGE_MODE_EX1_PY, filename: "example.py" }}
  typescript={{ code: SET_LANGUAGE_MODE_EX1_TS, filename: "example.ts" }}
/>
```

### Example: multiple secondary languages

```python
<CodeTabs
  python={{ code: SET_LANGUAGE_MODE_EX2_PY, filename: "example.py" }}
  typescript={{ code: SET_LANGUAGE_MODE_EX2_TS, filename: "example.ts" }}
/>
```

### Transcript behavior

- There is no auto-translation on the transcript. Each turn appears in the language it was spoken in — if the caller speaks Spanish, that turn is in Spanish; if they speak English, that turn is in English.
- There is currently no per-turn language marker in the transcript.

### Edge cases

- If `secondary` is `None` or empty, the agent operates in `primary` only (the current default behavior).
- When a non-English language is detected during a call, the system automatically switches to a language-specific TTS voice.
- The `grace` voice has clones for Spanish, French, German, and Italian. If no dedicated clone exists for a voice + language combination, the base voice is used.

**Compliance:** English and Spanish are currently supported for HITRUST / PCI-compliant deployments. All languages other than English and Spanish are not. Support for other languages is planned.