Transformers 文档

Zamba

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

该模型于 2024 年 5 月 26 日发布在 HF papers 上,并于 2024 年 10 月 4 日贡献至 Hugging Face Transformers。

FlashAttention SDPA

Zamba

Zamba (博客文章) 是一款由 Zyphra 训练的大型语言模型 (LLM),采用 Apache 2.0 许可证发布。请参阅 Zyphra Hugging Face 仓库以获取模型权重。

该模型由 pglo 贡献。

模型详情

Zamba-7B-v1 是状态空间模型(具体为 Mamba)与 Transformer 的混合体,通过下一词预测进行训练。Zamba 在每 6 个 Mamba 区块后使用一个共享的 Transformer 层。它使用 Mistral v0.1 分词器。我们在小规模实验中进行了多次消融研究,最终确定了该架构。Zamba-7B-v1 在 1T tokens 的文本和代码数据上进行了预训练。

快速入门

先决条件

Zamba 要求您使用 transformers 4.46.0 或更高版本。

pip install transformers>=4.45.0

为了运行优化的 Mamba 实现,您首先需要安装 mamba-ssmcausal-conv1d

pip install mamba-ssm causal-conv1d>=1.2.0

您还需要在 CUDA 设备上运行模型。

您可以在不使用优化后的 Mamba 内核的情况下运行模型,但这被推荐,因为这会导致延迟显著增加。若要这样做,您需要在加载模型时指定 use_mamba_kernels=False

推理


from transformers import AutoModelForCausalLM, AutoTokenizer


tokenizer = AutoTokenizer.from_pretrained("Zyphra/Zamba-7B-v1")
model = AutoModelForCausalLM.from_pretrained("Zyphra/Zamba-7B-v1", device_map="auto")

input_text = "A funny prompt would be "
input_ids = tokenizer(input_text, return_tensors="pt").to(model.device)

outputs = model.generate(**input_ids, max_new_tokens=100)
print(tokenizer.decode(outputs[0]))

模型卡

模型卡可以在以下位置找到

问题

如遇到模型输出问题或需要社区讨论,请使用 Hugging Face 社区 论坛

许可证

模型权重以 Apache 2.0 许可证开源。

ZambaConfig

class transformers.ZambaConfig

< >

( transformers_version: str | None = None architectures: list[str] | None = None output_hidden_states: bool | None = False return_dict: bool | None = True dtype: typing.Union[str, ForwardRef('torch.dtype'), NoneType] = None chunk_size_feed_forward: int = 0 is_encoder_decoder: bool = False id2label: dict[int, str] | dict[str, str] | None = None label2id: dict[str, int] | dict[str, str] | None = None problem_type: typing.Optional[typing.Literal['regression', 'single_label_classification', 'multi_label_classification']] = None vocab_size: int = 32000 tie_word_embeddings: bool = True hidden_size: int = 3712 attention_hidden_size: int | None = None intermediate_size: int = 14848 num_hidden_layers: int = 76 num_attention_heads: int = 16 attention_head_dim: int | None = None num_key_value_heads: int = 16 n_mamba_heads: int = 2 hidden_act: str = 'gelu' hidden_mamba_act: str = 'silu' initializer_range: float = 0.02 rms_norm_eps: float = 1e-05 use_cache: bool = True num_logits_to_keep: int = 1 pad_token_id: int | None = 0 bos_token_id: int | None = 1 eos_token_id: int | list[int] | None = 2 max_position_embeddings: int = 4096 attention_dropout: float | int = 0.0 attn_layer_period: int = 6 attn_layer_offset: int = 4 use_mamba_kernels: bool = True mamba_d_state: int = 16 mamba_d_conv: int = 4 mamba_expand: int = 2 mamba_dt_rank: str | int = 'auto' time_step_min: float = 0.001 time_step_max: float = 0.1 time_step_floor: float = 0.0001 mamba_conv_bias: bool = True mamba_proj_bias: bool = False )

