Youngblood release changelog

• 1: Aura system components version
• 2: Aura Authentication API changelog
• 3: Aura Bot changelog
• 4: Aura Bridge changelog
• 5: Aura Channels changelog
• 6: Aura Configuration API changelog
• 7: Aura deployment changelog
• 8: Aura File Manager changelog
• 9: Aura Gateway API changelog
• 10: Aura Groot changelog
• 11: Aura KPIs changelog
• 12: Aura KPIs Uploader changelog
• 13: Aura NLP changelog
• 14: Aura utilities changelog
• 15: Aura documentation changelog

1 - Aura system components version

Aura system components versions

Components versions

All components in the table below run over AKS cluster version 1.26.

Name	Namespace	Image deployed
alertmanager	aura-system	devopstf.azurecr.io/tools/alertmanager:v0.23.0
elastic-operator	aura-system	docker.elastic.co/eck/eck-operator:2.7.0
elasticsearch-es-aura	aura-system	devopstf.azurecr.io/tools/elasticsearch:8.7.0
elasticsearch-exporter	aura-system	devopstf.azurecr.io/tools/elasticsearch_exporter:v1.5.0
fluent-bit-aggregator	aura-system	devopstf.azurecr.io/tools/fluent-bit:1.7.7
grafana	aura-system	devopstf.azurecr.io/tools/grafana:8.5.21
kibana-kb	aura-system	docker.elastic.co/kibana/kibana:8.7.0
prometheus	aura-system	devopstf.azurecr.io/tools/prom/prometheus:v2.32.1
mongodb	aura-system	devopstf.azurecr.io/tools/mongo:4.4.18
mongodb-atlas-operator	aura-system	devopstf.azurecr.io/tools/mongodb-atlas-kubernetes-operator:1.5.1
redis-exporter	aura-system	devopstf.azurecr.io/tools/redis-exporter:1.6.1
redis	aura-system	devopstf.azurecr.io/tools/redis:6.0.19
thanos-store-gateway	aura-system	devopstf.azurecr.io/tools/thanos:v0.24.0
atlas-logger	aura-system	devopstf.azurecr.io/tools/atlas-logger:1.0.0
azure-logger	aura-system	devopstf.azurecr.io/tools/azure-logger:1.3.1
pushgateway	aura-system	devopstf.azurecr.io/tools/pushgateway:v1.4.1
thanos-querier	aura-system	devopstf.azurecr.io/tools/thanos:v0.24.0

Additional information

Information regarding Aura system components end-of-life (EOL) and next updates is included in the document Scheduled updates in Aura components. Find it in the Aura releases section of your corresponding release.

2 - Aura Authentication API changelog

Aura Authentication API changelog

Updated

2023-11-02 - Update Aura Authentication docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-authentication-api and aura-tac-api docker images.

Fixed

2023-11-13 - Status that are not HTTP status codes should not logged as status

• Elastic parsers are configured to handle and index the status field of logs, but it only works properly if status is an integer value or if it is a string parseable to integer. As we were logging some status that were not integer values, Elastic parsing was broken.
• In Terms and Conditions API, within service, we are logging the status of the consent in the database, that is a string not parseable to integer, as status has been changed to tac.status.

2023-11-13 - Use correct drt value in logs

• The field drt should be an integer value containing the number of milliseconds that the request took to be processed, but in some cases it was a float value.
• This fix ensures that the drt field is always an integer value.

3 - Aura Bot changelog

Aura bot changelog

Updated

2023-11-02 - Update Aura Bot docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-bot, aura-mini-bot and aura-configuration-updater docker images.

Fixed

2023-11-13 - Fix correlator value in several aura-bot logs

• aura-storage-file-manager now uses aura-system as correlator value in the logs.
• aura-session-manager now uses the correlator of the request in the logs.
• channel-data-utils now uses the correlator of the request in the logs.
• aura-cache-management now uses the correlator of the request in the logs.
• aura-authentication now uses the correlator of the request in the logs.
• aura-cache-management now uses the correlator of the request in the logs.

