trailheadapps / trailheadapps/agent-script-recipes

Add voice `model` / `model.id` / `model.parameters` configuration to the voice recipe

Open
#128 2 comments 0 reactions 2 assignees View on GitHub

@msrivastav13 is already working on this.

Since Aug 26, 2026.

enhancement
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 speaks
  • stability (0–1) — how consistent the delivery is
  • similarity (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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.