trailheadapps / trailheadapps/agent-script-recipes
Add voice `model` / `model.id` / `model.parameters` configuration to the voice recipe
@msrivastav13 is already working on this.
Since Aug 26, 2026.
- Dominant language
- Apex
- Stars
- 135
- Forks
- 82
- Avg merge
- 10m
- Merged PRs (30d)
- 4
Description
Summary
The modality voice block supports selecting and tuning the synthesized voice model via an outbound.model section, but our recipes don't demonstrate it. We should show how to set model, model.id, and/or model.parameters so developers can pick the right voice model and tune delivery (speed, stability, similarity).
Based on the docs: Configure Voice in Agent Script
Suggested Solution
Add an example under the modality voice block's outbound section:
modality voice:
outbound:
persona_id: "hash_id_here"
model:
id: "eleven_flash_v2_5"
parameters:
speed: 1.0
stability: 0.8
similarity: 0.75
Cover the supported model IDs and when to use each:
| Model | ID | Notes |
|---|---|---|
| ElevenLabs v3 Conversational | eleven_v3 |
Most natural/expressive; default for most languages. Ignores speed/similarity; stability defaults to 0.5 |
| ElevenLabs Flash v2 | eleven_flash_v2 |
English-only; lower latency, best custom pronunciation; honors all params |
| ElevenLabs Flash v2.5 | eleven_flash_v2_5 |
Multilingual; good secondary accents (e.g. Argentinian Spanish, French Canadian, European Portuguese); honors all params |
| Kotoba | kotoba |
Japanese; default for ja; does not use these params |
And the model.parameters (support varies by model):
speed(0.7–1.2) — how fast the voice speaksstability(0–1) — how consistent the delivery issimilarity(0–1) — how closely output matches the original voice's character
Notes
Related to the broader voice recipe in #95 and the per-subagent model configuration in #94. This issue is scoped specifically to the voice outbound.model configuration.
Code of Conduct
- I agree to follow this project's Code of Conduct
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.