参数

  • vocab_size (int, 可选, 默认为 32000) — 模型的词汇表大小。定义了 input_ids 可以表示的不同 token 的数量。
  • tie_word_embeddings (bool, 可选, 默认为 True) — 是否根据模型的 tied_weights_keys 映射来绑定权重嵌入。
  • hidden_size (int, 可选, 默认为 3712) — 隐藏表示的维度。
  • attention_hidden_size (int, 可选) — 注意力层输入隐藏表示的维度。
  • intermediate_size (int, 可选, 默认为 14848) — MLP 表示的维度。
  • num_hidden_layers (int, 可选, 默认为 76) — Transformer 解码器中的隐藏层数量。
  • num_attention_heads (int, 可选, 默认为 16) — Transformer 解码器中每个注意力层的注意力头数量。
  • attention_head_dim (int, 可选) — Transformer 解码器中注意力头的维度。
  • num_key_value_heads (int, 可选, 默认为 16) — 这是用于实现分组查询注意力 (Grouped Query Attention) 的 key_value 头数量。如果 num_key_value_heads=num_attention_heads,模型将使用多头注意力 (MHA);如果 num_key_value_heads=1,模型将使用多查询注意力 (MQA);否则使用 GQA。在将多头检查点转换为 GQA 检查点时,每个组的键和值头应通过对该组内的所有原始头进行平均池化来构建。更多详情,请查看 这篇论文。如果不指定,默认值为 num_attention_heads
  • n_mamba_heads (int, 可选, 默认为 2) — 每个 Mamba 层的 Mamba 头数量。
  • hidden_act (str, 可选, 默认为 gelu) — 解码器中的非线性激活函数(函数或字符串)。例如 "gelu""relu""silu" 等。
  • hidden_mamba_act (strfunction, 可选, 默认为 "silu") — Mamba 层中的非线性激活函数(函数或字符串)。
  • initializer_range (float, 可选, 默认为 0.02) — 用于初始化所有权重矩阵的截断正态初始化器 (truncated_normal_initializer) 的标准差。
  • rms_norm_eps (float, 可选, 默认为 1e-05) — RMS 归一化层使用的 epsilon 值。
  • use_cache (bool, 可选, 默认为 True) — 模型是否应该返回最后的键/值注意力(并非所有模型都使用)。仅在 config.is_decoder=True 或模型为仅解码器的生成模型时相关。
  • num_logits_to_keep (intNone可选,默认为 1) — 生成过程中要计算的 prompt logit 数量。如果设为 None,则会计算所有 logit。如果设为整数值,则仅计算最后 num_logits_to_keep 个 logit。默认值为 1,因为生成时仅需要最后一个 prompt token 的 logit。对于长序列,计算整个序列的 logit 可能会占用大量内存,因此将 num_logits_to_keep=1 可以显著减少内存占用。
  • pad_token_id (int可选,默认为 0) — 词表中用于填充(padding)的 token ID。
  • bos_token_id (int可选,默认为 1) — 词表中用于流开始(beginning-of-stream)的 token ID。
  • eos_token_id (Union[int, list[int]]可选,默认为 2) — 词表中用于流结束(end-of-stream)的 token ID。
  • max_position_embeddings (int可选,默认为 4096) — 该模型可能使用的最大序列长度。
  • attention_dropout (Union[float, int]可选,默认为 0.0) — 注意力概率的 dropout 比率。
  • attn_layer_period (int可选,默认为 6) — 每隔这么多层,我们将使用一个共享的注意力层。
  • attn_layer_offset (int可选,默认为 4) — 共享注意力层的偏移量。
  • use_mamba_kernels (bool可选,默认为 True) — 指示是否使用快速 Mamba 内核的标志。仅在安装了 mamba-ssmcausal-conv1d,且 Mamba 模块在 CUDA 设备上运行时才可用。如果设为 True 但内核不可用,将引发 ValueError。
  • mamba_d_state (int可选,默认为 16) — Mamba 层中 SSM 状态(潜在状态维度)的大小。
  • mamba_d_conv (int可选,默认为 4) — Mamba 卷积内核的大小。
  • mamba_expand (int可选,默认为 2) — 用于确定 Mamba 中间层大小的扩展因子(相对于 hidden_size)。
  • mamba_dt_rank (Union[int,str]可选,默认为 "auto") — Mamba 离散化投影矩阵的秩。"auto" 意味着它将默认为 math.ceil(self.hidden_size / 16)
  • time_step_min (float可选,默认为 0.001) — 用于限制 dt_proj.bias 的最小 time_step
  • time_step_max (float可选,默认为 0.1) — 用于限制 dt_proj.bias 的最大 time_step
  • time_step_floor (float可选,默认为 0.0001) — 经过 softplus 激活后,离散时间步长 delta 允许的最小值。
  • mamba_conv_bias (bool可选,默认为 True) — 指示是否在 Mamba 混合块的卷积层中使用偏置(bias)的标志。
  • mamba_proj_bias (bool可选,默认为 False) — 指示是否在 Mamba 混合块的输入和输出投影([“in_proj”, “out_proj”])中使用偏置的标志。

