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.29

Name	Namespace	Image deployed
alertmanager	aura-system	devopstf.azurecr.io/tools/alertmanager:v0.26.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.1
elasticsearch-exporter	aura-system	devopstf.azurecr.io/tools/elasticsearch_exporter:v1.5.0
fluent-bit-aggregator	aura-system	devopstf.azurecr.io/tools/fluent-bit:2.2.0
grafana	aura-system	devopstf.azurecr.io/tools/grafana:10.3.3
kibana-kb	aura-system	docker.elastic.co/kibana/kibana:8.7.1
prometheus	aura-system	devopstf.azurecr.io/tools/prom/prometheus:v2.48.0
mongodb-atlas-operator	aura-system	devopstf.azurecr.io/tools/mongodb-atlas-kubernetes-operator:2.1.0
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.32.5
atlas-logger	aura-system	devopstf.azurecr.io/tools/atlas-logger:2.0.0
azure-logger	aura-system	devopstf.azurecr.io/tools/azure-logger:1.4.0
pushgateway	aura-system	devopstf.azurecr.io/tools/pushgateway:v1.4.1
thanos-querier	aura-system	devopstf.azurecr.io/tools/thanos:v0.32.5

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

Atria Model Gateway changelog

Changelog of Atria Model Gateway for Imagine Dragons Aura Platform release

Changed

2024-10-08 - Modifications in atria-model-gateway API swagger

The atria-model-gateway API swagger has been updated with:
- Improved error management
- Access to new aura-manager feature for adding references in the response
Affected documents:
- atria-model-gateway API definition

2024-10-08 - Update atria-model-gateway metrics

The atria-model-gateway metric http_request_duration_seconds_count includes a new field to differentiate requests by application.
status field is replaced by status_code.
Affected documents:
- atria-model-gateway metrics

Docs:

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

Atria RAG generate DB changelog

Changelog of Atria RAG generate DB for Imagine Dragons Aura Platform release

Added

2024-10-08 - New documentation for Atria RAG generate DB

New document for the description of the component atria-rag-generate-db.
References to this component in atria-model-gateway and atria-rag-server documentation.
Affected documents:
- atria-rag-generate-db documentation.

Docs:

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

Atria RAG Server changelog

Changelog of Atria RAG Server for Imagine Dragons Aura Platform release

Added

2024-10-08 - Add parameter in atria-rag-server error messages

A new field in error messages is defined for the atria-rag-server configuration: quota, that is shown when the system has operational problems.
Affected documents:
- atria-rag-server configuration

Changed

2024-10-08 - Update atria-rag-server metrics

The atria-rag-server metric http_request_duration_seconds_count includes a new field to differentiate requests by application.
status field is replaced by status_code.
Affected documents:
- atria-rag-server metrics

2024-10-01 - Redefined prompt for GPT-4o mini model

When using ATRIA RAG with the GPT-4o mini model, the system was able to generate responses beyond the scope of the intended experience, defined in the knowledge base documents.
This behavior has been adjusted with the redefinition of the prompt to ensure that the responses from ATRIA are limited to this scope.

2024-10-01 - Recognition of the request language

When a user made a request to ATRIA RAG in a specific language, the system did not recognize the idiom.
This behavior has been adjusted and now the input request language is detected and the response is provided in the same language to the user.

Docs:

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

Aura applications changelog

Changelog of applications for Imagine Dragons Aura Platform release

Added

2024-10-09 - Available brands and contact channels for Aura applications

Added the list of available Telefónica brands defined in Kernel within the D_Gbl_Brand global dimension entity.
Affected documents:
- Telefónica brands management

Docs:

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

Aura Authentication API changelog

Changelog of Aura Authentication API component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura Authentication API docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-authentication-api docker image to node:20.17.0-alpine3.20 version.

Docs:

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

Aura Bot changelog

Changelog of Aura Bot component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura Bot docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-bot, aura-minibot and aura-configuration-updater docker images to node:20.17.0-alpine3.20 version.

Docs:

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

Aura bridge changelog

Changelog of Aura bridge component for Bot-improvements-september Aura Platform release

Added

2024-09-26 - Added environment variable

Added environment variable AURA_HTTP_INCOMING_PATHS_LOG_DISABLED to configure paths to exclude from logs and metrics.
Affected documents:
- aura-bridge environment variables

Fixed

2024-09-26 - Correct Origin field in bridge metrics

aura-bridge now gets origin field in metrics from X-Real-IP header instead of x-forwarded-for to avoid errors in metrics.

Docs:

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

Aura channels changelog

Changelog of Aura channels for Imagine Dragons Aura Platform release

Added

2024-10-09 - Available brands and contact channels for Aura channels

