El desarrollo del asistente digital tiene que ver con la persona que ha diseñado para él. La persona define el idioma, el tono de voz y la actitud de un asistente digital.

Para garantizar que el asistente digital asuma la personalidad que ha diseñado, debe mantener el control de los mensajes salientes del bot para cada idioma que soporte. Los grupos de recursos representan un único lugar donde se gestionan los mensajes de bot, lo que facilita la coherencia del tono de voz. Para crear asistentes digitales que admitan un segundo idioma, no hay ninguna alternativa realista a los grupos de recursos para mostrar mensajes de bot.

Las cadenas de grupos de recursos se crean de forma declarativa en las aptitudes y los asistentes digitales de Oracle Digital Assistant. Las hace referencia desde conversaciones, en entidades y en valores de configuración de aptitudes mediante expresiones FreeMarker de Apache. Para hacer referencia a una cadena de mensaje, utilice una expresión como la siguiente:

${rb('message_key')}

rb hace referencia a la definición del grupo de recursos y busca un identificador de mensaje con el nombre especificado. En el ejemplo anterior, buscaría una clave de mensaje con el nombre message_key.

Si no existe un nombre de clave de grupo de recursos para el idioma del usuario, se utilizará la cadena definida para el idioma predeterminado (el idioma base). Si falta una cadena de mensaje para el idioma por defecto, se devuelve una excepción durante la prueba de tiempo de ejecución.

Si necesita transferir datos a un mensaje impreso a través de un grupo de recursos, puede hacerlo a través de parámetros posicionales y con nombre.

Parámetro de posición: Hello {0}, {1}

Parámetro con nombre: Hello {name}, {greeting}

Para transferir valores que lea de las variables agregadas a una conversación, utilice una expresión como la que se muestra a continuación.

Para parámetros posicionales: ${rb('message_key',firstname.value, greetingMessage.value)}

Para parámetros con nombre: ${rb('message_key','name,greeting',firstname.value, greetingMessage.value)}

Aunque los parámetros posicionales parecen más fáciles de utilizar, le recomendamos que utilice parámetros con nombre cuando pueda, ya que proporcionan el contexto para el tipo de datos que se agrega a un mensaje. Conocer el contexto facilita la vida de un traductor.

El uso completo de grupos de recursos en la aptitud significa hacer referencia a ellos desde entidades, el flujo de diálogo y desde la configuración de la aptitud y el asistente digital. Para facilitar la búsqueda de referencias de cadenas de grupos de recursos en la aptitud y el asistente digital, recomendamos agregar contexto a los nombres de clave del grupo de recursos mediante la implantación de una convención de nomenclatura.

Por ejemplo, puede utilizar los siguientes nombres para un mensaje de error, un mensaje de desambiguación y peticiones de datos en una entidad de lista de valores:

• list.<entity_name>.errorMessage

• list.<entity_name>.disambiguationMessage

• list.<entity_name>.prompt1

• list.<entity_name>.prompt2

Para una entidad de bolsa compuesta, puede utilizar una estructura de nomenclatura similar, pero agregarle el nombre del elemento de bolsa:

• cbe.<entity_name>.<bag_item_name>.errorMessage

• cbe.<entity_name>.<bag_item_name>.disambiguationMessage

• cbe.<entity_name>.<bag_item_name>.prompt1

• cbe.<entity_name>.<bag_item_name>.prompt2

Si hace referencia a una cadena de grupo de recursos desde la petición de datos de un estado de flujo de diálogo, o si un estado de flujo de diálogo solo imprime un mensaje de usuario que puede utilizar:

• <dialog_flow_state_name>.prompt

• <dialog_flow_state_name>.message

Para los elementos globales, como los botones de paginación o ayuda de un componente de respuesta común, puede utilizar una convención de nomenclatura que no contenga el nombre de un estado de flujo de diálogo específico:

• button.next

• button.previous

• button.cancel

• button.help

No existe una regla estricta sobre si se utiliza la notación de puntos como en los ejemplos anteriores, los guiones bajos o algo propio.

El componente Respuesta común permite definir palabras clave para elementos de acción para que el usuario pueda "presionar virtualmente"las enviando la palabra clave como mensaje. Las palabras clave son especialmente importantes si la interfaz de usuario no permite al usuario pulsar un botón (como cuando se utilizan canales de solo texto o voz).

Como un recordatorio suave pero obvio, "enviar" no se llama "enviar" en alemán, portugués, francés, árabe y todos los demás idiomas que admite con su bot. Por lo tanto, es bueno saber que la propiedad keyword de los elementos de acción en el componente de respuesta común se puede leer desde una clave de grupo de recursos. El mensaje del grupo de recursos sería una lista separada por comas de palabras clave que desea utilizar.

Este ejemplo de mensaje de grupo de recursos espera que se transfiera el argumento para region al hacer referencia al nombre de clave del grupo de recursos. En el ejemplo, los valores que se deben manejar de forma diferente se definen como region1 y region2. Puede establecer esos valores como desee, por ejemplo, en un código de país.

{region, select,
  region1 {message for region 1}
  region2 {message for region 2}
  other {message for all other regions}
}

Para hacer referencia al mensaje del grupo de recursos para una de las regiones, debe utilizar la siguiente expresión en la configuración de flujo de diálogo, entidad o aptitud:

${rb('the_key_name','region','<VARIABLE_CONTAINING_REGION_VALUE>.value')}

<VARIABLE_CONTAINING_REGION_VALUE> se debe sustituir por un nombre de variable en la aptitud que contenga el valor para el que tiene un mensaje diferente definido.