rasa-pro 3.8.16__py3-none-any.whl

rasa/nlu/featurizers/dense_featurizer/lm_featurizer.py

@@ -0,0 +1,772 @@
+from __future__ import annotations
+import numpy as np
+import logging
+
+from typing import Any, Text, List, Dict, Tuple, Type
+import tensorflow as tf
+
+from rasa.engine.graph import ExecutionContext, GraphComponent
+from rasa.engine.recipes.default_recipe import DefaultV1Recipe
+from rasa.engine.storage.resource import Resource
+from rasa.engine.storage.storage import ModelStorage
+from rasa.nlu.featurizers.dense_featurizer.dense_featurizer import DenseFeaturizer
+from rasa.nlu.tokenizers.tokenizer import Token, Tokenizer
+from rasa.shared.nlu.training_data.training_data import TrainingData
+from rasa.shared.nlu.training_data.message import Message
+from rasa.nlu.constants import (
+    DENSE_FEATURIZABLE_ATTRIBUTES,
+    SEQUENCE_FEATURES,
+    SENTENCE_FEATURES,
+    NO_LENGTH_RESTRICTION,
+    NUMBER_OF_SUB_TOKENS,
+    TOKENS_NAMES,
+)
+from rasa.shared.nlu.constants import TEXT, ACTION_TEXT
+from rasa.utils import train_utils
+from rasa.utils.tensorflow.model_data import ragged_array_to_ndarray
+
+logger = logging.getLogger(__name__)
+
+MAX_SEQUENCE_LENGTHS = {
+    "bert": 512,
+    "gpt": 512,
+    "gpt2": 512,
+    "xlnet": NO_LENGTH_RESTRICTION,
+    "distilbert": 512,
+    "roberta": 512,
+    "camembert": 512,
+}
+
+
+@DefaultV1Recipe.register(
+    DefaultV1Recipe.ComponentType.MESSAGE_FEATURIZER, is_trainable=False
+)
+class LanguageModelFeaturizer(DenseFeaturizer, GraphComponent):
+    """A featurizer that uses transformer-based language models.
+
+    This component loads a pre-trained language model
+    from the Transformers library (https://github.com/huggingface/transformers)
+    including BERT, GPT, GPT-2, xlnet, distilbert, and roberta.
+    It also tokenizes and featurizes the featurizable dense attributes of
+    each message.
+    """
+
+    @classmethod
+    def required_components(cls) -> List[Type]:
+        """Components that should be included in the pipeline before this component."""
+        return [Tokenizer]
+
+    def __init__(
+        self, config: Dict[Text, Any], execution_context: ExecutionContext
+    ) -> None:
+        """Initializes the featurizer with the model in the config."""
+        super(LanguageModelFeaturizer, self).__init__(
+            execution_context.node_name, config
+        )
+        self._load_model_metadata()
+        self._load_model_instance()
+
+    @staticmethod
+    def get_default_config() -> Dict[Text, Any]:
+        """Returns LanguageModelFeaturizer's default config."""
+        return {
+            **DenseFeaturizer.get_default_config(),
+            # name of the language model to load.
+            "model_name": "bert",
+            # Pre-Trained weights to be loaded(string)
+            "model_weights": None,
+            # an optional path to a specific directory to download
+            # and cache the pre-trained model weights.
+            "cache_dir": None,
+        }
+
+    @classmethod
+    def validate_config(cls, config: Dict[Text, Any]) -> None:
+        """Validates the configuration."""
+        pass
+
+    @classmethod
+    def create(
+        cls,
+        config: Dict[Text, Any],
+        model_storage: ModelStorage,
+        resource: Resource,
+        execution_context: ExecutionContext,
+    ) -> LanguageModelFeaturizer:
+        """Creates a LanguageModelFeaturizer.
+
+        Loads the model specified in the config.
+        """
+        return cls(config, execution_context)
+
+    @staticmethod
+    def required_packages() -> List[Text]:
+        """Returns the extra python dependencies required."""
+        return ["transformers"]
+
+    def _load_model_metadata(self) -> None:
+        """Loads the metadata for the specified model and set them as properties.
+
+        This includes the model name, model weights, cache directory and the
+        maximum sequence length the model can handle.
+        """
+        from rasa.nlu.utils.hugging_face.registry import (
+            model_class_dict,
+            model_weights_defaults,
+        )
+
+        self.model_name = self._config["model_name"]
+
+        if self.model_name not in model_class_dict:
+            raise KeyError(
+                f"'{self.model_name}' not a valid model name. Choose from "
+                f"{list(model_class_dict.keys())!s} or create"
+                f"a new class inheriting from this class to support your model."
+            )
+
+        self.model_weights = self._config["model_weights"]
+        self.cache_dir = self._config["cache_dir"]
+
+        if not self.model_weights:
+            logger.info(
+                f"Model weights not specified. Will choose default model "
+                f"weights: {model_weights_defaults[self.model_name]}"
+            )
+            self.model_weights = model_weights_defaults[self.model_name]
+
+        self.max_model_sequence_length = MAX_SEQUENCE_LENGTHS[self.model_name]
+
+    def _load_model_instance(self) -> None:
+        """Tries to load the model instance.
+
+        Model loading should be skipped in unit tests.
+        See unit tests for examples.
+        """
+        from rasa.nlu.utils.hugging_face.registry import (
+            model_class_dict,
+            model_tokenizer_dict,
+        )
+
+        logger.debug(f"Loading Tokenizer and Model for {self.model_name}")
+
+        self.tokenizer = model_tokenizer_dict[self.model_name].from_pretrained(
+            self.model_weights, cache_dir=self.cache_dir
+        )
+        self.model = model_class_dict[self.model_name].from_pretrained(
+            self.model_weights, cache_dir=self.cache_dir
+        )
+
+        # Use a universal pad token since all transformer architectures do not have a
+        # consistent token. Instead of pad_token_id we use unk_token_id because
+        # pad_token_id is not set for all architectures. We can't add a new token as
+        # well since vocabulary resizing is not yet supported for TF classes.
+        # Also, this does not hurt the model predictions since we use an attention mask
+        # while feeding input.
+        self.pad_token_id = self.tokenizer.unk_token_id
+
+    def _lm_tokenize(self, text: Text) -> Tuple[List[int], List[Text]]:
+        """Passes the text through the tokenizer of the language model.
+
+        Args:
+            text: Text to be tokenized.
+
+        Returns: List of token ids and token strings.
+        """
+        split_token_ids = self.tokenizer.encode(text, add_special_tokens=False)
+
+        split_token_strings = self.tokenizer.convert_ids_to_tokens(split_token_ids)
+
+        return split_token_ids, split_token_strings
+
+    def _add_lm_specific_special_tokens(
+        self, token_ids: List[List[int]]
+    ) -> List[List[int]]:
+        """Adds the language and model-specific tokens used during training.
+
+        Args:
+            token_ids: List of token ids for each example in the batch.
+
+        Returns: Augmented list of token ids for each example in the batch.
+        """
+        from rasa.nlu.utils.hugging_face.registry import (
+            model_special_tokens_pre_processors,
+        )
+
+        augmented_tokens = [
+            model_special_tokens_pre_processors[self.model_name](example_token_ids)
+            for example_token_ids in token_ids
+        ]
+        return augmented_tokens
+
+    def _lm_specific_token_cleanup(
+        self, split_token_ids: List[int], token_strings: List[Text]
+    ) -> Tuple[List[int], List[Text]]:
+        """Cleans up special chars added by tokenizers of language models.
+
+        Many language models add a special char in front/back of (some) words. We clean
+        up those chars as they are not
+        needed once the features are already computed.
+
+        Args:
+            split_token_ids: List of token ids received as output from the language
+            model specific tokenizer.
+            token_strings: List of token strings received as output from the language
+            model specific tokenizer.
+
+        Returns: Cleaned up token ids and token strings.
+        """
+        from rasa.nlu.utils.hugging_face.registry import model_tokens_cleaners
+
+        return model_tokens_cleaners[self.model_name](split_token_ids, token_strings)
+
+    def _post_process_sequence_embeddings(
+        self, sequence_embeddings: np.ndarray
+    ) -> Tuple[np.ndarray, np.ndarray]:
+        """Computes sentence and sequence level representations for relevant tokens.
+
+        Args:
+            sequence_embeddings: Sequence level dense features received as output from
+            language model.
+
+        Returns: Sentence and sequence level representations.
+        """
+        from rasa.nlu.utils.hugging_face.registry import (
+            model_embeddings_post_processors,
+        )
+
+        sentence_embeddings = []
+        post_processed_sequence_embeddings = []
+
+        for example_embedding in sequence_embeddings:
+            (
+                example_sentence_embedding,
+                example_post_processed_embedding,
+            ) = model_embeddings_post_processors[self.model_name](example_embedding)
+
+            sentence_embeddings.append(example_sentence_embedding)
+            post_processed_sequence_embeddings.append(example_post_processed_embedding)
+
+        return (
+            np.array(sentence_embeddings),
+            ragged_array_to_ndarray(post_processed_sequence_embeddings),
+        )
+
+    def _tokenize_example(
+        self, message: Message, attribute: Text
+    ) -> Tuple[List[Token], List[int]]:
+        """Tokenizes a single message example.
+
+        Many language models add a special char in front of (some) words and split
+        words into sub-words. To ensure the entity start and end values matches the
+        token values, use the tokens produced by the Tokenizer component. If
+        individual tokens are split up into multiple tokens, we add this information
+        to the respected token.
+
+        Args:
+            message: Single message object to be processed.
+            attribute: Property of message to be processed, one of ``TEXT`` or
+            ``RESPONSE``.
+
+        Returns: List of token strings and token ids for the corresponding
+                attribute of the message.
+        """
+        tokens_in = message.get(TOKENS_NAMES[attribute])
+        tokens_out = []
+
+        token_ids_out = []
+
+        for token in tokens_in:
+            # use lm specific tokenizer to further tokenize the text
+            split_token_ids, split_token_strings = self._lm_tokenize(token.text)
+
+            if not split_token_ids:
+                # fix the situation that `token.text` only contains whitespace or other
+                # special characters, which cause `split_token_ids` and
+                # `split_token_strings` be empty, finally cause
+                # `self._lm_specific_token_cleanup()` to raise an exception
+                continue
+
+            (split_token_ids, split_token_strings) = self._lm_specific_token_cleanup(
+                split_token_ids, split_token_strings
+            )
+
+            token_ids_out += split_token_ids
+
+            token.set(NUMBER_OF_SUB_TOKENS, len(split_token_strings))
+
+            tokens_out.append(token)
+
+        return tokens_out, token_ids_out
+
+    def _get_token_ids_for_batch(
+        self, batch_examples: List[Message], attribute: Text
+    ) -> Tuple[List[List[Token]], List[List[int]]]:
+        """Computes token ids and token strings for each example in batch.
+
+        A token id is the id of that token in the vocabulary of the language model.
+
+        Args:
+            batch_examples: Batch of message objects for which tokens need to be
+            computed.
+            attribute: Property of message to be processed, one of ``TEXT`` or
+            ``RESPONSE``.
+
+        Returns: List of token strings and token ids for each example in the batch.
+        """
+        batch_token_ids = []
+        batch_tokens = []
+        for example in batch_examples:
+
+            example_tokens, example_token_ids = self._tokenize_example(
+                example, attribute
+            )
+            batch_tokens.append(example_tokens)
+            batch_token_ids.append(example_token_ids)
+
+        return batch_tokens, batch_token_ids
+
+    @staticmethod
+    def _compute_attention_mask(
+        actual_sequence_lengths: List[int], max_input_sequence_length: int
+    ) -> np.ndarray:
+        """Computes a mask for padding tokens.
+
+        This mask will be used by the language model so that it does not attend to
+        padding tokens.
+
+        Args:
+            actual_sequence_lengths: List of length of each example without any
+            padding.
+            max_input_sequence_length: Maximum length of a sequence that will be
+            present in the input batch. This is
+            after taking into consideration the maximum input sequence the model
+            can handle. Hence it can never be
+            greater than self.max_model_sequence_length in case the model
+            applies length restriction.
+
+        Returns: Computed attention mask, 0 for padding and 1 for non-padding
+        tokens.
+        """
+        attention_mask = []
+
+        for actual_sequence_length in actual_sequence_lengths:
+            # add 1s for present tokens, fill up the remaining space up to max
+            # sequence length with 0s (non-existing tokens)
+            padded_sequence = [1] * min(
+                actual_sequence_length, max_input_sequence_length
+            ) + [0] * (
+                max_input_sequence_length
+                - min(actual_sequence_length, max_input_sequence_length)
+            )
+            attention_mask.append(padded_sequence)
+
+        return np.array(attention_mask).astype(np.float32)
+
+    def _extract_sequence_lengths(
+        self, batch_token_ids: List[List[int]]
+    ) -> Tuple[List[int], int]:
+        """Extracts the sequence length for each example and maximum sequence length.
+
+        Args:
+            batch_token_ids: List of token ids for each example in the batch.
+
+        Returns:
+            Tuple consisting of: the actual sequence lengths for each example,
+            and the maximum input sequence length (taking into account the
+            maximum sequence length that the model can handle.
+        """
+        # Compute max length across examples
+        max_input_sequence_length = 0
+        actual_sequence_lengths = []
+
+        for example_token_ids in batch_token_ids:
+            sequence_length = len(example_token_ids)
+            actual_sequence_lengths.append(sequence_length)
+            max_input_sequence_length = max(
+                max_input_sequence_length, len(example_token_ids)
+            )
+
+        # Take into account the maximum sequence length the model can handle
+        max_input_sequence_length = (
+            max_input_sequence_length
+            if self.max_model_sequence_length == NO_LENGTH_RESTRICTION
+            else min(max_input_sequence_length, self.max_model_sequence_length)
+        )
+
+        return actual_sequence_lengths, max_input_sequence_length
+
+    def _add_padding_to_batch(
+        self, batch_token_ids: List[List[int]], max_sequence_length_model: int
+    ) -> List[List[int]]:
+        """Adds padding so that all examples in the batch are of the same length.
+
+        Args:
+            batch_token_ids: Batch of examples where each example is a non-padded list
+            of token ids.
+            max_sequence_length_model: Maximum length of any input sequence in the batch
+            to be fed to the model.
+
+        Returns:
+            Padded batch with all examples of the same length.
+        """
+        padded_token_ids = []
+
+        # Add padding according to max_sequence_length
+        # Some models don't contain pad token, we use unknown token as padding token.
+        # This doesn't affect the computation since we compute an attention mask
+        # anyways.
+        for example_token_ids in batch_token_ids:
+
+            # Truncate any longer sequences so that they can be fed to the model
+            if len(example_token_ids) > max_sequence_length_model:
+                example_token_ids = example_token_ids[:max_sequence_length_model]
+
+            padded_token_ids.append(
+                example_token_ids
+                + [self.pad_token_id]
+                * (max_sequence_length_model - len(example_token_ids))
+            )
+        return padded_token_ids
+
+    @staticmethod
+    def _extract_nonpadded_embeddings(
+        embeddings: np.ndarray, actual_sequence_lengths: List[int]
+    ) -> np.ndarray:
+        """Extracts embeddings for actual tokens.
+
+        Use pre-computed non-padded lengths of each example to extract embeddings
+        for non-padding tokens.
+
+        Args:
+            embeddings: sequence level representations for each example of the batch.
+            actual_sequence_lengths: non-padded lengths of each example of the batch.
+
+        Returns:
+            Sequence level embeddings for only non-padding tokens of the batch.
+        """
+        nonpadded_sequence_embeddings = []
+        for index, embedding in enumerate(embeddings):
+            unmasked_embedding = embedding[: actual_sequence_lengths[index]]
+            nonpadded_sequence_embeddings.append(unmasked_embedding)
+
+        return ragged_array_to_ndarray(nonpadded_sequence_embeddings)
+
+    def _compute_batch_sequence_features(
+        self, batch_attention_mask: np.ndarray, padded_token_ids: List[List[int]]
+    ) -> np.ndarray:
+        """Feeds the padded batch to the language model.
+
+        Args:
+            batch_attention_mask: Mask of 0s and 1s which indicate whether the token
+            is a padding token or not.
+            padded_token_ids: Batch of token ids for each example. The batch is padded
+            and hence can be fed at once.
+
+        Returns:
+            Sequence level representations from the language model.
+        """
+        model_outputs = self.model(
+            tf.convert_to_tensor(padded_token_ids),
+            attention_mask=tf.convert_to_tensor(batch_attention_mask),
+        )
+
+        # sequence hidden states is always the first output from all models
+        sequence_hidden_states = model_outputs[0]
+
+        sequence_hidden_states = sequence_hidden_states.numpy()
+        return sequence_hidden_states
+
+    def _validate_sequence_lengths(
+        self,
+        actual_sequence_lengths: List[int],
+        batch_examples: List[Message],
+        attribute: Text,
+        inference_mode: bool = False,
+    ) -> None:
+        """Validates sequence length.
+
+        Checks if sequence lengths of inputs are less than
+        the max sequence length the model can handle.
+
+        This method should throw an error during training, and log a debug
+        message during inference if any of the input examples have a length
+        greater than maximum sequence length allowed.
+
+        Args:
+            actual_sequence_lengths: original sequence length of all inputs
+            batch_examples: all message instances in the batch
+            attribute: attribute of message object to be processed
+            inference_mode: whether this is during training or inference
+        """
+        if self.max_model_sequence_length == NO_LENGTH_RESTRICTION:
+            # There is no restriction on sequence length from the model
+            return
+
+        for sequence_length, example in zip(actual_sequence_lengths, batch_examples):
+            if sequence_length > self.max_model_sequence_length:
+                if not inference_mode:
+                    raise RuntimeError(
+                        f"The sequence length of '{example.get(attribute)[:20]}...' "
+                        f"is too long({sequence_length} tokens) for the "
+                        f"model chosen {self.model_name} which has a maximum "
+                        f"sequence length of {self.max_model_sequence_length} tokens. "
+                        f"Either shorten the message or use a model which has no "
+                        f"restriction on input sequence length like XLNet."
+                    )
+                logger.debug(
+                    f"The sequence length of '{example.get(attribute)[:20]}...' "
+                    f"is too long({sequence_length} tokens) for the "
+                    f"model chosen {self.model_name} which has a maximum "
+                    f"sequence length of {self.max_model_sequence_length} tokens. "
+                    f"Downstream model predictions may be affected because of this."
+                )
+
+    def _add_extra_padding(
+        self, sequence_embeddings: np.ndarray, actual_sequence_lengths: List[int]
+    ) -> np.ndarray:
+        """Adds extra zero padding to match the original sequence length.
+
+        This is only done if the input was truncated during the batch
+        preparation of input for the model.
+
+        Args:
+            sequence_embeddings: Embeddings returned from the model
+            actual_sequence_lengths: original sequence length of all inputs
+
+        Returns:
+            Modified sequence embeddings with padding if necessary
+        """
+        if self.max_model_sequence_length == NO_LENGTH_RESTRICTION:
+            # No extra padding needed because there wouldn't have been any
+            # truncation in the first place
+            return sequence_embeddings
+
+        reshaped_sequence_embeddings = []
+        for index, embedding in enumerate(sequence_embeddings):
+            embedding_size = embedding.shape[-1]
+            if actual_sequence_lengths[index] > self.max_model_sequence_length:
+                embedding = np.concatenate(
+                    [
+                        embedding,
+                        np.zeros(
+                            (
+                                actual_sequence_lengths[index]
+                                - self.max_model_sequence_length,
+                                embedding_size,
+                            ),
+                            dtype=np.float32,
+                        ),
+                    ]
+                )
+            reshaped_sequence_embeddings.append(embedding)
+        return ragged_array_to_ndarray(reshaped_sequence_embeddings)
+
+    def _get_model_features_for_batch(
+        self,
+        batch_token_ids: List[List[int]],
+        batch_tokens: List[List[Token]],
+        batch_examples: List[Message],
+        attribute: Text,
+        inference_mode: bool = False,
+    ) -> Tuple[np.ndarray, np.ndarray]:
+        """Computes dense features of each example in the batch.
+
+        We first add the special tokens corresponding to each language model. Next, we
+        add appropriate padding and compute a mask for that padding so that it doesn't
+        affect the feature computation. The padded batch is next fed to the language
+        model and token level embeddings are computed. Using the pre-computed mask,
+        embeddings for non-padding tokens are extracted and subsequently sentence
+        level embeddings are computed.
+
+        Args:
+            batch_token_ids: List of token ids of each example in the batch.
+            batch_tokens: List of token objects for each example in the batch.
+            batch_examples: List of examples in the batch.
+            attribute: attribute of the Message object to be processed.
+            inference_mode: Whether the call is during training or during inference.
+
+        Returns:
+            Sentence and token level dense representations.
+        """
+        # Let's first add tokenizer specific special tokens to all examples
+        batch_token_ids_augmented = self._add_lm_specific_special_tokens(
+            batch_token_ids
+        )
+
+        # Compute sequence lengths for all examples
+        (
+            actual_sequence_lengths,
+            max_input_sequence_length,
+        ) = self._extract_sequence_lengths(batch_token_ids_augmented)
+
+        # Validate that all sequences can be processed based on their sequence
+        # lengths and the maximum sequence length the model can handle
+        self._validate_sequence_lengths(
+            actual_sequence_lengths, batch_examples, attribute, inference_mode
+        )
+
+        # Add padding so that whole batch can be fed to the model
+        padded_token_ids = self._add_padding_to_batch(
+            batch_token_ids_augmented, max_input_sequence_length
+        )
+
+        # Compute attention mask based on actual_sequence_length
+        batch_attention_mask = self._compute_attention_mask(
+            actual_sequence_lengths, max_input_sequence_length
+        )
+
+        # Get token level features from the model
+        sequence_hidden_states = self._compute_batch_sequence_features(
+            batch_attention_mask, padded_token_ids
+        )
+
+        # Extract features for only non-padding tokens
+        sequence_nonpadded_embeddings = self._extract_nonpadded_embeddings(
+            sequence_hidden_states, actual_sequence_lengths
+        )
+
+        # Extract sentence level and post-processed features
+        (
+            sentence_embeddings,
+            sequence_embeddings,
+        ) = self._post_process_sequence_embeddings(sequence_nonpadded_embeddings)
+
+        # Pad zeros for examples which were truncated in inference mode.
+        # This is intentionally done after sentence embeddings have been
+        # extracted so that they are not affected
+        sequence_embeddings = self._add_extra_padding(
+            sequence_embeddings, actual_sequence_lengths
+        )
+
+        # shape of matrix for all sequence embeddings
+        batch_dim = len(sequence_embeddings)
+        seq_dim = max(e.shape[0] for e in sequence_embeddings)
+        feature_dim = sequence_embeddings[0].shape[1]
+        shape = (batch_dim, seq_dim, feature_dim)
+
+        # align features with tokens so that we have just one vector per token
+        # (don't include sub-tokens)
+        sequence_embeddings = train_utils.align_token_features(
+            batch_tokens, sequence_embeddings, shape
+        )
+
+        # sequence_embeddings is a padded numpy array
+        # remove the padding, keep just the non-zero vectors
+        sequence_final_embeddings = []
+        for embeddings, tokens in zip(sequence_embeddings, batch_tokens):
+            sequence_final_embeddings.append(embeddings[: len(tokens)])
+
+        return sentence_embeddings, ragged_array_to_ndarray(sequence_final_embeddings)
+
+    def _get_docs_for_batch(
+        self,
+        batch_examples: List[Message],
+        attribute: Text,
+        inference_mode: bool = False,
+    ) -> List[Dict[Text, Any]]:
+        """Computes language model docs for all examples in the batch.
+
+        Args:
+            batch_examples: Batch of message objects for which language model docs
+            need to be computed.
+            attribute: Property of message to be processed, one of ``TEXT`` or
+            ``RESPONSE``.
+            inference_mode: Whether the call is during inference or during training.
+
+
+        Returns:
+            List of language model docs for each message in batch.
+        """
+        batch_tokens, batch_token_ids = self._get_token_ids_for_batch(
+            batch_examples, attribute
+        )
+
+        (
+            batch_sentence_features,
+            batch_sequence_features,
+        ) = self._get_model_features_for_batch(
+            batch_token_ids, batch_tokens, batch_examples, attribute, inference_mode
+        )
+
+        # A doc consists of
+        # {'sequence_features': ..., 'sentence_features': ...}
+        batch_docs = []
+        for index in range(len(batch_examples)):
+            doc = {
+                SEQUENCE_FEATURES: batch_sequence_features[index],
+                SENTENCE_FEATURES: np.reshape(batch_sentence_features[index], (1, -1)),
+            }
+            batch_docs.append(doc)
+
+        return batch_docs
+
+    def process_training_data(self, training_data: TrainingData) -> TrainingData:
+        """Computes tokens and dense features for each message in training data.
+
+        Args:
+            training_data: NLU training data to be tokenized and featurized
+            config: NLU pipeline config consisting of all components.
+        """
+        batch_size = 64
+
+        for attribute in DENSE_FEATURIZABLE_ATTRIBUTES:
+
+            non_empty_examples = list(
+                filter(lambda x: x.get(attribute), training_data.training_examples)
+            )
+
+            batch_start_index = 0
+
+            while batch_start_index < len(non_empty_examples):
+
+                batch_end_index = min(
+                    batch_start_index + batch_size, len(non_empty_examples)
+                )
+                # Collect batch examples
+                batch_messages = non_empty_examples[batch_start_index:batch_end_index]
+
+                # Construct a doc with relevant features
+                # extracted(tokens, dense_features)
+                batch_docs = self._get_docs_for_batch(batch_messages, attribute)
+
+                for index, ex in enumerate(batch_messages):
+                    self._set_lm_features(batch_docs[index], ex, attribute)
+                batch_start_index += batch_size
+
+        return training_data
+
+    def process(self, messages: List[Message]) -> List[Message]:
+        """Processes messages by computing tokens and dense features."""
+        for message in messages:
+            self._process_message(message)
+        return messages
+
+    def _process_message(self, message: Message) -> Message:
+        """Processes a message by computing tokens and dense features."""
+        # processing featurizers operates only on TEXT and ACTION_TEXT attributes,
+        # because all other attributes are labels which are featurized during
+        # training and their features are stored by the model itself.
+        for attribute in {TEXT, ACTION_TEXT}:
+            if message.get(attribute):
+                self._set_lm_features(
+                    self._get_docs_for_batch(
+                        [message], attribute=attribute, inference_mode=True
+                    )[0],
+                    message,
+                    attribute,
+                )
+        return message
+
+    def _set_lm_features(
+        self, doc: Dict[Text, Any], message: Message, attribute: Text = TEXT
+    ) -> None:
+        """Adds the precomputed word vectors to the messages features."""
+        sequence_features = doc[SEQUENCE_FEATURES]
+        sentence_features = doc[SENTENCE_FEATURES]
+
+        self.add_features_to_message(
+            sequence=sequence_features,
+            sentence=sentence_features,
+            attribute=attribute,
+            message=message,
+        )