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

# Agent.getVoice()

`.getVoice()` 方法會取得為 Agent 設定的語音 Provider；如設定為函數，則會先解析函數。此方法用於存取 Agent 的語音功能，包括文字轉語音及語音轉文字。

## 使用範例

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

## 參數

**options** (`{ requestContext?: RequestContext }`): 包含請求內容的可選設定物件。 (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-HK/guides/voice/overview)
- [語音 Provider](https://mastra.zisheng.pro/zh-HK/reference/voice/mastra-voice)