XLMRobertaTextClassifier 模型
XLMRobertaTextClassifier 類別
keras_hub.models.XLMRobertaTextClassifier(
backbone,
num_classes,
preprocessor=None,
activation=None,
hidden_dim=None,
dropout=0.0,
**kwargs
)
用於分類任務的端對端 XLM-RoBERTa 模型。
此模型將分類 head 連接到 keras_hub.model.XLMRobertaBackbone 實例，將 backbone 輸出映射到適用於分類任務的 logits。如需搭配預訓練權重使用此模型，請參閱 from_preset() 建構子。
此模型可以選擇性地配置 preprocessor 層，在這種情況下，它會在 fit()、predict() 和 evaluate() 期間自動將預處理應用於原始輸入。當使用 from_preset() 建立模型時，預設會執行此操作。
免責聲明：預訓練模型以「現狀」為基礎提供，不提供任何形式的保證或條件。底層模型由第三方提供，並受個別授權條款約束，詳情請見此處。
引數
- backbone：
keras_hub.models.XLMRobertaBackbone實例。 - num_classes：整數。要預測的類別數量。
- preprocessor：
keras_hub.models.XLMRobertaTextClassifierPreprocessor或None。如果為None，此模型將不會應用預處理，且輸入應在呼叫模型之前進行預處理。 - activation：選用的
str或可呼叫物件。要在模型輸出上使用的啟動函數。設定activation="softmax"以傳回輸出機率。預設為None。 - hidden_dim：整數。池化層的大小。
- dropout：浮點數。dropout 機率值，應用於池化輸出，以及在第一個密集層之後。
範例
原始字串資料。
features = ["The quick brown fox jumped.", "نسيت الواجب"]
labels = [0, 3]
# Pretrained classifier.
classifier = keras_hub.models.XLMRobertaTextClassifier.from_preset(
"xlm_roberta_base_multi",
num_classes=4,
)
classifier.fit(x=features, y=labels, batch_size=2)
classifier.predict(x=features, batch_size=2)
# Re-compile (e.g., with a new learning rate).
classifier.compile(
loss=keras.losses.SparseCategoricalCrossentropy(from_logits=True),
optimizer=keras.optimizers.Adam(5e-5),
jit_compile=True,
)
# Access backbone programmatically (e.g., to change `trainable`).
classifier.backbone.trainable = False
# Fit again.
classifier.fit(x=features, y=labels, batch_size=2)
預處理後的整數資料。
features = {
"token_ids": np.ones(shape=(2, 12), dtype="int32"),
"padding_mask": np.array([[1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0]] * 2),
}
labels = [0, 3]
# Pretrained classifier without preprocessing.
classifier = keras_hub.models.XLMRobertaTextClassifier.from_preset(
"xlm_roberta_base_multi",
num_classes=4,
preprocessor=None,
)
classifier.fit(x=features, y=labels, batch_size=2)
自訂 backbone 和詞彙表。
features = ["The quick brown fox jumped.", "نسيت الواجب"]
labels = [0, 3]
def train_sentencepiece(ds, vocab_size):
bytes_io = io.BytesIO()
sentencepiece.SentencePieceTrainer.train(
sentence_iterator=ds.as_numpy_iterator(),
model_writer=bytes_io,
vocab_size=vocab_size,
model_type="WORD",
unk_id=0,
bos_id=1,
eos_id=2,
)
return bytes_io.getvalue()
ds = tf.data.Dataset.from_tensor_slices(
["the quick brown fox", "the earth is round"]
)
proto = train_sentencepiece(ds, vocab_size=10)
tokenizer = keras_hub.models.XLMRobertaTokenizer(
proto=proto
)
preprocessor = keras_hub.models.XLMRobertaTextClassifierPreprocessor(
tokenizer,
sequence_length=128,
)
backbone = keras_hub.models.XLMRobertaBackbone(
vocabulary_size=250002,
num_layers=4,
num_heads=4,
hidden_dim=256,
intermediate_dim=512,
max_sequence_length=128,
)
classifier = keras_hub.models.XLMRobertaTextClassifier(
backbone=backbone,
preprocessor=preprocessor,
num_classes=4,
)
classifier.fit(x=features, y=labels, batch_size=2)
from_preset 方法
XLMRobertaTextClassifier.from_preset(preset, load_weights=True, **kwargs)
從模型預設實例化 keras_hub.models.Task。
預設是配置、權重和其他檔案資產的目錄，用於儲存和載入預訓練模型。preset 可以作為以下其中一項傳遞
- 內建預設識別符，例如
'bert_base_en' - Kaggle Models 句柄，例如
'kaggle://user/bert/keras/bert_base_en' - Hugging Face 句柄，例如
'hf://user/bert_base_en' - 本機預設目錄的路徑，例如
'./bert_base_en'
對於任何 Task 子類別，您可以執行 cls.presets.keys() 以列出該類別上所有可用的內建預設。
此建構子可以透過兩種方式之一呼叫。可以從任務特定的基底類別（例如 keras_hub.models.CausalLM.from_preset()）呼叫，也可以從模型類別（例如 keras_hub.models.BertTextClassifier.from_preset()）呼叫。如果從基底類別呼叫，則傳回物件的子類別將從預設目錄中的配置推斷而來。
引數
- preset：字串。內建預設識別符、Kaggle Models 句柄、Hugging Face 句柄或本機目錄的路徑。
- load_weights：布林值。如果為
True，儲存的權重將載入到模型架構中。如果為False，所有權重將隨機初始化。
範例
# Load a Gemma generative task.
causal_lm = keras_hub.models.CausalLM.from_preset(
"gemma_2b_en",
)
# Load a Bert classification task.
model = keras_hub.models.TextClassifier.from_preset(
"bert_base_en",
num_classes=2,
)
| 預設 | 參數 | 描述 |
|---|---|---|
| xlm_roberta_base_multi | 277.45M | 12 層 XLM-RoBERTa 模型，其中保留大小寫。在 100 種語言的 CommonCrawl 上訓練。 |
| xlm_roberta_large_multi | 558.84M | 24 層 XLM-RoBERTa 模型，其中保留大小寫。在 100 種語言的 CommonCrawl 上訓練。 |
backbone 屬性
keras_hub.models.XLMRobertaTextClassifier.backbone
具有核心架構的 keras_hub.models.Backbone 模型。
preprocessor 屬性
keras_hub.models.XLMRobertaTextClassifier.preprocessor
用於預處理輸入的 keras_hub.models.Preprocessor 層。