> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-TW/llms.txt

# Agent.getVoice()

`.getVoice()` 方法會取得為 Agent 設定的語音 Provider；若設定為函式，也會解析函式。此方法用於存取 Agent 的文字轉語音與語音轉文字能力。

## 使用範例

```typescript
await agent.getVoice()
```

## 參數

**options** (`{ requestContext?: RequestContext }`): 包含 request context 的選用設定物件。 (Default: `{}`)

**options.requestContext** (`RequestContext`): 用於相依性注入與情境資訊的 Request Context。

## 回傳值

**voice** (`Promise<MastraVoice>`): 解析為 Agent 所設定語音 Provider 的 promise；若未設定，則解析為預設的語音 Provider。

## 延伸使用範例

```typescript
await agent.getVoice({
  requestContext: new RequestContext(),
})
```

## 相關內容

- [Mastra 中的語音功能](https://mastra.zisheng.pro/zh-TW/guides/voice/overview)
- [Voice Provider](https://mastra.zisheng.pro/zh-TW/reference/voice/mastra-voice)