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

# Agent.getVoice()

`.getVoice()` 方法用于获取为 Agent 配置的语音 Provider；如果 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/guides/voice/overview)
- [语音 Provider](https://mastra.zisheng.pro/reference/voice/mastra-voice)