Added the list of available Telefónica brands defined in Kernel within the D_Gbl_Brand global dimension entity.
Added the list of available Telefónica contact channels defined in Kernel within the D_Gbl_Contact_Channel global dimension entity.
Affected documents:
- Telefónica brands management
- Contact channels management

2024-09-02 - New fields added in Aura channel model

Added the mandatory field brand, that must contain the identifier of the Telefónica Brand a channel belongs to. It must be one of the brands defined in Kernel D_Gbl_Brand global dimension entity.
Added the mandatory field contact, that must contain the identifier of the type of contact channel. It must be one of the contact channels defined in Kernel D_Gbl_Contact_Channel global dimension entity.
Affected documents:
- Channels model

Docs:

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

Aura Complex Logic Framework changelog

Changelog of Aura Complex Logic Framework for Imagine Dragons Aura Platform release

Changed

2024-10-14 - Changed in Azure Storage where KPI files are stored

To avoid data files migrations between Aura releases, Aura Complex Logic Framework (CLF) KPI files are now stored in a common storage that is not release dependant.

2024-10-10 - Updated Postman collection for video contents

Updated Postman collection for the video contents Kernel API, called from the complex-logic-framework component.
Affected documents:
- Postman Collection - Video Contents Kernel API

Docs:

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

Aura Configuration API changelog

Changelog of Aura Configuration API component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura Configuration API docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-configuration-api docker image to node:20.17.0-alpine3.20 version.

Added

2024-10-09 - Available brands and contact channels

Added the list of available Telefónica brands defined in Kernel within the D_Gbl_Brand global dimension entity and managed by aura-configuration-api.
Added the list of available Telefónica contact channels defined in Kernel within the D_Gbl_Contact_Channel global dimension entity and managed by aura-configuration-api.
Affected documents:
- Telefónica brands management
- Contact channels management

2024-07-15 - Added component management in Aura Configuration API

A new set of endpoints has been added to manage the list of all components deployed in each instance of Aura: component-module.
aura-configuration-api documentation has been updated to include this new module and update the architecture diagrams.
Implemented the /aura-services/v1/configuration/components endpoints.
Added tests to cover the new functionalities.
Affected documents:

Docs:

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

Aura deployment changelog

Changelog of Aura deployment for Imagine Dragons Aura Platform release

Added

2024-09-19 - Guidelines for Databricks enabling

Aura installer documentation now includes the instructions to enable Databricks deployment, configuring the Databricks cluster and configuring the execution of the Databricks job.
Affected documents:
- Enable Databricks deployment

2024-10-15 - Integration of WAF rules in Aura Platform for Germany

In past releases, Aura Platform included NGINX Plus for Germany, enabling web application firewall (WAF) features and protection against DDoS attacks.
In the current release, the WAF rules recommended by Global CISO have been added. These rules work in transparent mode: only analysis and alerting but no blocking tasks take place.

Docs:

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

Aura File Manager changelog

Changelog of Aura File Manager component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura File Manager docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-file-manager docker image to node:20.17.0-alpine3.20 version.

Docs:

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

Aura Gateway API changelog

Changelog of Aura Gateway API component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura Gateway API docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-gateway-api docker image to node:20.17.0-alpine3.20 version.
Due to feature changes, this component no longer needs a bookworm-slim image, so it has been changed to alpine as the rest of Nodejs components

Added

2024-07-15 - Module kpis-handler in aura-gateway-api

A new module to write KPIs is included in aura-gateway-api: kpis-handler. This module is responsible for writing the entities Gateway Message and Api Request.
Affected documents:
- aura-gateway-api: kpis-handler
- aura-gateway-api environment variables

2024-08-30 - New Aura entity for aura-gateway-api

A new entity called Aura_Gateway_Message has been added to keep the interactions handled by aura-gateway-api, that is the main door to ATRIA features.
Affected documents:
- Aura Gateway Message definition

Changed

2024-10-10 - Published aura-gateway-api Generative API swagger in Kernel

Version 1.1 of the aura-gateway-api Generative API swagger has been published in Kernel.

2024-10-10 - Update aura-gateway-api Generative API swagger

The aura-gateway-api Generative API swagger has been modified to provide the references (information sources) that have been used to generate the response.
Affected documents:
- aura-gateway-api Generative API swagger

2024-10-08 - Update aura-gateway-api metrics

The aura-gateway-api metric http_request_duration_seconds_count includes fields to differentiate requests by application, channel and preset.
status field is replaced by status_code.
incoming_message_duration_seconds metric is deleted, as this information is stored in the previous one.
Affected documents:
- aura-gateway-api metrics

2024-10-08 - Modifications in request to Aura Generative API

Modified request that aura-gateway-api executes to call Aura Generative API and Aura NLP Resolution API.
Completed errors management documentation.
Affected documents:
- Request to Aura Generative API guidelines
- Request to Aura NLP resolution API guidelines

