Idioma
Saiba como configurar seu agente para falar vários idiomas.
Visão geral
Este guia mostra como configurar seu agente para falar vários idiomas. Você aprenderá a:
- Configurar o idioma principal do seu agente
- Adicionar suporte a vários idiomas
- Definir vozes e primeiras mensagens específicas para cada idioma
- Otimizar a seleção de voz para uma pronúncia natural
- Ativar a troca automática de idioma
Você também pode fazer essas alterações conversando. O servidor MCP hospedado permite que Claude e outros clientes MCP criem, configurem e gerenciem seus agentes por meio de linguagem natural.
Guia
Idioma padrão do agente
Quando você cria um novo agente, ele é configurado com:
- Inglês como idioma principal
- Modelo Flash v2 para respostas rápidas somente em inglês
- Uma primeira mensagem padrão.

Idiomas adicionais fazem o agente usar o modelo Multilingual v2.5. O inglês sempre usará o modelo v2.
Adicionar idiomas adicionais
Atualizar pelo painel
Atualizar pela CLI
Atualizar pela API
Acesse a página de configuração do seu agente e localize a aba Agente.
- Em Idiomas adicionais, adicione um idioma adicional (por exemplo, francês)
- Revise a primeira mensagem, que é traduzida automaticamente usando um Large Language Model (LLM). Personalize-a conforme necessário para cada idioma adicional, garantindo precisão e relevância cultural.

Selecionar a opção Todos no menu suspenso Idiomas adicionais configurará o agente para oferecer suporte a 31 idiomas. Juntos, esses idiomas são falados por aproximadamente 90% da população mundial.
Configurar vozes específicas para cada idioma
Para uma pronúncia ideal, configure cada idioma adicional com uma voz específica para o idioma da nossa Voice Library.
Para encontrar ótimas vozes para cada idioma, selecionadas pela equipe da ElevenLabs, acesse as principais escolhas por idioma.
Configurações de voz específicas por idioma
Voice Library

Ativar a detecção de idioma
Adicione a ferramenta de detecção de idioma ao seu agente para que ele possa mudar automaticamente para o idioma preferido do usuário.
Iniciar uma chamada
Agora que o agente está configurado para oferecer suporte a idiomas adicionais, o widget solicitará o idioma preferido do usuário antes de a conversa começar.
Se você estiver usando o SDK, o idioma poderá ser definido programaticamente usando substituições de conversa. Consulte o guia de Substituições para detalhes de implementação.

A seleção de idioma é fixa durante toda a chamada — os usuários não podem trocar de idioma no meio da conversa.
Internacionalização
Você pode integrar o widget ao seu framework de internacionalização definindo dinamicamente os atributos de idioma e texto da interface.
Verifique se os códigos de idioma correspondem entre seu framework de i18n e os idiomas compatíveis com o agente.
Práticas recomendadas
Seleção de voz
Selecione vozes treinadas especificamente nos seus idiomas de destino. Isso garante:
- Pronúncia natural
- Sotaques regionais apropriados
- Melhor tratamento de nuances específicas de cada idioma
Personalização da primeira mensagem
Embora traduções automáticas sejam fornecidas, considere:
- Revisar as traduções quanto à precisão
- Adaptar as saudações ao contexto cultural
- Ajustar o tom formal/informal conforme necessário