这是用于存储 ZambaModel 配置的配置类。它根据指定的参数实例化一个 Zamba 模型,从而定义模型架构。使用默认值实例化配置将产生与 Zyphra/Zamba-7B-v1 类似的配置。

配置对象继承自 PreTrainedConfig,可用于控制模型输出。阅读 PreTrainedConfig 的文档以获取更多信息。

ZambaModel

class transformers.ZambaModel

< >

( config: ZambaConfig )

参数

  • config (ZambaConfig) — 包含模型所有参数的模型配置类。使用配置文件初始化不会加载与模型相关的权重,仅加载配置。查看 from_pretrained() 方法以加载模型权重。

原始的 Zamba 模型,输出未经处理的隐藏状态,顶部没有任何特定的头(head)。

该模型继承自 PreTrainedModel。请查看超类文档以了解该库为所有模型实现的通用方法(例如下载或保存、调整输入嵌入大小、剪枝头部等)。

此模型也是一个 PyTorch torch.nn.Module 子类。像普通的 PyTorch Module 一样使用它,并参考 PyTorch 文档了解一般用法和行为的所有相关信息。

forward

< >

( input_ids: torch.LongTensor | None = None attention_mask: torch.Tensor | None = None position_ids: torch.LongTensor | None = None past_key_values: transformers.cache_utils.Cache | None = None inputs_embeds: torch.FloatTensor | None = None use_cache: bool | None = None **kwargs: typing_extensions.Unpack[transformers.utils.generic.TransformersKwargs] ) BaseModelOutputWithPasttuple(torch.FloatTensor)

参数

  • input_ids (形状为 (batch_size, sequence_length)torch.LongTensor可选) — 词表中输入序列 token 的索引。默认情况下,填充(padding)将被忽略。

    索引可以使用 AutoTokenizer 获取。有关详细信息,请参阅 PreTrainedTokenizer.encode()PreTrainedTokenizer.call()

    什么是输入 ID?

  • attention_mask (形状为 (batch_size, sequence_length)torch.Tensor可选) — 用于避免对填充 token 索引执行注意力操作的掩码。掩码值选自 [0, 1]

    • 1 表示未屏蔽的 token,
    • 0 表示已屏蔽的 token。

    什么是注意力掩码?

  • position_ids (形状为 (batch_size, sequence_length)torch.LongTensor可选) — 每个输入序列 token 在位置嵌入中的位置索引。选择范围在 [0, config.n_positions - 1]

    什么是位置 ID?

  • past_key_values (~cache_utils.Cache可选) — 预计算的隐藏状态(自注意力块和交叉注意力块中的键和值),可用于加速顺序解码。这通常由模型在解码的前一阶段返回,当 use_cache=Trueconfig.use_cache=True 时使用。

    仅允许使用 Cache 实例作为输入,请参阅我们的 kv 缓存指南。如果未传递 past_key_values,则默认初始化 DynamicCache

    模型将输出与输入时相同的缓存格式。

    如果使用了 past_key_values,用户仅需输入未处理的 input_ids(即那些没有将其过去键值状态提供给此模型的 token),其形状为 (batch_size, unprocessed_length),而不是形状为 (batch_size, sequence_length) 的所有 input_ids

  • inputs_embeds (形状为 (batch_size, sequence_length, hidden_size)torch.FloatTensor可选) — 或者,您可以选择直接传递嵌入表示,而不是传递 input_ids。如果您想比模型内部的嵌入查找矩阵更精细地控制如何将 input_ids 索引转换为相关向量,这非常有用。
  • use_cache (bool可选) — 如果设置为 True,则返回 past_key_values 键值状态,并可用于加速解码(参见 past_key_values)。

返回

BaseModelOutputWithPasttuple(torch.FloatTensor)

一个 BaseModelOutputWithPast 或一个 torch.FloatTensor 元组(如果传递了 return_dict=Falseconfig.return_dict=False 时),根据配置(ZambaConfig)和输入包含各种元素。

ZambaModel 的前向传播方法,覆盖了 __call__ 特殊方法。