2024-10-07 - Change in aura-gateway-api environment variables

Modified AURA_KPI_FILE_PREFIX to be adapted to the updated KPIs entities files processing
Affected documents:
- aura-gateway-api environment variables

Docs:

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

Aura Groot changelog

Changelog of Aura Groot component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura Groot docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-bot and aura-minigroot docker images to node:20.17.0-alpine3.20 version.

Docs:

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

Aura KPIs entities changelog

Changelog of Aura KPIs entities for Imagine Dragons Aura Platform release

Added

2024-10-11 - Kernel datasets configuration

Added guidelines for the configuration of Kernel datasets.
Affected documents:
- Configuration of Kernel datasets

2024-10-07 - Update aura-kpis library events

Added aura-groot and aura-gateway-api events to the aura-kpis utility.
Affected documents:
- Aura utilities: aura-kpis

2024-09-19 - Aura Databricks job component

aura-databricks-jobs is a new component based on Databricks for the optimization of data processing and the training of ML-based models. Currently, its primary function is to import Avro-formatted files into Kernel datasets.
Affected documents:
- aura-databricks-jobs descriptive documentation
- aura-databricks-jobs user guide

2024-08-30 - Aura Entities generation in Avro format

Starting in Imagine Dragons release, entities will be generated in Avro format. Some existing entities are migrated to Avro, with an URM-compatible definition. Moreover, they are uploaded to Kernel datasets and must be consumed as the rest of datasets available in Kernel.

Affected documents:
- Aura KPI entities definition in Avro format

2024-08-30 - New Aura dimensions entities

The new entities in Avro format are:
- D_Aura_App
- D_Aura_Preset
- D_Aura_Component
Affected documents:
- Aura Dimensional entities

2024-08-30 - New Aura entity for aura-gateway-api

A new entity called Aura_Gateway_Message has been added in Avro format to keep the interactions handled by aura-gateway-api, that is the main door to ATRIA features.
Affected documents:
- Aura Gateway Message definition

Changed

2024-10-11 - Change in Azure Storage where KPI files are stored

To avoid data files migrations between Aura releases, KPI files are now stored in a common storage that is not release dependant.
All Aura and ATRIA components now write their files in this storage.
- They all have a new set of environment variables to handle this storage:
  - AURA_MICROSOFT_AZURE_STORAGE_COMMON_ACCOUNT
  - AURA_MICROSOFT_AZURE_STORAGE_COMMON_KEY
aura-kpis-uploader processes the files in this storage.
The structure within the blob storage is still the same for CSV files.
Affected documents:

2024-08-30 - Already existing Aura dimensions definition moved to Avro

To be URM compatible, the dimensions definitions have been updated and an Avro schema has been defined.
Currently, they are only generated in Avro.
Main changes are:
- D_Aura_Channel, added AURA_SKILL_ID, AURA_NLP_STAGES_ARRAY, GBL_CONTACT_CHANNEL_ID, BRAND_ID, EXTRACTION_TM
- D_Aura_LivingApp, added AURA_NLP_STAGES_ARRAY, EXTRACTION_TM
- D_Aura_Skill, added EXTERNAL_SKILL_IND, EXTRACTION_TM
Affected documents:
- Aura Dimensions definition

2024-08-30 - Updated GROOTMESSAGE entity definition

In order to fulfill AURA_AUDIT entity correctly, GROOTMESSAGE entity needs some extra fields:
- AURA_COMPONENT_ID: unique identifier of the Aura’s component writing the entity record.
- AURA_COMPONENT_HOST_ID: unique identifier of the Aura’s component POD writing the entity record.
- BRAND_ID: unique identifier of the Telefónica’s brand configured for the application or channel generating the entity record.
Affected documents:
- Aura Groot Message entity definition

Docs:

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

Aura KPIs Uploader changelog

Changelog of Aura KPIs Uploader component for Bot-improvements-september Aura Platform release

Updated

2024-10-03 - Update Aura KPIs Uploader docker image to the latest Node.js 20 version

Update of Node.js to version 20.17.0 to keep Aura platform up to date.
Updated aura-kpis-uploader docker image to node:20.17.0-alpine3.20 version.

Changed

2024-10-07 - Updated aura-kpis-uploader component

Modifications in the aura-kpis-uploader operation to manage both CSV and Avro entities.
Changed and new environment variables to handle both CSV and Avro features.
New component Adapter manager responsible for the copy of CSV files to Kernel and the generation of KPIs from Avro entities and dimensions.
Changes in Aura KPIs dimensions processing.
Changes in Aura KPIs entities processing for CSV and Avro entities.
aura-kpis-uploader user guide adapted to new processes.
aura-kpis-uploader troubleshooting adapted to new processes.
Affected documents:
- aura-kpis-uploader

