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

# Agent.getVoice()

`.getVoice()` メソッドは、Agent に設定された Voice Provider を取得し、関数の場合は解決します。このメソッドは、テキスト読み上げと音声テキスト変換に使う Agent の音声機能へアクセスするために使います。

## 使用例

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

## パラメータ

**options** (`{ requestContext?: RequestContext }`): リクエストコンテキストを含む任意の設定オブジェクト。 (Default: `{}`)

**options.requestContext** (`RequestContext`): 依存性注入とコンテキスト情報に使う Request Context。

## 戻り値

**voice** (`Promise<MastraVoice>`): Agent に設定された Voice Provider へ解決される Promise。Voice Provider が設定されていない場合は、デフォルトの Voice Provider へ解決されます。

## 詳細な使用例

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

## 関連項目

- [Mastra の Voice](https://mastra.zisheng.pro/ja/guides/voice/overview)
- [Voice Provider](https://mastra.zisheng.pro/ja/reference/voice/mastra-voice)