虽然 forward pass 的实现需要在此函数中定义,但你应该在之后调用 Module 实例而不是这个,因为前者负责运行预处理和后处理步骤,而后者会静默地忽略它们。

  • last_hidden_state (torch.FloatTensor, 形状为 (batch_size, sequence_length, hidden_size)) — 模型最后一层输出的隐藏状态序列。

    如果使用了 past_key_values,则只输出形状为 (batch_size, 1, hidden_size) 的序列的最后一个隐藏状态。

  • past_key_values (Cache,*可选*,当传入 use_cache=Trueconfig.use_cache=True 时返回) — 这是一个 Cache 实例。欲了解更多细节,请参阅我们的 KV 缓存指南

    Contains pre-computed hidden-states (key and values in the self-attention blocks and optionally if config.is_encoder_decoder=True in the cross-attention blocks) that can be used (see past_key_values input) to speed up sequential decoding.

  • hidden_states (tuple(torch.FloatTensor), optional, 当传递 output_hidden_states=True 或当 config.output_hidden_states=True 时返回) — torch.FloatTensor 的元组(一个用于嵌入层的输出,如果模型有嵌入层;+一个用于每个层的输出),形状为 (batch_size, sequence_length, hidden_size)

    模型在每个层输出的隐藏状态以及可选的初始嵌入输出。

  • attentions (tuple(torch.FloatTensor), optional, 当传递 output_attentions=True 或当 config.output_attentions=True 时返回) — torch.FloatTensor 的元组(每个层一个),形状为 (batch_size, num_heads, sequence_length, sequence_length)

    注意力 softmax 后的注意力权重,用于计算自注意力头中的加权平均值。

ZambaForCausalLM

class transformers.ZambaForCausalLM

< >

( config: ZambaConfig )

forward

< >

( input_ids: torch.LongTensor | None = None attention_mask: torch.Tensor | None = None position_ids: torch.LongTensor | None = None past_key_values: transformers.cache_utils.Cache | None = None inputs_embeds: torch.FloatTensor | None = None labels: torch.LongTensor | None = None use_cache: bool | None = None logits_to_keep: int | torch.Tensor = 0 **kwargs: typing_extensions.Unpack[transformers.utils.generic.TransformersKwargs] ) CausalLMOutputWithPast or tuple(torch.FloatTensor)

参数

  • input_ids (torch.LongTensor,形状为 (batch_size, sequence_length)可选) — 输入序列标记在词汇表中的索引。默认情况下将忽略填充(padding)。

    可以使用 AutoTokenizer 获取索引。有关详细信息,请参阅 PreTrainedTokenizer.encode()PreTrainedTokenizer.call()

    什么是输入 ID?

  • attention_mask (torch.Tensor,形状为 (batch_size, sequence_length)可选) — 用于避免对填充标记索引执行注意力机制的掩码。掩码值选自 [0, 1]

    • 1 表示未被屏蔽的标记,
    • 0 表示被屏蔽的标记。

    什么是注意力掩码?

  • position_ids (torch.LongTensor,形状为 (batch_size, sequence_length)可选) — 每个输入序列标记在位置嵌入中的位置索引。选自范围 [0, config.n_positions - 1]

    什么是位置 ID?

  • past_key_values (~cache_utils.Cache可选) — 预计算的隐藏状态(自注意力块和交叉注意力块中的键和值),可用于加速顺序解码。这通常包括当 use_cache=Trueconfig.use_cache=True 时,模型在解码的前一阶段返回的 past_key_values

    仅允许输入 Cache 实例,请参阅我们的 kv 缓存指南。如果不传递 past_key_values,将默认初始化 DynamicCache

    模型将输出与输入时相同的缓存格式。

    如果使用了 past_key_values,用户只需输入形状为 (batch_size, unprocessed_length) 的未处理 input_ids(即那些尚未将其过去键值状态提供给该模型的输入),而不是所有形状为 (batch_size, sequence_length)input_ids

  • inputs_embeds (torch.FloatTensor,形状为 (batch_size, sequence_length, hidden_size)可选) — (可选)您可以选择直接传递嵌入表示,而不是传递 input_ids。如果您希望比模型内部的嵌入查找矩阵更精细地控制如何将 input_ids 索引转换为相关向量,这将非常有用。
  • labels (torch.LongTensor,形状为 (batch_size, sequence_length)可选) — 用于计算掩码语言建模损失的标签。索引应在 [0, ..., config.vocab_size] 范围内或为 -100(请参阅 input_ids 文档字符串)。索引设置为 -100 的标记将被忽略(屏蔽),损失仅针对标签在 [0, ..., config.vocab_size] 范围内的标记进行计算。
  • use_cache (bool可选) — 如果设置为 True,则返回 past_key_values 键值状态,并可用于加速解码(请参阅 past_key_values)。
  • logits_to_keep (Union[int, torch.Tensor]可选,默认为 0) — 如果是 int,则计算最后 logits_to_keep 个标记的 Logits。如果为 0,则计算所有 input_ids 的 Logits(特殊情况)。生成仅需要最后一个标记的 Logits,仅为该标记计算它们可以节省内存,这对于长序列或大词汇量的情况尤为显著。如果是一个 torch.Tensor,它必须是与序列长度维度中要保留的索引对应的一维张量。这在使用打包张量格式(批处理和序列长度的单维度)时非常有用。

