Keras 3 API 文件 / KerasNLP / 預訓練模型 / XLMRoberta / XLMRobertaBackbone 模型

XLMRobertaBackbone 模型

[來源]

XLMRobertaBackbone 類別

keras_nlp.models.XLMRobertaBackbone(
    vocabulary_size,
    num_layers,
    num_heads,
    hidden_dim,
    intermediate_dim,
    dropout=0.1,
    max_sequence_length=512,
    dtype=None,
    **kwargs
)

一個 XLM-RoBERTa 編碼器網路。

此類別實作了一個雙向基於 Transformer 的編碼器,如 「大規模無監督跨語言表示學習」 中所述。它包含嵌入查找和 Transformer 層,但不包含預訓練期間使用的遮罩語言建模頭。

預設建構函數提供了一個完全可自訂的、隨機初始化的 RoBERTa 編碼器,具有任意數量的層、頭和嵌入維度。若要載入預設架構和權重,請使用 from_preset() 建構函數。

免責聲明:預訓練模型按「現狀」提供,不提供任何形式的保證或條件。基礎模型由第三方提供,並受獨立許可證約束,請參閱此處

參數

  • vocabulary_size:int。標記詞彙表的大小。
  • num_layers:int。Transformer 層的數量。
  • num_heads:int。每個 Transformer 的注意力頭數量。隱藏大小必須可以被注意力頭數量整除。
  • hidden_dim:int。Transformer 編碼層的大小。
  • intermediate_dim:int。每個 Transformer 的兩層前饋網路中第一個 Dense 層的輸出維度。
  • dropout:float。Transformer 編碼器的 Dropout 機率。
  • max_sequence_length:int。此編碼器可以使用的最大序列長度。輸入的序列長度必須小於 max_sequence_length 預設值。這決定了位置嵌入的可變形狀。
  • dtype:字串或 keras.mixed_precision.DTypePolicy。用於模型計算和權重的 dtype。請注意,某些計算(例如 softmax 和層歸一化)將始終以 float32 精度完成,而與 dtype 無關。

範例

input_data = {
    "token_ids": np.ones(shape=(1, 12), dtype="int32"),
    "padding_mask": np.array([[1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0]]),
}

# Pretrained XLM-R encoder.
model = keras_nlp.models.XLMRobertaBackbone.from_preset(
    "xlm_roberta_base_multi",
)
model(input_data)

# Randomly initialized XLM-R model with custom config.
model = keras_nlp.models.XLMRobertaBackbone(
    vocabulary_size=250002,
    num_layers=4,
    num_heads=4,
    hidden_dim=256,
    intermediate_dim=512,
    max_sequence_length=128
)
model(input_data)

[來源]

from_preset 方法

XLMRobertaBackbone.from_preset(preset, load_weights=True, **kwargs)

從模型預設集實例化 keras_nlp.models.Backbone

預設集是一個包含配置、權重和其他檔案資產的目錄,用於儲存和載入預先訓練的模型。preset 可以作為以下其中一種傳遞

  1. 內建的預設集識別碼,例如 'bert_base_en'
  2. Kaggle 模型控點,例如 'kaggle://user/bert/keras/bert_base_en'
  3. Hugging Face 控點,例如 'hf://user/bert_base_en'
  4. 本機預設集目錄的路徑,例如 './bert_base_en'

此建構函式可以透過兩種方式之一呼叫。可以從基底類別呼叫,例如 keras_nlp.models.Backbone.from_preset(),也可以從模型類別呼叫,例如 keras_nlp.models.GemmaBackbone.from_preset()。如果從基底類別呼叫,則傳回物件的子類別將從預設集目錄中的配置推斷。

對於任何 Backbone 子類別,您可以執行 cls.presets.keys() 來列出類別上可用的所有內建預設集。

參數

  • preset:字串。內建的預設集識別碼、Kaggle 模型控點、Hugging Face 控點或本機目錄的路徑。
  • load_weights:布林值。如果為 True,則權重將載入到模型架構中。如果為 False,則權重將被隨機初始化。

範例

# Load a Gemma backbone with pre-trained weights.
model = keras_nlp.models.Backbone.from_preset(
    "gemma_2b_en",
)

# Load a Bert backbone with a pre-trained config and random weights.
model = keras_nlp.models.Backbone.from_preset(
    "bert_base_en",
    load_weights=False,
)
預設集名稱 參數 描述
xlm_roberta_base_multi 277.45M 12 層 XLM-RoBERTa 模型,保留大小寫。在 CommonCrawl 上以 100 種語言進行訓練。
xlm_roberta_large_multi 558.84M 24 層 XLM-RoBERTa 模型,保留大小寫。在 CommonCrawl 上以 100 種語言進行訓練。

token_embedding 屬性

keras_nlp.models.XLMRobertaBackbone.token_embedding

用於嵌入詞彙 ID 的 keras.layers.Embedding 實例。

此層將整數詞彙 ID 嵌入到模型的隱藏維度。