U2 release changelog

• 1: Aura system components version
• 2: Aura bridge changelog
• 3: Aura deployment changelog
• 4: Aura Groot changelog
• 5: Aura KPIs Uploader changelog
• 6: Aura Bot changelog
• 7: Aura Channels changelog
• 8: Aura Complex Logic Framework changelog
• 9: Aura Authentication API changelog
• 10: Aura Utilities changelog
• 11: Aura Configuration API changelog
• 12: Aura file manager changelog
• 13: Aura documentation changelog

1 - Aura system components version

Aura system components versions

AKS versions

Kubernetes version can be obtained from an already deployed cluster with the following command, reading the information regarding Server version:

$ kubectl version
Client Version: ....
Server Version: version.Info{Major:"1", Minor:"26", GitVersion:"v1.26.3", GitCommit:"9e644106593f3f4aa98f8a84b23db5fa378900bd", GitTreeState:"clean", BuildDate:"2023-03-21T00:12:01Z", GoVersion:"go1.19.7", Compiler:"gc", Platform:"linux/amd64"}

• Kubernetes version: v1.26.3
• Nodepools:
  • common: v1.26.3
  • system: v1.26.3
  • management: v1.26.3
  • database: v1.26.3
  • redis: v1.26.3

Statefulsets

Deployments

EOL

2 - Aura bridge changelog

Aura bridge changelog

Changed

2023-07-03 - New field origin for incoming request log

• A new origin field has been included in the incoming request log.
• Affected documents:
  • Aura logging utility

3 - Aura deployment changelog

Changed

2023-07-12 - Updated Nginx version to 1.25.1

• Updated Nginx deployed versions to 1.25.1 to use a supported version.

4 - Aura Groot changelog

Aura Groot changelog

Added

2023-07-18 - Aura Groot is a new component

• Aura Groot is Aura’s implementation of Microsoft BotFramework root bot, i.e. the domain-based orchestrator of Aura’s requests. In this first version, it only applies a domain, that is the channel that originated the request. This means, that every channel can be led to a different skill, so to a different bot. This component is the first access point to Aura, and thus, in charge of validating the requests and responses.
• All Aura’s features are kept the same, so neither the channels nor the dialogs need to be modified. All the needed changes have been applied in Aura Bot and Aura Groot, to make the transition transparent to the rest of the components.
• Affected documents:
  • Aura Bot service
  • Aura Groot

2023-07-18 - KPI entities are written

• Aura Groot writes KPI entities to the same Blob Container of the rest of Aura’s components. It writes already existing entities but also some new ones:
  • GROOTMESSAGE: entity to store all the incoming and outgoing messages handled by Aura Groot.
  • USER: entity to store all the users handled by Aura Groot.
  • RECOGNIZER: entity to store all the recognizers handled by Aura Groot. In this version, only an internal recognizer to match each channel with its skill is used, but it is also stored as a recognizer interaction the eventual IntentResult returned by the skill.
• Affected documents:
  • Aura KPI entities

5 - Aura KPIs Uploader changelog

Aura KPIs Uploader changelog

Added

2023-07-18 - Skills are added as a new dimension

• Skills are now supported as a new dimension in Aura KPIs Uploader. Every time the job is run, the list of configured skills is retrieved from the Aura Configuration API and stored in Kernel Azure Storage, jointly with the list of Channels, Recognizers and LivingApps.
• Affected documents:
  • Aura KPIs Uploader

2023-07-18 - Aura Groot KPI entity files are uploaded to Kernel

• Aura Groot generates its own KPI entity files that are processed and uploaded to Kernel.
• Affected documents:
  • Aura KPIs Uploader

Fixed

2023-07-18 - CLF KPI entity files are processed and uploaded to Kernel

• Aura Complex Logic modules now writes its own API entity files and the files are processed and uploaded to Kernel.

6 - Aura Bot changelog

Aura Bot changelog

Added

2023-06-27 - Deterministic FAQ answers

Add getIndexedText function to generic dialog to obtain text resources based on dialogSettings information and entity value.

• Affected documents:
  • Generic Dialog V1
  • Configuration API Swagger

2023-07-03 - New global dialog to handle normalized TV content get info use case

• TV content get info use case is available for those channels working in channelData V3. The generic dialog v3, responsible for handling this experience, now includes a specific configuration for it.
• Affected documents:
  • generic-dialog-v3
  • TV content get info dialog v3

2023-07-19 - Provided new repository with the scaffolding of the Aura Mini Bot and Aura Mini Groot

• A new repository has been published with all the scaffolding needed to use a new Aura Mini Bot and Aura Mini Groot. It contains all the docker utilities and scripts needed to build and deploy the component.
• Affected documents:
  • Aura Mini Bot

Changed

2023-07-03 - New field origin for incoming request log

• A new origin field has been included in the incoming request log.
• Affected documents:
  • Aura logging utility

2023-07-07 - Incoming content-type field is sent from aura-bot to file-manager

• If a user sends a file from a WhatsApp channel to Aura, when it is sent as a document, the extension is not always included in the request, and it must be inferred from the Content-Type sent by WhatsApp in the body of the request. Currently, aura-bot sends the incoming Content-Type in the request to the file-manager, so it can store the file with a proper extension in all the cases.

• Affected documents:

  • file-manager recognizer

2023-07-18 - Aura Bot is no longer a single bot but a skill