返回

CausalLMOutputWithPast or tuple(torch.FloatTensor)

CausalLMOutputWithPast 或一个 torch.FloatTensor 元组(如果传递了 return_dict=False 或当 config.return_dict=False 时),根据配置(ZambaConfig)和输入包含不同的元素。

ZambaForCausalLM 的 forward 方法重写了 __call__ 特殊方法。

虽然 forward pass 的实现需要在此函数中定义,但你应该在之后调用 Module 实例而不是这个,因为前者负责运行预处理和后处理步骤,而后者会静默地忽略它们。

  • loss (torch.FloatTensor 形状为 (1,)可选,当提供 labels 时返回) — 语言建模损失(用于下一个 token 预测)。

  • logits (形状为 (batch_size, sequence_length, config.vocab_size)torch.FloatTensor) — 语言建模头部的预测分数(SoftMax 之前的每个词汇标记的分数)。

  • past_key_values (Cache,*可选*,当传入 use_cache=Trueconfig.use_cache=True 时返回) — 这是一个 Cache 实例。欲了解更多细节,请参阅我们的 KV 缓存指南

    包含预计算的隐藏状态(自注意力块中的键和值),可用于(参见 past_key_values 输入)加速顺序解码。

  • hidden_states (tuple(torch.FloatTensor), optional, 当传递 output_hidden_states=True 或当 config.output_hidden_states=True 时返回) — torch.FloatTensor 的元组(一个用于嵌入层的输出,如果模型有嵌入层;+一个用于每个层的输出),形状为 (batch_size, sequence_length, hidden_size)

    模型在每个层输出的隐藏状态以及可选的初始嵌入输出。

  • attentions (tuple(torch.FloatTensor), optional, 当传递 output_attentions=True 或当 config.output_attentions=True 时返回) — torch.FloatTensor 的元组(每个层一个),形状为 (batch_size, num_heads, sequence_length, sequence_length)

    注意力 softmax 后的注意力权重,用于计算自注意力头中的加权平均值。

示例

>>> from transformers import AutoTokenizer, ZambaForCausalLM

>>> model = ZambaForCausalLM.from_pretrained("Zyphra/Zamba-7B-v1")
>>> tokenizer = AutoTokenizer.from_pretrained("Zyphra/Zamba-7B-v1")

>>> prompt = "Hey, are you conscious? Can you talk to me?"
>>> inputs = tokenizer(prompt, return_tensors="pt")

>>> # Generate
>>> generate_ids = model.generate(inputs.input_ids, max_length=30)
>>> tokenizer.batch_decode(generate_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False)[0]
"Hey, are you conscious? Can you talk to me?\nI'm not conscious, but I can talk to you."

ZambaForSequenceClassification

class transformers.ZambaForSequenceClassification

< >

( config model_args: ~utils.generic.ModelArgs | None = None adapter_args: ~utils.generic.AdapterArgs | None = None lora_args: ~utils.generic.LoRAArgs | None = None tokenizer_args: ~utils.generic.TokenizerArgs | None = None dataset_args: ~utils.generic.DatasetArgs | None = None data_args: ~utils.generic.DataArgs | None = None training_args: ~utils.generic.TrainingArgs | None = None generation_args: ~utils.generic.GenerationArgs | None = None vision_tower_args: ~utils.generic.VisionTowerArgs | None = None qlora_args: ~utils.generic.QLoRAArgs | None = None vision_tower_template_args: ~utils.generic.VisionTowerTemplateArgs | None = None video_tower_args: ~utils.generic.VideoTowerArgs | None = None vision_config: ~utils.generic.VisionConfig | None = None video_config: ~utils.generic.VideoConfig | None = None load_dataset: bool | None = None load_data_collator: bool | None = None load_processor: bool | None = None load_lora_adapter: bool | None = None load_adapter: bool | None = None load_qlora_adapter: bool | None = None **kwargs: typing_extensions.Unpack[transformers.modeling_utils.PreTrainedModelKwargs] )

