Agentes multilingües
Cómo funciona
Cada usuario tiene un Idioma definido en su registro de usuario de Salesforce (el campo es técnicamente LanguageLocaleKey — con valores como fr, de, es_MX, ja, zh_CN). La plataforma lo lee al inicio de cada conversación y lo usa para decidir si inyecta una directiva de idioma en el prompt del sistema del agente.
-
Leer el idioma del usuario
Desde el perfil de Salesforce del usuario en ejecución, sin necesidad de configuración por agente.
-
Optimización solo para inglés
Si el idioma es inglés (cualquier configuración regional en inglés), la plataforma omite por completo la directiva de idioma. No se gastan tokens en indicarle al modelo que haga lo que ya hace de forma predeterminada.
-
Anexar la directiva
La plataforma carga el prompt de directiva de idioma específico del canal, sustituye los valores de idioma del usuario en los marcadores de posición y lo incluye en el prompt del sistema ensamblado.
-
El modelo responde
El agente lee la directiva en su prompt del sistema y responde en el idioma del usuario durante el resto de la conversación.
Los dos marcadores de posición
Los prompts personalizados pueden hacer referencia al idioma del usuario en ejecución con dos marcadores de posición:
| Marcador de posición | Se resuelve como | Valores de ejemplo |
|---|---|---|
{USER_LANGUAGE} |
La configuración regional de idioma completa de Salesforce. | fr, de, es_MX, pt_BR, zh_CN |
{USER_LANGUAGE_CODE} |
Solo la parte del idioma (lo que está antes del primer _). |
fr, de, es, pt, zh |
Cualquiera de los dos marcadores de posición puede usarse en cualquier prompt personalizado, no solo en la directiva de idioma. Resultan especialmente útiles cuando quieres que el agente se comporte de forma distinta para configuraciones regionales específicas (por ejemplo, aplicar un estilo de firma diferente para los usuarios de francés canadiense que para los de francés europeo).
Las directivas de idioma integradas
Con REDA AI se entregan cuatro pequeños prompts de directiva de idioma, uno por canal, sembrados en la instalación. Son registros de Prompt personalizado normales y se pueden editar como cualquier otro.
| Nombre del 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 |
Los dos canales sin una persona autenticada son los más largos y, deliberadamente, no llevan
marcador de posición. En el widget externo el usuario en ejecución es un usuario invitado
de Sites; en API es la cuenta de integración o de Proceso automatizado. Allí {USER_LANGUAGE}
resolvería al idioma de la cuenta de servicio y se lo impondría a cada interlocutor. Por eso, en
lugar de un marcador, esas dos directivas expresan la política con palabras: responde en el idioma del
mensaje que estás contestando, ignora el idioma de la cuenta o del sitio que envió la solicitud, recurre al
mensaje anterior cuando un saludo sea demasiado corto para identificarlo y usa inglés solo si no hay nada en
lo que basarse. Esa política escrita es lo que las lleva a unos 70 tokens en lugar de 20.
La directiva del canal interno es la que añade la salvedad de análisis: responde en el idioma del usuario pero mantén en inglés los nombres de API, los Ids de registro y los tokens estructurales (marcadores de sugerencias, etiquetas de alerta, enlaces internos), para que las partes de la respuesta que la plataforma usa para enrutar sobrevivan a la traducción.
Los prompts sembrados son datos, no metadatos. Una actualización del paquete nunca los reescribe, así que una organización que instaló antes de que cambiara una directiva conserva el texto antiguo hasta que un administrador ejecute Seed Default Data en la consola de administración de REDA AI. Si tus agentes de widget o de API responden en el idioma equivocado, revisa el texto de la directiva en el registro antes de cambiar cualquier otra cosa.
La optimización de omisión para inglés
Las directivas de idioma solo ayudan cuando el idioma del usuario no es el inglés. Para los usuarios en inglés, la plataforma omite la directiva por completo:
- El prompt de la directiva no se carga
- Sus tokens no se añaden al prompt del sistema
- El modelo no dedica atención a instrucciones que ya sigue de forma predeterminada
Esto es automático. No hay nada que configurar. Para una base de usuarios angloparlante, la función de directiva de idioma tiene costo cero.
Qué permanece en inglés
La directiva interna integrada le indica explícitamente al modelo que deje ciertos elementos sin traducir:
- Nombres de API — los nombres de campos, objetos y herramientas permanecen en inglés para que coincidan con el esquema de Salesforce y las definiciones de herramientas del agente
- Ids de registro — obviamente no son traducibles, pero conviene dejarlo explícito
- Tokens estructurales — marcadores de chips de sugerencias (
SUGGESTIONS:), etiquetas de alerta ([ALERT]), patrones de enlaces internos ([[links]]) y marcadores similares que la interfaz de chat usa para representar la respuesta correctamente
Las directivas de comunidad, externa y de API mantienen esta regla más simple: solo indican “traduce todo el texto legible para las personas” sin enumerar excepciones, ya que la mayoría de los canales no internos no usan los mismos marcadores de interfaz.
Personalizar las directivas
Las directivas inicializadas son buenos valores predeterminados, pero pueden editarse como cualquier prompt personalizado. Personalizaciones comunes:
- Tono por idioma. Agrega notas estilísticas específicas del idioma — por ejemplo, instrucciones para usar el tratamiento formal (vous en francés, Sie en alemán) en los canales de cara al cliente.
- Términos no traducibles. Si tu dominio usa términos en inglés que deben permanecer en inglés incluso en los canales de cliente (nombres de marca, SKU de productos, frases legales), especifícalos en la directiva.
- Formato de valores. Cada configuración regional prefiere formatos distintos de número, fecha y moneda — una instrucción explícita evita que el modelo tenga que adivinar.
Las ediciones se guardan en los registros de prompt personalizado. El comportamiento de omisión para inglés se sigue aplicando — los usuarios en inglés nunca ven la directiva personalizada.
Más allá de la directiva
El comportamiento consciente del idioma puede ampliarse aún más:
- Prompts condicionados por idioma. Agrega un prompt personalizado con contenido como
For users speaking {USER_LANGUAGE_CODE}, do X. Usa los marcadores de posición directamente en cualquier prompt. - Chips de sugerencias traducidos. Los chips de sugerencias admiten etiquetas personalizadas para su traducción, de modo que los botones del estado vacío del chat se localizan automáticamente mediante la infraestructura de traducción de Salesforce.
- Campos de contenido localizados. Si el agente lee campos de contexto de registros que tienen valores traducidos, el modelo los ve en el idioma correcto — sin necesidad de configuración especial.
Consulta Variables de contexto de prompts para ver la lista completa de campos de combinación disponibles en los prompts personalizados.
Canales e idiomas
Cada canal usa su propio prompt de directiva de idioma porque las ventajas y desventajas difieren:
- Interno — el idioma de Salesforce del usuario en ejecución es la fuente de referencia. Los usuarios internos suelen tener una preferencia de idioma estable definida en su registro de usuario.
- Comunidad — los usuarios del portal también tienen preferencias de idioma; se aplica el mismo mecanismo.
- Widget externo — el usuario es un invitado en un sitio web público. La página anfitriona del widget puede configurar el idioma de forma explícita; de lo contrario, la plataforma recurre al idioma configurado del usuario invitado.
- API — el usuario en ejecución es aquel con el que se ejecuta el Flujo o la integración. Para integraciones de mensajería multilingües, ejecuta el Flujo como un usuario cuyo idioma coincida con el del destinatario, o usa un prompt personalizado que se condicione al idioma conocido de la conversación.
Prácticas recomendadas
No traduzcas manualmente los prompts de personalidad. Mantener una personalidad por idioma es una trampa de mantenimiento. Escribe la personalidad una sola vez en inglés y confía en que la directiva de idioma se encargue de la traducción en tiempo de ejecución.
Prueba la excepción de nombres de API. Si el agente traduce mal las etiquetas de los campos o rompe los marcadores estructurales, puede que la excepción de solo inglés de la directiva interna necesite un ajuste.
Usa los marcadores de posición con moderación fuera de la directiva. Una sola directiva de idioma, sumada a la capacidad multilingüe integrada del modelo, resuelve la mayoría de los casos. Recurre a la lógica condicional por idioma solo cuando tengas un requisito estilístico o legal específico.
Verifica con el Depurador de conversaciones. El Depurador muestra el prompt del sistema ensamblado para una conversación real — la forma más rápida de confirmar si la directiva se aplicó (o no) para un usuario determinado.
Vigila el consumo de créditos por canal. La directiva interna es de ~40 tokens; las directivas de widget y de API son de ~20. En canales de alto volumen esto importa menos que un prompt de personalidad extenso, pero conviene tenerlo en cuenta.
Cambios incluidos en 1.16000
En los agentes API y Widget externo, las instrucciones de idioma siguen el mensaje recibido. Los marcadores de usuario corresponden únicamente a las rutas autenticadas Interno y Comunidad. Revise las directivas compartidas de idioma y las instrucciones API: una respuesta concisa a la automatización no debe hacer que un mensaje enviado a una persona carezca de saludo o resulte brusco. Preserve las instrucciones propias al combinar los valores predeterminados.
Lista de actualización del cliente
Preguntas frecuentes
No. La directiva de idioma usa marcadores de posición que se resuelven según el idioma de Salesforce que tenga el usuario — un solo prompt cubre todos los idiomas que el modelo admite.
Con los que admita el modelo subyacente. La plataforma no restringe la configuración regional — simplemente pasa el idioma de Salesforce del usuario al modelo y le pide que responda en ese idioma.
La directiva es la misma para todos los idiomas distintos del inglés — lo que se adapta es el marcador de posición. No existe un prompt por idioma que pueda faltar.
La plataforma lee el idioma de Salesforce del usuario en ejecución. Para forzar un idioma específico sin importar el usuario, edita el prompt de directiva de idioma para codificar el valor de forma fija (por ejemplo, reemplaza {USER_LANGUAGE_CODE} por fr) — pero piénsalo bien, ya que esto anula la preferencia del usuario.
El contenido de texto de la tarjeta (títulos, resúmenes, descripciones) lo genera el modelo y se traduce junto con el resto de la respuesta. Los nombres de API de los campos, los Ids de registro y los metadatos estructurales de la acción permanecen en inglés — eso es lo que garantiza la excepción de “mantener los nombres de API en inglés” de la directiva interna.
Sí. {USER_LANGUAGE} y {USER_LANGUAGE_CODE} están disponibles en cualquier prompt personalizado — la plataforma los sustituye en el momento del ensamblado. Consulta Variables de contexto de prompts.
No. Los usuarios en inglés omiten la directiva por completo — no se carga, no se tokeniza y no se envía al modelo.
Próximos pasos
Lee Variables de contexto de prompts para ver la lista completa de campos de combinación, o Prompts personalizados por agente para añadir comportamiento condicionado por idioma a agentes específicos.