2024-08-30 - Default value of days to upload changed to 30 days

Default value of the variable AURA_DAYS_INTERVAL has changed to 30 days.
It is also modified in the Aura installer, within the variable fourth_platform.conversations.days_to_find, that has changed to 30 days.
- ⚠️ It is necessary to remove the configuration of this variable from the config.yml of the Aura installer in every environment, to use the default value.

Docs:

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

Aura manager (ATRIA web interface) changelog

Changelog of Aura manager (ATRIA web interface) for Imagine Dragons Aura Platform release

Added

2024-10-08 - References in Aura manager

Now, aura-manager includes the information sources used to generate the response, so the user can have greater confidence in the answer provided and consult these references afterwards.
Affected documents:
- Use ATRIA web interface

Docs:

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

Aura monitoring changelog

Changelog of Aura monitoring for Imagine Dragons Aura Platform release

Changed

2024-10-08 - Replace `status` by `status_code`

The status field is replaced by status_codein the metric http_request_duration_seconds for different Aura components.
Affected documents:

Docs:

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

Aura NLP changelog

Changelog of Aura NLP component for Imagine Dragons Aura Platform release

Changed

2024-10-14 - Changed in Azure Storage where KPI files are stored

To avoid data files migrations between Aura releases, Aura NLP KPI files are now stored in a common storage that is not release dependant.

2024-10-10 - NLP dictionaries generation with Global ETL script

A new global script is available for the generation of dictionaries in Aura NLP that makes use of the URM content datasets uploaded to the Kernel platform.
Affected documents:
- Generation of Aura NLP dictionaries

Docs:

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

Aura Aura operations changelog

Changelog of Aura operations for Imagine Dragons Aura Platform release

Added

2024-10-07 - Added guidelines for Kernel datasets configuration

From Imagine Dragons release onwards, Aura datasets must be published in Kernel.
Affected documents:
- Kernel datasets configuration

Changed

2024-10-10 - Enhanced document for the publication of API in Kernel

Completed guidelines for publishing an API in Kernel, with examples and a more detailed description.
Affected documents:
- Publish an API in Kernel

2024-10-01 - Completed documentation regarding APIKeys generation

The documents aimed at the generation of APIKeys are improved to show the existing methods.
Affected documents:
- Generate an APIKey in Aura through the aura-api-key-generator utility
- Generate an APIKey in Aura from Aura installer aurak8s

Docs:

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

Aura documentation changelog

Changelog of Aura documentation for Imagine Dragons Aura Platform release

Added

2024-10-11 - Guidelines for disabling and enabling KPIs uploading in non-production environments

New operational document with the procedure to disable and enable KPIs uploading in non-production environments, to reduce costs.
Affected documents:
- Disable KPI uploading in pre environments

Changed

2024-10-17 Completed and improved ATRIA documentation

A new version of the top-level section ATRIA has been included in the Technical Documentation website with the objective of providing accurate contents suitable for both business and product profiles as well as specialized technical profiles.
- ATRIA documentation
In this section, the documentation structure has been designed in a pyramidal structure, from less to more technical complexity:
- At the top, basic information about ATRIA is provided with low technical complexity, understandable for all types of profiles:
  - Introduction to ATRIA: fundamentals and benefits of ATRIA
  - ATRIA capabilities: description of ATRIA AI-driven functionalities
- In a second level, the documents take a step further and show a higher level of technical detail:
  - ATRIA functional description: overview of the functional processes executed by ATRIA and its capabilities
- In a third-level, high-level technical documents are included, which will serve as guides for specialized technical profiles.
  - Building e2e experiences: Schematic overview of the end-to-end workflows for use cases development using ATRIA capabilities, including all the orderly steps of the process.
  - Technical guidelines: Comprehensive instructions for particular processes intended for highly-skilled technical teams.
Moreover, the documents related to ATRIA technical components and processes has been adjusted with the latest modifications and also completed and corrected. You can see these updates in the changelog of the corresponding technical component.

2024-10-17 - Documents fixes and corrections

Throughout the website, different links, styles, weights and typos have been modified and/or corrected, for a continuous improvement of Aura Platform documentation.
Tags and categories are reviewed in every release in order to maintain the adequate taxonomy for the classification of documents.

2024-10-01 - Improved guidelines for the publication of an API in Kernel

The technical guidelines for publishing an API in Kernel, required for the use of aura-gateway-api APIs, have been completed with additional details to enhance clarity and understanding.
Affected documents:
- Publish an API in Kernel

2024-10-01 - Completed documentation regarding APIKeys generation

The documents aimed at the generation of APIKeys are improved to show the existing methods.
Affected documents:
- Generate an APIKey in Aura through the aura-api-key-generator utility
- Generate an APIKey in Aura from Aura installer aurak8s