参数

带有序列分类头(线性层)的 Zamba 模型。

ZambaForSequenceClassification 与其他因果模型(如 GPT-2)一样,使用最后一个标记进行分类。

由于它在最后一个 token 上进行分类,因此需要知道最后一个 token 的位置。如果在配置中定义了 pad_token_id,它会找到批次中每行中最后一个非填充 token。如果没有定义 pad_token_id,它会简单地取批次中每行的最后一个值。由于在传入 inputs_embeds 而非 input_ids 时无法猜测填充 token,因此它会执行相同的操作(取批次中每行的最后一个值)。

该模型继承自 PreTrainedModel。请查看超类文档以了解该库为所有模型实现的通用方法(例如下载或保存、调整输入嵌入大小、剪枝头部等)。

此模型也是一个 PyTorch torch.nn.Module 子类。像普通的 PyTorch Module 一样使用它,并参考 PyTorch 文档了解一般用法和行为的所有相关信息。

forward

< >

( input_ids: torch.LongTensor | None = None attention_mask: torch.Tensor | None = None position_ids: torch.LongTensor | None = None past_key_values: transformers.cache_utils.Cache | None = None inputs_embeds: torch.FloatTensor | None = None labels: torch.LongTensor | None = None use_cache: bool | None = None **kwargs: typing_extensions.Unpack[transformers.utils.generic.TransformersKwargs] ) SequenceClassifierOutputWithPast or tuple(torch.FloatTensor)

参数

  • input_ids (torch.LongTensor,形状为 (batch_size, sequence_length)可选) — 输入序列标记在词汇表中的索引。默认情况下将忽略填充(padding)。

    可以使用 AutoTokenizer 获取索引。有关详细信息,请参阅 PreTrainedTokenizer.encode()PreTrainedTokenizer.call()

    什么是输入 ID?

  • attention_mask (torch.Tensor,形状为 (batch_size, sequence_length)可选) — 用于避免对填充标记索引执行注意力机制的掩码。掩码值选自 [0, 1]

    • 1 表示未被屏蔽的标记,
    • 0 表示被屏蔽的标记。

    什么是注意力掩码?

  • position_ids (torch.LongTensor,形状为 (batch_size, sequence_length)可选) — 每个输入序列标记在位置嵌入中的位置索引。选自范围 [0, config.n_positions - 1]

    什么是位置 ID?

  • past_key_values (~cache_utils.Cache可选) — 预计算的隐藏状态(自注意力块和交叉注意力块中的键和值),可用于加速顺序解码。这通常包括当 use_cache=Trueconfig.use_cache=True 时,模型在解码的前一阶段返回的 past_key_values

    仅允许输入 Cache 实例,请参阅我们的 kv 缓存指南。如果不传递 past_key_values,将默认初始化 DynamicCache

    模型将输出与输入时相同的缓存格式。

    如果使用了 past_key_values,用户只需输入形状为 (batch_size, unprocessed_length) 的未处理 input_ids(即那些尚未将其过去键值状态提供给该模型的输入),而不是所有形状为 (batch_size, sequence_length)input_ids

  • inputs_embeds (torch.FloatTensor,形状为 (batch_size, sequence_length, hidden_size)可选) — (可选)您可以选择直接传递嵌入表示,而不是传递 input_ids。如果您希望比模型内部的嵌入查找矩阵更精细地控制如何将 input_ids 索引转换为相关向量,这将非常有用。
  • labels (torch.LongTensor,形状为 (batch_size,)可选) — 用于计算序列分类/回归损失的标签。索引应在 [0, ..., config.num_labels - 1] 范围内。如果 config.num_labels == 1,则计算回归损失(均方误差损失);如果 config.num_labels > 1,则计算分类损失(交叉熵损失)。
  • use_cache (bool可选) — 如果设置为 True,则返回 past_key_values 键值状态,并可用于加速解码(请参阅 past_key_values)。

返回

