torch.nn.attention.sdpa_kernel

torch.nn.attention.sdpa_kernel(backends, set_priority=False)

用于选择缩放点积注意力（scaled dot product attention）的后端的上下文管理器。

警告

此函数为 Beta 版本，可能会发生更改。

参数

• backends (Union[List[SDPBackend], SDPBackend]) – 用于缩放点积注意力的后端或后端列表。

• set_priority_order (python:bool=False) – 后端的顺序是否被解释为其优先级顺序。

示例

from torch.nn.functional import scaled_dot_product_attention
from torch.nn.attention import SDPBackend, sdpa_kernel

# Only enable flash attention backend
with sdpa_kernel(SDPBackend.FLASH_ATTENTION):
    scaled_dot_product_attention(...)

# Enable the Math or Efficient attention backends
with sdpa_kernel([SDPBackend.MATH, SDPBackend.EFFICIENT_ATTENTION]):
    scaled_dot_product_attention(...)

此上下文管理器可用于选择缩放点积注意力要使用的后端。退出上下文管理器时，将恢复标志的先前状态，从而启用所有后端。