Keras 3 API 文件 / KerasNLP / 預先訓練的模型 / Roberta / RobertaBackbone 模型

RobertaBackbone 模型

[來源]

RobertaBackbone 類別

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

一個 RoBERTa 編碼器網路。

此網路實作了"RoBERTa: A Robustly Optimized BERT Pretraining Approach"中所述的雙向基於 Transformer 的編碼器。它包含嵌入查詢和 Transformer 層,但不包含預先訓練期間使用的遮罩語言模型頭。

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

免責聲明:預先訓練的模型是「按原樣」提供的,不提供任何形式的明示或暗示擔保。基礎模型由第三方提供,並受獨立授權協議的約束,此處提供。

參數

  • vocabulary_size:整數。標記詞彙的大小。
  • num_layers:整數。Transformer 層的數量。
  • num_heads:整數。每個 Transformer 的注意力頭的數量。隱藏大小必須可以被注意力頭的數量整除。
  • hidden_dim:整數。Transformer 編碼層的大小。
  • intermediate_dim:整數。每個 Transformer 的兩層前饋網路中第一個 Dense 層的輸出維度。
  • dropout:浮點數。Transformer 編碼器的丟棄機率。
  • max_sequence_length:整數。此編碼器可以使用的最大序列長度。輸入的序列長度必須小於預設值 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], shape=(1, 12)),
}

# Pretrained RoBERTa encoder
model = keras_nlp.models.RobertaBackbone.from_preset("roberta_base_en")
model(input_data)

# Randomly initialized RoBERTa model with custom config
model = keras_nlp.models.RobertaBackbone(
    vocabulary_size=50265,
    num_layers=4,
    num_heads=4,
    hidden_dim=256,
    intermediate_dim=512,
    max_sequence_length=128,
)
model(input_data)

[來源]

from_preset 方法

RobertaBackbone.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,
)
預設集名稱 參數 描述
roberta_base_en 124.05M 12 層 RoBERTa 模型,保留大小寫。在英文維基百科、BooksCorpus、CommonCraw 和 OpenWebText 上訓練。
roberta_large_en 354.31M 24 層 RoBERTa 模型,保留大小寫。在英文維基百科、BooksCorpus、CommonCraw 和 OpenWebText 上訓練。

token_embedding 屬性

keras_nlp.models.RobertaBackbone.token_embedding

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

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