Agentes multilíngues
Como funciona
Cada usuário tem um Idioma definido no seu registro de Usuário do Salesforce (o campo é tecnicamente LanguageLocaleKey — valores como fr, de, es_MX, ja, zh_CN). A plataforma lê esse valor no início de cada conversa e o usa para decidir se injeta uma diretriz de idioma no prompt do sistema do agente.
-
Ler o idioma do usuário
A partir do perfil Salesforce do usuário em execução, sem necessidade de configuração por agente.
-
Otimização apenas para inglês
Se o idioma for o inglês (qualquer local em inglês), a plataforma pula a diretriz de idioma por completo. Nenhum token é gasto instruindo o modelo a fazer o que ele já faz por padrão.
-
Anexar a diretriz
A plataforma carrega o prompt de diretriz de idioma específico do canal, substitui os valores de idioma do usuário nos placeholders e o inclui no prompt do sistema montado.
-
O modelo responde
O agente lê a diretriz no seu prompt do sistema e responde no idioma do usuário pelo restante da conversa.
Os dois placeholders
Prompts personalizados podem referenciar o idioma do usuário em execução com dois placeholders:
| Placeholder | Resolve para | Valores de exemplo |
|---|---|---|
{USER_LANGUAGE} |
O local de idioma Salesforce completo. | fr, de, es_MX, pt_BR, zh_CN |
{USER_LANGUAGE_CODE} |
Apenas a parte do idioma (a parte antes do primeiro _). |
fr, de, es, pt, zh |
Qualquer um dos dois placeholders pode ser usado em qualquer prompt personalizado — não apenas na diretriz de idioma. Eles são especialmente úteis quando você quer que o agente se comporte de forma diferente para locais específicos (por exemplo, aplicar um estilo de assinatura diferente para usuários do francês canadense em relação a usuários do francês europeu).
As diretivas de idioma integradas
A REDA AI entrega quatro pequenos prompts de diretiva de idioma, um por canal, semeados na instalação. São registros de Prompt personalizado comuns e podem ser editados como qualquer outro.
| Nome do prompt | Canal | Tokens aprox. | Usa {USER_LANGUAGE}? |
|---|---|---|---|
_common:language-directive |
Internal | ~40 | Yes |
_common:language-directive-community |
Community | ~20 | Yes |
_common:language-directive-external |
External Widget | ~70 | No |
_common:language-directive-api |
API | ~70 | No |
Os dois canais sem uma pessoa autenticada são os mais longos e, de propósito, não trazem
placeholder. No widget externo o usuário em execução é um usuário convidado do Sites; na
API é a conta de integração ou de Processo automatizado. Ali o {USER_LANGUAGE} resolveria para
o idioma da conta de serviço e o imporia a cada interlocutor. Por isso, em vez de um placeholder,
essas duas escrevem a política por extenso: responda no idioma da mensagem que você está respondendo,
ignore o idioma da conta ou do site que enviou a requisição, recorra à mensagem anterior quando uma saudação
for curta demais para identificar, e use inglês apenas se não houver nada em que se basear. É essa política
escrita que as leva a cerca de 70 tokens em vez de 20.
A diretiva do canal interno é a que acrescenta a ressalva de parsing: responda no idioma do usuário, mas mantenha em inglês os nomes de API, os Ids de registro e os tokens estruturais (marcadores de sugestão, etiquetas de alerta, links internos), para que as partes da resposta que a plataforma usa para rotear sobrevivam à tradução.
Prompts semeados são dados, não metadados. Uma atualização do pacote nunca os reescreve, então uma organização que instalou antes de uma diretiva mudar mantém o texto antigo até um administrador executar Seed Default Data no console de administração da REDA AI. Se seus agentes de widget ou de API responderem no idioma errado, verifique o texto da diretiva no registro antes de mudar qualquer outra coisa.
A otimização de pular o inglês
As diretrizes de idioma só ajudam quando o idioma do usuário não é o inglês. Para usuários em inglês, a plataforma pula a diretriz por completo:
- O prompt de diretriz não é carregado
- Seus tokens não são adicionados ao prompt do sistema
- O modelo não gasta atenção em instruções que já segue por padrão
Isso é automático. Não há nada para configurar. Para uma base de usuários de língua inglesa, o recurso de diretriz de idioma tem custo zero.
O que permanece em inglês
A diretriz interna integrada instrui explicitamente o modelo a deixar certos elementos sem tradução:
- Nomes de API — nomes de campos, objetos e ferramentas permanecem em inglês para corresponder ao esquema do Salesforce e às definições de ferramentas do agente
- Ids de registro — obviamente não traduzíveis, mas vale a pena deixar explícito
- Tokens estruturais — marcadores de chip de sugestão (
SUGGESTIONS:), tags de alerta ([ALERT]), padrões de link interno ([[links]]) e marcadores semelhantes usados pela UI do chat para renderizar a resposta corretamente
As diretrizes de comunidade, widget externo e API mantêm essa regra mais simples — elas apenas afirmam “traduza todo o texto legível por humanos” sem enumerar exceções, já que a maioria dos canais que não são internos não usa os mesmos marcadores de UI.
Personalizando as diretrizes
As diretrizes pré-carregadas são bons padrões, mas podem ser editadas como qualquer Prompt personalizado. Personalizações comuns:
- Tom por idioma. Adicione notas estilísticas específicas do idioma — por exemplo, instruções para usar tratamento formal (vous em francês, Sie em alemão) em canais voltados para o cliente.
- Termos não traduzíveis. Se o seu domínio usa termos em inglês que devem permanecer em inglês mesmo em canais do cliente (nomes de marca, SKUs de produto, frases jurídicas), especifique-os na diretriz.
- Formatação de valores. Locais diferentes preferem formatos diferentes de número, data e moeda — uma instrução explícita evita que o modelo precise adivinhar.
As edições são persistidas nos registros de Prompt personalizado. O comportamento de pular o inglês continua se aplicando — usuários em inglês nunca veem a diretriz personalizada.
Além da diretriz
O comportamento sensível ao idioma pode ir além:
- Prompts condicionais por idioma. Adicione um prompt personalizado com conteúdo como
For users speaking {USER_LANGUAGE_CODE}, do X. Use os placeholders diretamente em qualquer prompt. - Chips de sugestão traduzidos. Os chips de sugestão suportam Custom Labels para tradução, então os botões de estado vazio do chat são localizados automaticamente pela infraestrutura de tradução do Salesforce.
- Campos de conteúdo localizados. Se o agente lê campos de contexto de registros que têm valores traduzidos, o modelo os vê no idioma correto — sem necessidade de configuração especial.
Consulte Variáveis de contexto de prompt para a lista completa de campos de mesclagem disponíveis em prompts personalizados.
Canais e idiomas
Cada canal usa seu próprio prompt de diretriz de idioma porque os trade-offs são diferentes:
- Interno — o idioma Salesforce do usuário em execução é a fonte oficial. Usuários internos geralmente têm uma preferência de idioma estável definida no seu registro de Usuário.
- Comunidade — usuários do portal também têm preferências de idioma; o mesmo mecanismo se aplica.
- Widget externo — o usuário é um convidado em um site público. A página que hospeda o widget pode configurar o idioma explicitamente; caso contrário, a plataforma recorre ao idioma configurado do usuário convidado.
- API — o usuário em execução é o usuário como o qual o Fluxo ou a integração é executado. Para integrações de mensagens multilíngues, execute o Fluxo como um usuário cujo idioma corresponda ao destinatário, ou use um prompt personalizado condicionado ao idioma conhecido da conversa.
Boas práticas
Não traduza prompts de persona manualmente. Manter uma persona por idioma é uma armadilha de manutenção. Escreva a persona uma vez em inglês e confie na diretriz de idioma para lidar com a tradução em tempo de execução.
Teste a exceção dos nomes de API. Se o agente estiver traduzindo incorretamente rótulos de campo ou quebrando marcadores estruturais, a exceção “apenas em inglês” da diretriz interna pode precisar de um ajuste.
Use os placeholders com moderação fora da diretriz. Uma única diretriz de idioma somada à capacidade multilíngue integrada do modelo cobre a maioria dos casos. Recorra à lógica condicional por idioma apenas quando houver um requisito estilístico ou jurídico específico.
Verifique com o Depurador de conversas. O Depurador mostra o prompt do sistema montado para uma conversa real — a forma mais rápida de confirmar se a diretriz foi (ou não) aplicada para um determinado usuário.
Acompanhe o consumo de créditos por canal. A diretriz interna tem ~40 tokens; as diretrizes de widget e API têm ~20. Em canais de alto volume, isso pesa menos do que um prompt de persona detalhado, mas vale a pena ter em mente.
Mudanças incluídas em 1.16000
Em agentes API e Widget Externo, as instruções de idioma seguem a mensagem recebida. Marcadores de usuário são aplicáveis apenas às rotas autenticadas Internal e Comunidade. Revise as diretivas compartilhadas de idioma e instruções API: concisão na resposta à automação não deve tornar mensagens enviadas a pessoas abruptas ou sem saudação. Preserve suas instruções ao mesclar os padrões.
Checklist de atualização do cliente
Perguntas frequentes
Não. A diretriz de idioma usa placeholders que resolvem para o idioma Salesforce do usuário, seja qual for — um único prompt cobre todos os idiomas suportados pelo modelo.
Para qualquer idioma que o modelo subjacente suportar. A plataforma não restringe o local — ela apenas passa o idioma Salesforce do usuário para o modelo e pede que ele responda nesse idioma.
A diretriz é a mesma para todos os idiomas que não sejam o inglês — é o placeholder que se adapta. Não existe um prompt por idioma que possa faltar.
A plataforma lê o idioma Salesforce do usuário em execução. Para forçar um idioma específico independentemente do usuário, edite o prompt de diretriz de idioma para fixar o valor (por exemplo, substitua {USER_LANGUAGE_CODE} por fr) — mas pense bem se isso é realmente o que você quer, já que isso sobrepõe a preferência do usuário.
O conteúdo de texto do cartão (títulos, resumos, descrições) é gerado pelo modelo e é traduzido junto com o restante da resposta. Nomes de API de campos, Ids de registro e os metadados estruturais da ação permanecem em inglês — é isso que a exceção “manter nomes de API em inglês” da diretriz interna garante.
Sim. {USER_LANGUAGE} e {USER_LANGUAGE_CODE} estão disponíveis em qualquer Prompt personalizado — a plataforma os substitui no momento da montagem. Consulte Variáveis de contexto de prompt.
Não. Usuários em inglês pulam a diretriz por completo — ela não é carregada, não é tokenizada e não é enviada ao modelo.
Próximos passos
Leia Variáveis de contexto de prompt para a lista completa de campos de mesclagem, ou Prompts personalizados por agente para adicionar comportamento condicional por idioma a agentes específicos.