Merged
docs: 修正 MaskedSoftmaxWithRelPosBias 和 ExpandIntoJaggedPermute 输出非连续支持说明 #14401
Nice tryAdd on 8 days ago
docs: 修正 MaskedSoftmaxWithRelPosBias 和 ExpandIntoJaggedPermute 输出非连续支持说明 #14401
Merged
Nice tryAdd on 8 days ago
Nice try
Nice tryCollaborators
8 days ago

描述

本次仅修改资料,将自动生成 ACLNN 接口中两处输出张量的“非连续Tensor”支持标记由 √ 改为 ×,并在约束说明中明确 out 仅支持连续Tensor:

  • aclnnMaskedSoftmaxWithRelPosBias:out 由 √ 改为 ×;约束说明拆分为“x、attenMaskOptional、relativePosBias 支持非连续Tensor,out 不支持非连续Tensor”。
  • aclnnExpandIntoJaggedPermute:out 由 √ 改为 ×;约束说明新增“out 不支持非连续Tensor,仅支持连续Tensor”。

背景:上述接口无 op_host/op_api 手写实现,由 op def 自动生成。自动生成路径仅对入参做连续化,普通输出通过 NnopbaseAddOutput 直接传入,kernel 按连续地址写入,文档中的支持标记与实现不一致。本次为短期文档收敛,不改变接口实现与入参非连续能力。

关联的Issue

关联 Issue #8684:https://gitcode.com/cann/ops-nn/issues/8684
关联 Issue #8683:https://gitcode.com/cann/ops-nn/issues/8683

测试

本 PR 仅涉及资料修改,未新增或执行代码测试。已在 Atlas A2(910B3)+ CANN 9.2.0 上用复现程序确认:两接口的非连续 out 当前按连续布局写入,与资料修正后的“仅支持连续Tensor”约束对应;非连续 out 的显式拒绝不在本 PR 范围。

文档更新

  • norm/masked_softmax_with_rel_pos_bias/docs/aclnnMaskedSoftmaxWithRelPosBias.md
  • norm/masked_softmax_with_rel_pos_bias/docs/aclnnMaskedSoftmaxWithRelPosBias_en.md
  • index/expand_into_jagged_permute/docs/aclnnExpandIntoJaggedPermute.md
  • index/expand_into_jagged_permute/docs/aclnnExpandIntoJaggedPermute_en.md

类型标签

AI/Agent生成声明

likedislike
Pull Request has been successfully merged by CANN-robot.
(Thank you for Nice try's contribution.)
Nice tryNice tryCollaborators
8 days ago Created pull request, commit bbeb7bf0
atomgit-bot
atomgit-bot
8 days ago Comments:

变更摘要

本 PR 为文档修正,更新 aclnnMaskedSoftmaxWithRelPosBias 与 aclnnExpandIntoJaggedPermute 两个 aclnn 接口中输出参数 out 对非连续 Tensor 的支持说明,将原本标注为支持非连续 Tensor 的描述修正为仅支持连续 Tensor,中英文文档同步修改。

主要改动

  • out 参数支持性表格修正: 在 aclnnExpandIntoJaggedPermute.md 与 aclnnMaskedSoftmaxWithRelPosBias.md 及对应英文文档的参数表中,out 的 shape 说明补充"仅支持连续tensor",并将非连续支持列由 √ 改为 ×。
  • aclnnExpandIntoJaggedPermute 约束条件补充: 在中文与英文文档的约束说明列表末尾新增一条,明确 out 不支持非连续 Tensor,仅支持连续 Tensor。
  • aclnnMaskedSoftmaxWithRelPosBias 非连续 Tensor 支持范围调整: 将原先"x、attenMaskOptional、relativePosBias、out 均支持非连续 Tensor"拆分为两条,其中 x、attenMaskOptional、relativePosBias 仍由框架自动转为连续 Tensor 参与计算,out 单独声明不支持非连续 Tensor。
  • 中英文文档一致性: 四个文档文件(index/expand_into_jagged_permute 与 norm/masked_softmax_with_rel_pos_bias 的中英文版本)均做同口径修改,保证接口对外说明的语义一致。

🧩 本次 Review 已使用自定义 Skill:

likedislike
Incorrect?
atomgit-bot
atomgit-bot
8 days ago Comments:

代码审查

✅ 未发现问题


🧩 本次 Review 已使用自定义 Skill:

likedislike
Incorrect?
CANN-robotCANN-robotCollaborators
8 days ago Added label: cann-cla/yes
CANN-robot
CANN-robotCollaborators
8 days ago Comments:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.


PR Approval Progress

✅ Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
*/*/docs/acl*.md ✅ 杨露, 汤平川 (2/2) ✅ 杨露 (1/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

Nice_try, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
CANN-robotCANN-robotCollaborators
8 days ago Set zengjuan,u010470851,chenfeng61,chaotang233,kevin_huang1234,crystalhu,yangyang016,fanqirui,gitee-duhuiping,wangrui_,renruhai,su-yueming,zhajianqing123,yourealize,chenqi317,wang-xing001,liubo75,tangweiwei2,gitcode-chenjiao,chenxingyu18,liujie12345678,east_yang,lwx1255555,pingchuantang,Chen_HaoWen,qianzehong,fengying555682,caiwenwen,yanglu-1 as approver
CANN-robotCANN-robotCollaborators
8 days ago Set gitee-duhuiping,gitcode-chenjiao,lwx1255555,fengying555682,caiwenwen,yanglu-1 as approver
Nice tryNice tryCollaborators
8 days ago Modify description of pull request
Nice try
Nice tryCollaborators
8 days ago Comments:

compile

likedislike
Nice tryNice tryCollaborators
8 days ago Pre merge succeeded (commit_id: 4d2dabda942be5cc1b6847fcf3b3500d9848f0b9)
CANN-robot
CANN-robotCollaborators
8 days ago Comments:
🚀 CI 流水线已启动
📋 执行详情: 点击查看流水线
likedislike
CANN-robotCANN-robotCollaborators
8 days ago Added label: ci-pipeline-running
CANN-robotCANN-robotCollaborators
8 days ago Removed label: ci-pipeline-running
CANN-robotCANN-robotCollaborators
8 days ago Added label: ci-pipeline-passed
Nice try
Nice tryCollaborators
8 days ago Comments:
likedislike
TangPC
TangPCCollaborators
8 days ago Comments:

/lgtm
/approve

likedislike
yuning_chen
yuning_chenCollaborators
8 days ago Comments:

您好,pr合入已准备就绪,请尽快联系committer进行检视,谢谢!
@yourealize @fengying555682 @kevin_huang1234 @wang-xing001 @su-yueming @yanglu-1 @lwx1255555 @gitcode-chenjiao @gitee-duhuiping

likedislike
yanglu-1
yanglu-1Collaborators
8 days ago Comments:

/lgtm
/approve

likedislike
CANN-robot
CANN-robotCollaborators
8 days ago Comments:

The following users do not have permission to comment /lgtm or /approve on any module in this PR:
/approve: 汤平川

likedislike
CANN-robotCANN-robotCollaborators
8 days ago Added label: lgtmapproved
CANN-robotCANN-robotCollaborators
8 days ago Closed associated issue
CANN-robotCANN-robotCollaborators
8 days ago Merged pull request