Aura –

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura system components versions

Updated versions of Aura system components for the current Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura Authentication API changelog

Changelog of Aura Authentication API component for Youngblood Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura bot changelog

Changelog of Aura Bot component for Youngblood Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura bridge changelog

Changelog of Aura bridge component for Youngblood Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura Channels changelog

Changelog of Aura Channels component for Youngblood Aura Platform release

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

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura Configuration API changelog

Changelog of Aura Configuration API component for Youngblood Aura Platform release

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.

Docs: Aura deployment changelog

Mon, 01 Jan 0001 00:00:00 +0000

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

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura File Manager changelog

Changelog of Aura File Manager component for Youngblood Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura Gateway API service changelog

Changelog of Aura Gateway API service for Youngblood Aura Platform release

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:

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

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura groot changelog

Changelog of Aura groot component for Youngblood Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura KPIs changelog

Changelog of Aura KPIs component for Youngblood Aura Platform release

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:

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura KPIs Uploader changelog

Changelog of Aura KPIs Uploader component for Youngblood Aura Platform release

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura NLP changelog

Changelog of Aura NLP component for Youngblood Aura Platform release

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

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura utilities changelog

Changelog of Aura utilities for Youngblood Aura Platform release

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

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

Aura documentation changelog

Changelog of Aura Documentation for Youngblood Aura Platform release.

The current section:

✅ Includes changes that exclusively affect to the improvement of Aura documentation (writing style, structure, format, fixing typos, etc.)

⛔ Does not include technical corrections in documents or modifications derived from changes over a specific Aura component. These ones will be included in their corresponding section within the release 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:

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.

Aura –

Docs:

Aura system components versions

Components versions

Additional information

Docs:

Aura Authentication API changelog

Updated

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

Fixed

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

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

Docs:

Aura bot changelog

Updated

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

Fixed

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

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

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

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

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

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

Docs:

Aura bridge changelog

Updated

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

Added

2023-11-16 - Updated environment variables information

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

Fixed

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

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

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

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

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

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

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

Docs:

Aura Channels changelog

Changed

2023-11-07 - Updated Aura channel model documentation

Fixed

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

Docs:

Aura Configuration API changelog

Updated

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

Docs: Aura deployment changelog

Added

2023-10-07 - New OBs specific configuration section

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

Docs:

Aura File Manager changelog

Updated

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

Fixed

2023-11-13 - Review Aura File Manager indexes

Docs:

Aura Gateway API service changelog

Added

2023-10-27 - Aura Gateway API service

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

Docs:

Aura groot changelog

Updated

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

Added

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

Docs:

Aura KPIs changelog

Fixed

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

Docs:

Aura KPIs Uploader changelog

Updated

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

Docs:

Aura NLP changelog

Added

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

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