• Aura Bot has been converted into a skill to be able to work jointly with Aura Groot. This change implies a lot of modifications regarding who is the first access point to Aura, and thus, in charge of validating the requests and responses. This is now Aura Groot. So, some of the middlewares previously needed by Aura Bot have been moved to Aura Groot.
• Some of these changes are:
  • Aura Bot is no longer responsible for validating the channelData of the requests and responses.
  • Aura Bridge now communicates with Aura Groot, so Aura Bot does not neeed to handle Aura APIKey header.
• Affected documents:
  • Aura Bot architecture
  • Aura Bot components
  • Aura Bot middlewares
  • Aura Bot environment variables

2023-07-18 - New version of Aura Mini Bot to work as a skill with Aura Mini Groot

• A new version of aura-mini-bot has been delivered so it works as a skill and can be used with aura-mini-groot.
• Affected documents:
  • Aura Mini Bot

Fixed

2023-07-18 - Prometheus HTTP request metrics aggregation

• Add a mechanism based on an environment variable to be able to aggregate HTTP path metrics in Prometheus.
• A new environment variable has been added to aura-bot to be able to aggregate HTTP path metrics in Prometheus. This variable is called AURA_PROMETHEUS_REGEX. By default, it contains an empty object, but it can be updated in the config-map of aura-bot to include all APIs that are used by all the dialogs. The variable contains a JSON object with the following structure: a key with the aggregation key to be used in Prometheus and a value with the regular expression to be used to match the path.

{
  "subscribed_products/$1/users/*/products": "/subscribed_products\\\\/(v\\\\d)\\\\/users\\\\/.*\\\\/products/"
}

• Affected documents:
  • Aura Bot environment variables

7 - Aura Channels changelog

Aura Channels changelog

Added

2023-06-27 - New setting in channels configuration to modify text resource reference

• settings.indexedResourceBase has been added to the channel configuration. This setting configures text’s reference to obtain a textual resource.
• Affected documents:
  • Current channel configuration

8 - Aura Complex Logic Framework changelog

Aura Complex Logic Framework changelog

Added

2023-05-19 - Added TV content get info plugin

• Generation of a new Complex Logic Framework plugin for the TV content get info use case.
• Affected documents:
  • TV content get info plugin

9 - Aura Authentication API changelog

Aura Authentication API changelog

Changed

2023-07-03 - New field origin for incoming request log

• A new origin field has been included in the incoming request log.
• Affected documents:
  • Aura logging utility

10 - Aura Utilities changelog

Aura Utilities changelog

Added

2022-07-19 - New utility to manage KPI entities in Aura Bot and Aura Groot

• As Aura Bot and Aura Groot KPI entities handling is pretty similar, a new utility has been created to manage them in both components.
• Affected documents:
  • aura-bot-kpis-utility

2022-07-19 - New utility to simplify the generation of Aura Mini Bot and Aura Mini Groot

• As Aura Bot and Aura Groot mini version generation is quite similar, so this new utility has been created to simplify the process, providing all the common elements needed.
• Affected documents:
  • aura-minibot-service-utility

Changed

2022-07-19 - Aura Configuration utility is now able to manage skills configuration

• Added new elements to load skills configuration and make it available for all Aura’s compoenents.
• Affected documents:
  • skill-configuration-utility

11 - Aura Configuration API changelog

Aura Configuration API changelog

Added

2022-07-19 - Endpoints to manage skills configuration

• Added new endpoints to manage skills configuration.
• Affected documents:
  • skill-module

Changed

2023-06-30 - New field origin for incoming request log

• A new origin field has been included in the incoming request log.
• Affected documents:
  • Aura logging utility

12 - Aura file manager changelog

Aura file manager changelog

Changed

2023-07-04 - file-manager is able to store files with a proper extension in all the cases

• The new version of the file-manager API includes the content-type field, so it can be used to infer a proper extension to store the file for the cases when the provided URL has no extension.

• Affected documents:

  • File Manager API

13 - Aura documentation changelog

Aura documentation changelog

Added

2023-07-19 - Delivery of Aura distributed architecture documentation

• Phase 1 of Aura distributed architecture has been successfully implemented in U2 release. Alongside the development work completed for this phase, Aura Platform Team has generated various documents for readers with varying levels of technical expertise and roles in the project, to understand the new Aura ecosystem: its main functionalities and benefits, operation, key components and practical guidelines.

• Affected documents:

  • Aura distributed architecture Introduction to the new architecture: functional overview, operation at a glance and functional description of the implementation phases. Documents suitable for business managers and less skilled technical profiles.
  • Aura Bot service Technical descriptive documentation regarding Aura’s development architecture and its key components. Documents suitable for Aura technical teams.
  • Manage skills Practical guidelines for the development of skills and the connection of a skill to Aura Root. Documents suitable for Aura technical teams.

Changed

2023-07-17 - Moved Aura Bot messages and events information

• Flowcharts related to aura-bot messages and events were in a wrong location.
• The diagram showing the messages flow into aura-bot has been moved to the aura-bot architecture section. Moreover, information regarding the different types of activities in the bot is included.
• Detailed information regarding events is included in the incoming-event-middleware documentation.
• Affected documents:
  • Aura Bot architecture
  • incoming-event-middleware

2023-07-17 - Documents fixes and corrections

Throughout the website, different links, styles and typos have been corrected, for a continuous improvement of Aura Platform documentation.

Deleted

2023-07-17 - Deleted document related to releases previous to Killers

• Deleted guidelines for the migration of a use case from releases previous to Killers to this version onwards, as this process is outdated.