2023-11-13 - Remove by default settings of aura-bot-common-library

• By default, dialog-config.json file assured that all smalltalk intents were available in all channels, unless a different configuration was specified in the dialog-config file specific for a country.
• Currently, this default behavior is no longer needed, so the default configuration has been removed from aura-bot-common-library. Now, if a country does not specify a configuration for smalltalk intents, they will not be available in the channels.

2023-11-13 - Status that are not HTTP status codes should not logged as status

• Elastic parsers are configured to handle and index the status field of logs, but it only works properly if status is an integer value or if it is a string parseable to integer. As we were logging some status that were not integer values, Elastic parsing was broken.
• In channel-data-utils we are logging the status of the response, that is an object, as status has been changed to activityStatus.

2023-11-13 - Aura Bot was blocked for a long time when aura-bot-mocks-library configuration was refreshed

• aura-bot-mocks-library configuration is stored in Azure Storage and was downloaded every 2 minutes to assure that the mock dialog sent the right answer.
• As the files are quite big, the download process could take a long time, and during that time, the bot was blocked and could not answer any request. Moreover, some of the requests being processed were stuck and not answered until the download process had finished.
• Besides, the responses of the mock are never changed, so the download process is not needed. We have changed the default configuration to once a day to avoid the download process and the bot blocking.

2023-11-13 - isCached field has now a correct value for anonymous users in Aura Bot KPI USER entity files

• isCached field is used to know if the information of a user has been read from the users’ cache or not. But for anonymous users, the value of this field was always false, even if the user was cached.

2023-11-13 - Avoid skipping T&C for recently logged users

• With shared caches for anonymous and authenticated users, in some cases T&C could be skipped in recently authenticated users.

4 - Aura Bridge changelog

Aura bridge changelog

Updated

2023-11-02 - Update Aura Bridge docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-bridge and aura-bridge-outbound docker images.

Added

2023-11-16 - Updated environment variables information

• A new column is added in aura-bridge environment variables documentation to mark if the value of each variable in the config-map of the inbound and outbound aura-bridge must be the same or not, taking into account that they both work together and require a consistent configuration.
• Remember that the inbound and outbound aura-bridge are the very same component, but they are deployed separately. In the deployment aura-bridge handles the requests coming to Aura and aura-bridge-outbound handles the responses produced by Aura.
• Affected documents:
  • aura-bridge-outbound
  • aura-bridge environment variables

2023-11-07 - Unify the conversationId regardless of the phone number format in BR

• aura-bridge now unifies the conversationId regardless of the phone number format in BR. This change applied to the aurapush-incoming-processor and whatsapp-incoming-processor plugins. Both plugins now use the getUnifiedConversationId method to obtain the conversationId.
• New environment variables AURA_PHONE_COUNTRY_CODE_NU and AURA_WHATSAPP_BR_UNIFIED_CONVID are added to aura-bridge.
• Affected documents:
  • aura-bridge environment variables
  • whatsapp-service plugin

Fixed

2023-11-13 - Sibling messages are no longer sent when a non-retriable error is received

• Until this fix, when a non-retriable error was received, the sibling messages were sent to the user, although a previous message within the response had already failed.
• Now, when a non-retriable error is received, the sibling messages are not sent to the user, as was specified for aura-bridge.

2023-11-13 - Fix extra delay when multiple bubbles are returned

• Until this fix, when multiple bubbles were returned within a response, an extra delay was added between each bubble.

2023-11-13 - Status that are not HTTP status codes should not logged as status

• Elastic parsers are configured to handle and index the status field of logs, but it only works properly if status is an integer value or if it is a string parseable to integer. As we were logging some status that were not integer values, Elastic parsing was broken.
• In message-sync-manager-redis we are logging the status of the message in the queue, that is a string not parseable to integer, as status has been changed to messageStatus.

2023-11-13 - Avoid delay in the delivery of the messages when the communication between Aura Bridge and Aura Groot fails