SequenceClassifierOutputWithPasttuple(torch.FloatTensor)

一个 SequenceClassifierOutputWithPast 或一个 torch.FloatTensor 元组(如果传递了 return_dict=False 或当 config.return_dict=False 时),根据配置(ZambaConfig)和输入包含不同的元素。

ZambaForSequenceClassification 的 forward 方法重写了 __call__ 特殊方法。

虽然 forward pass 的实现需要在此函数中定义,但你应该在之后调用 Module 实例而不是这个,因为前者负责运行预处理和后处理步骤,而后者会静默地忽略它们。

  • loss (形状为 (1,)torch.FloatTensor可选,当提供 labels 时返回) — 分类损失(如果 config.num_labels==1,则为回归损失)。

  • logits (形状为 (batch_size, config.num_labels)torch.FloatTensor) — 分类(如果 config.num_labels==1,则为回归)分数(SoftMax 之前)。

  • past_key_values (Cache,*可选*,当传入 use_cache=Trueconfig.use_cache=True 时返回) — 这是一个 Cache 实例。欲了解更多细节,请参阅我们的 KV 缓存指南

    包含预计算的隐藏状态(自注意力块中的键和值),可用于(参见 past_key_values 输入)加速顺序解码。

  • hidden_states (tuple(torch.FloatTensor), optional, 当传递 output_hidden_states=True 或当 config.output_hidden_states=True 时返回) — torch.FloatTensor 的元组(一个用于嵌入层的输出,如果模型有嵌入层;+一个用于每个层的输出),形状为 (batch_size, sequence_length, hidden_size)

    模型在每个层输出的隐藏状态以及可选的初始嵌入输出。

  • attentions (tuple(torch.FloatTensor), optional, 当传递 output_attentions=True 或当 config.output_attentions=True 时返回) — torch.FloatTensor 的元组(每个层一个),形状为 (batch_size, num_heads, sequence_length, sequence_length)

    注意力 softmax 后的注意力权重,用于计算自注意力头中的加权平均值。

单标签分类示例

>>> import torch
>>> from transformers import AutoTokenizer, ZambaForSequenceClassification

>>> tokenizer = AutoTokenizer.from_pretrained("Zyphra/Zamba-7B-v1")
>>> model = ZambaForSequenceClassification.from_pretrained("Zyphra/Zamba-7B-v1")

>>> inputs = tokenizer("Hello, my dog is cute", return_tensors="pt")

>>> with torch.no_grad():
...     logits = model(**inputs).logits

>>> predicted_class_id = logits.argmax().item()
>>> model.config.id2label[predicted_class_id]
...

>>> # To train a model on `num_labels` classes, you can pass `num_labels=num_labels` to `.from_pretrained(...)`
>>> num_labels = len(model.config.id2label)
>>> model = ZambaForSequenceClassification.from_pretrained("Zyphra/Zamba-7B-v1", num_labels=num_labels)

>>> labels = torch.tensor([1])
>>> loss = model(**inputs, labels=labels).loss
>>> round(loss.item(), 2)
...

多标签分类示例

>>> import torch
>>> from transformers import AutoTokenizer, ZambaForSequenceClassification

>>> tokenizer = AutoTokenizer.from_pretrained("Zyphra/Zamba-7B-v1")
>>> model = ZambaForSequenceClassification.from_pretrained("Zyphra/Zamba-7B-v1", problem_type="multi_label_classification")

>>> inputs = tokenizer("Hello, my dog is cute", return_tensors="pt")

>>> with torch.no_grad():
...     logits = model(**inputs).logits

>>> predicted_class_ids = torch.arange(0, logits.shape[-1])[torch.sigmoid(logits).squeeze(dim=0) > 0.5]

>>> # To train a model on `num_labels` classes, you can pass `num_labels=num_labels` to `.from_pretrained(...)`
>>> num_labels = len(model.config.id2label)
>>> model = ZambaForSequenceClassification.from_pretrained(
...     "Zyphra/Zamba-7B-v1", num_labels=num_labels, problem_type="multi_label_classification"
... )

>>> labels = torch.sum(
...     torch.nn.functional.one_hot(predicted_class_ids[None, :].clone(), num_classes=num_labels), dim=1
... ).to(torch.float)
>>> loss = model(**inputs, labels=labels).loss
在 GitHub 上更新

© . This site is unofficial and not affiliated with Hugging Face, Inc.