Back to Mastra

Reference: Agent.getVoice() | Agents

docs/src/content/en/reference/agents/getVoice.mdx

2025-12-181.4 KB
Original Source

Agent.getVoice()

The .getVoice() method retrieves the voice provider configured for an agent, resolving it if it's a function. This method is used to access the agent's speech capabilities for text-to-speech and speech-to-text functionality.

Usage example

typescript
await agent.getVoice()

Parameters

<PropertiesTable content={[ { name: 'options', type: '{ requestContext?: RequestContext }', isOptional: true, defaultValue: '{}', description: 'Optional configuration object containing request context.', properties: [ { type: '{ requestContext?: RequestContext }', parameters: [ { name: 'requestContext', type: 'RequestContext', isOptional: true, defaultValue: 'new RequestContext()', description: 'Request Context for dependency injection and contextual information.', }, ], }, ], }, ]} />

Returns

<PropertiesTable content={[ { name: 'voice', type: 'Promise<MastraVoice>', description: 'A promise that resolves to the voice provider configured for the agent, or a default voice provider if none was configured.', }, ]} />

Extended usage example

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