• The common system of handling the flows within aura-bridge, aura-bridge-flow, has been changed so the system is now able to register the information of each message when it is needed and to remove it in the happening of a non-recoverable error.

2023-11-13 - Do not return options list header when the UC returns a message without text

• Until this fix the options title was being added if any option existed, although those titles were empty.
• directline-to-whatsapp-converter has been updated so the title is only added if there is information of any of the options, so the titles are not empty.

2023-11-13 - Avoid duplicates in error messages after receiving a retrievable error

• Until this fix after receiving a retrievable error several times, the error message was being duplicated.

2023-10-31 - Avoid duplicates in outgoing messages (Tequila 8.0.1.)

Modified the execution of aura-bridge queues to avoid duplicating output messages.

5 - Aura Channels changelog

Aura Channels changelog

Changed

2023-11-07 - Updated Aura channel model documentation

• Aura channel model documentation has been completed, with the addition of key information:
  • Update of specific parameters and values
  • Information related to requirements for the registration of a channel in Aura in two different scenarios:
    • Registration of a channel that will work against aura-bot skill
    • Registration of a channel that will work against a third-party skill
  • New column indicating which are the Aura Platform components affected by a specific property.
• Affected documents:
  • Aura channel model

Fixed

2023-11-13 - Review textConvert setting in the channels configuration

• In U2 release, textConvert option was moved from WhatsApp settings to responseOptions but Brazil local channels were not updated. With this fix, channels are created with the correct configuration.
• Affected documents:
  • Current channel configuration

6 - Aura Configuration API changelog

Aura Configuration API changelog

Updated

2023-11-02 - Update Aura Configuration API docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-configuration-api docker image.

7 - Aura deployment changelog

Added

2023-10-07 - New OBs specific configuration section

• Added a new section with specific configurations for OBs.
• Affected documents:
  • Installer aurak8s: Specific OB configuration

2023-10-07 - Added aurapush-sendfeedback-service configuration variables for BR

• Added configuration variables for aurapush-sendfeedback-service endpoint and subscription key.
• Affected documents:
  • Installer aurak8s: Configure aurapush-sendfeedback-service

8 - Aura File Manager changelog

Aura File Manager changelog

Updated

2023-11-02 - Update Aura File Manager docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-file-manager docker image.

Fixed

2023-11-13 - Review Aura File Manager indexes

• Included all the needed indexes in the database to improve performance.

9 - Aura Gateway API changelog

Aura Gateway API service changelog

Added

2023-10-27 - Aura Gateway API service

• New component in Aura: aura-gateway-api service, composed by several plugins. This component receives a request from a channel or a external service, validates it and, in upcoming releases, will be able to send the request to OpenAI for the autogeneration of answers.
• Affected documents:
  • aura-gateway-api service description
  • aura-gateway-api service environment variables
  • aura-gateway-api service APIs

2023-11-02 - Guidelines for working with Aura Gateway API service

• Guidelines including the process for accessing aura-gateway-api service and working with it. In the current Aura Platform release, YoungBlood, the implementation is mocked, only intended for basic integration purposes.
• Affected documents:
  • Guidelines for accessing aura-gateway-api

10 - Aura Groot changelog

Aura groot changelog

Updated

2023-11-02 - Update Aura Groot docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-groot and aura-mini-groot docker images.

Added

2023-11-13 - Aura Groot is now able to handle requests from Microsoft Facebook adapter

• Aura Groot is now able to get the channel from the field activity.channel, that is set to facebook by the Microsoft Facebook adapter.
• The limitation with this solution is that it can only handle a single facebook channel per aura-groot instance. To be able to handle more, it should take into account the information regarding the specific Facebook page that is sent in the request.

11 - Aura KPIs changelog

Aura KPIs changelog

Fixed

2023-11-07 - Add timezone indication in the KPIs entities

• Modified the definition of all aura-kpis-entities to include the UTC timezone of date-related fields.
• Affected documents:
  • API request
  • Dimensions
  • Extended Message
  • Groot Message
  • Message
  • Recognizer
  • Suggestion
  • User

