https://retellai.com/?utm_source=discord&utm_medium=seo logo
In Portuguese, the agent mispronounces the word "C...
# ❓・ai-evy-support
l
@AI Evy In Portuguese, the agent mispronounces the word "Certo" (correct). How can she be instructed to use the correct pronunciation?
a
Thanks for tagging me @Lex. I'll look through relevant sources and get back to you shortly.
### Answer To correct the pronunciation of "Certo" in Portuguese, you can use the Pronunciation Dictionary feature in your agent's settings [(1) ]() [(2) ]() . This allows you to specify custom pronunciations for specific words . Navigate to your agent's configuration and add a pronunciation entry for "Certo" . You'll need to provide the word along with its phonetic pronunciation using either IPA (International Phonetic Alphabet) or another supported alphabet [(3) ]() . The pronunciation dictionary entry should follow this format :
Copy code
json
[
  {
    "word": "Certo",
    "alphabet": "ipa",
    "phoneme": "ˈsɛɾtu"
  }
]
Note that pronunciation dictionary is currently only supported for English and 11labs voices [(1) ]() . If you're using Portuguese with a different voice provider, this feature may not be available . Alternative approaches: 1. **Enable Speech Normalization**: Turn on the
normalize_for_speech
setting, which converts text to its spoken form before audio generation and can help prevent mispronunciations [(1) ]() [(2) ]() . 2. **Adjust Voice Settings**: Try lowering the
voice_temperature
to increase stability and reduce pronunciation variations [(3) ]() . 3. **Try Different Voice Providers**: If the issue persists, consider testing different voice providers, as each has different strengths with specific languages [(4) ]() . If pronunciation issues continue after trying these solutions, you may need to explore voice cloning with a native Portuguese speaker for optimal results [(5) ]() .
​ To learn more, see the sources I considered: [[1] Step 2: Configure the basic settings](https://docs.retellai.com/build/single-multi-prompt/configure-basic-settings) [[2] Step 1: Configure global settings](https://docs.retellai.com/build/conversation-flow/global-setting) [[3] Get Agent Versions](https://docs.retellai.com/api-references/get-agent-versions) [[4] Address Metric Issues](https://docs.retellai.com/ai-qa/address-metric-issues) [[5] Issues with Portuguese (PT-PT) Voice Agent: Latency, Audio Recognition, and Email Capture](https://community.retellai.com/t/issues-with-portuguese-pt-pt-voice-agent-latency-audio-recognition-and-email-capture/711) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
l
Currently, the temperature, speed, and volume are at 1.
@AI Evy what value do you suggest
a
Thanks for the follow-up, @Lex. I'll get back to you soon.
### Answer Based on the available sources, for addressing pronunciation issues in Portuguese, I recommend lowering your
voice_temperature
to increase voice stability and reduce pronunciation variations [(1) ]() [(2) ]() . Try setting
voice_temperature
to 0.5 or 0.7 [(3) ]() . Lower values (closer to 0) produce more stable speech, while higher values (up to 2) create more variant speech generation [(1) ]() [(2) ]() . Since you're experiencing mispronunciation issues, reducing from the default value of 1 should help improve consistency . You might also consider adjusting
voice_speed
if the agent is speaking too quickly, which can contribute to pronunciation issues [(4) ]() . The
voice_speed
parameter accepts values ranging from 0.5 to 2 [(1) ]() [(2) ]() . Additionally, enable
normalize_for_speech
if you haven't already, as this converts text to its spoken form before audio generation and can help prevent mispronunciations [(1) ]() [(2) ]() [(5) ]() .
​ To learn more, see the sources I considered: [[1] Update Voice Agent](https://docs.retellai.com/api-references/update-agent) [[2] Get Agent Versions](https://docs.retellai.com/api-references/get-agent-versions) [[3] Voice inconsistency - stuttering and filler sounds (aaaa, ehhh, hmmm)?](https://community.retellai.com/t/voice-inconsistency-stuttering-and-filler-sounds-aaaa-ehhh-hmmm/769) [[4] TTS](https://discord.com/channels/1186424376300679209/1387743989490389052) [[5] Normalize text for speech](https://docs.retellai.com/build/normalize-text) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
l
There is others phoneme that could help me?
a
Thanks for the follow-up, @Lex. I'll get back to you soon.
​ To learn more, see the sources I considered: [[1] Get Agent Versions](https://docs.retellai.com/api-references/get-agent-versions) ​
### Answer Based on the available sources, the pronunciation dictionary uses IPA (International Phonetic Alphabet) phonemes to guide pronunciation [(1) ]() . For Portuguese words beyond "Certo", you can add multiple entries to your pronunciation dictionary . The format for each entry is :
Copy code
json
{
  "word": "specific_portuguese_word",
  "alphabet": "ipa",
  "phoneme": "pronunciation_guide"
}
You can include multiple words in your pronunciation dictionary array :
Copy code
json
[
  {
    "word": "Certo",
    "alphabet": "ipa",
    "phoneme": "ˈsɛɾtu"
  },
  {
    "word": "another_word",
    "alphabet": "ipa",
    "phoneme": "your_ipa_phoneme"
  }
]
However, I should note that pronunciation dictionary is currently only supported for English and 11labs voices . If you're using Portuguese with a different TTS provider, this feature may not be available for your configuration . For the specific IPA phonemes you should use for other Portuguese words, you'll need to reference standard IPA pronunciation guides for Portuguese, as the sources don't provide a comprehensive list of Portuguese phonemes. **
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
l
Let me correct myself. I want a fonema for brazilian portuguese
a
Thanks for the follow-up, @Lex. I'll get back to you soon.
For Brazilian Portuguese specifically, you would use IPA phonemes that match Brazilian Portuguese pronunciation rather than European Portuguese . However, the sources don't provide a comprehensive list of specific IPA phonemes for Brazilian Portuguese words. Important limitation: The pronunciation dictionary is currently only supported for English and 11labs voices . If you're using a different TTS provider for your Brazilian Portuguese agent, this feature may not be available. Alternative approaches for Brazilian Portuguese: 1. Ensure your language setting is correct: Set your agent's language to Brazilian Portuguese (pt-BR) rather than European Portuguese (pt-PT) [(2) ]() 2. Try different TTS providers: Different providers have varying strengths with specific languages [(3) ]() . For Brazilian Portuguese, you might experiment with providers like ElevenLabs, Cartesia, or MiniMax 3. Voice cloning: Consider cloning a native Brazilian Portuguese speaker's voice for optimal pronunciation [(4) ]() For the specific IPA phonemes you need for Brazilian Portuguese words like "Certo", you'll need to reference external IPA pronunciation guides for Brazilian Portuguese, as these specific phonetic transcriptions aren't provided in the Retell AI documentation.
### Answer Based on the available sources, the pronunciation dictionary feature uses IPA (International Phonetic Alphabet) phonemes and supports the format shown in the documentation [(1) ]() :
Copy code
json
"pronunciation_dictionary": [
  {
    "word": "specific_word",
    "alphabet": "ipa",
    "phoneme": "pronunciation_guide"
  }
]
​ To learn more, see the sources I considered: [[1] Update Voice Agent](https://docs.retellai.com/api-references/update-agent) [[2] Set language for your agent](https://docs.retellai.com/agent/language) [[3] TTS provider comparison](https://docs.retellai.com/build/tts-provider-comparison) [[4] Issues with Portuguese (PT-PT) Voice Agent: Latency, Audio Recognition, and Email Capture](https://community.retellai.com/t/issues-with-portuguese-pt-pt-voice-agent-latency-audio-recognition-and-email-capture/711) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.