12 - Aura KPIs Uploader changelog

Aura KPIs Uploader changelog

Updated

2023-11-02 - Update Aura KPIs Uploader docker image to the latest node 18 version

• Update to nodejs 18.18.2 version.
• Updated aura-kpis-uploader docker image.

13 - Aura NLP changelog

Aura NLP changelog

Added

2023-10-23 - New normalization stage wrappers

• Added a new normalization stage wrapper that identifies stop words from a customized database: “StopWordsFromFileNormalizerWrapper”
• Added a new normalization stage wrapper that exchanges words in an utterance: “WordReplacerFromFileNormalizerWrapper”
• Affected Documents:
  • Stop words from file
  • Word replacer from file

2023-10-23 - New normalization pipelines

• Added two new normalization pipelines “Niseko” and “Norikura”, that integrate the above-mentioned normalization stages.
• Affected Documents:
  • Niseko normalization pipeline
  • Norikura normalization pipeline

Changed

2023-10-23 - Improved stop words normalizer internal behavior

• Fix in the internal behavior of the stop words normalizer to solve potential problems in the recognition of entities. Internally, the recognizer is now able to work with phrase variations without normalizing them in order to preserve certain information that is useful for the recognition process.

2023-10-23 - Improved Gazetteer NER internal behavior with annotated entities

• Fix in the internal management of annotated entities by the Gazetteer NER recognition stage when working with phrases with more than one entity to ensure that the annotation process is made in the right order, thus avoiding collisions between different annotations.

2023-11-10 - Refactor of Aura NLP swagger

• Refactor of the aura-nlp swagger
• Affected documents:
  • aura-nlp API swagger

14 - Aura utilities changelog

Aura utilities changelog

Changed

2023-11-15 - aura-redis-handler utility

• Certain changes over aura-redis-handler utility related to its methods are documented.
• Affected documents:
  • aura-redis-handler utility

15 - Aura documentation changelog

Aura documentation changelog

Updated

2023-11-13 - Updated aura-logging utility documentation

• The aura-logging utility documentation has been updated to include the correct format of the logs and remove deprecated and incorrect information.
• Affected documents:
  • aura-logging utility

Changed

2023-11-14 - Update of Hugo and Docsy versions and website improvements

• Hugo, the website framework upon which Aura technical documentation website is built, has been updated to 0.120.4 version.
• Docsy, the prefigured Hugo’s theme used as template for Aura documentation has been updated to 0.7.1 version.
• Moreover, consistent with this update, certain optimization tasks have been implemented to enhance the usability of the website and improve the overall users’ experience:
  • New section menu A drop-down section menu is enabled, which is initially folded until the user clicks the arrow to the right of a specific section. This feature makes easier to identify the document hierarchy and to determine if a specific document contains sub-documents or not.
  • Print Tool The behavior of the tool that allows printing entire sections of the documentation has been corrected and optimized. Now you can generate a document, together with its child pages and sections, in a format suited to printing, with a complete table of contents for the section.
  • Corporate image Aura technical documentation website style, images and colors are updated to use corporate ones.

2023-11-01 - Adaptation of contents to Aura distributed architecture

• Documentation of key Aura components have been updated to include modifications related to the introduction of the new distributed architecture in Aura. Basically, references to aura-groot and components’ flowcharts have been modified. This task will continue in the following Aura Platform release until all the components documentation is updated.
• Affected documents:

2023-11-07 - New location for the documentation related to Aura request-response model

• In Aura’s distributed architecture, the Aura request-response semantic model is used not only by channels but also by skills to communicate with aura-root. In this framework:
  • Documentation has been moved out from the channels section and included directly into the components/ section.
  • Contents have been adapted to this new scenario, together with the addition of fields related to the communication with skills.
• Affected documents:
  • Aura request-response semantic model

2023-11-14 - Documents fixes and corrections

• Throughout the website, different links, styles and typos have been corrected, for a continuous improvement of Aura Platform documentation. Moreover, the README.md document, that contains detailed instructions for documentation makers and collaborators, has been completed.