Pull Request has been successfully merged by CANN-robot.
(Thank you for KaranocaVe's contribution.)变更摘要
本 PR 为 aclnnSoftMarginLoss 接口文档补充数据类型的产品架构限定。此前 aclnnSoftMarginLoss 参数表将 self、target 和 out 的数据类型统一标注为 FLOAT、FLOAT16、BFLOAT16,未区分产品架构,容易让调用方误以为 Atlas 推理系列和 Atlas 训练系列也支持 BFLOAT16。本次在 loss/soft_margin_loss/docs/aclnnSoftMarginLoss.md 参数表之后新增产品限定说明,明确这两类产品不支持 BFLOAT16;算子实现与其他参数约定不变。
主要改动
- 补充 BFLOAT16 产品适用范围限制:在
aclnnSoftMarginLoss参数表后新增npu="910,310p"限定的说明条目,指明Atlas推理系列产品与Atlas训练系列产品的数据类型不支持 BFLOAT16。 - 明确文档与实现约束保持一致:该说明与按架构选择支持列表的类型校验行为对齐,避免调用方在上述产品上误用 BFLOAT16。
- 仅文档改动、无接口契约变更:改动仅涉及
aclnnSoftMarginLoss.md的新增说明行,不涉及算子实现或其他参数合同调整。
🧩 本次 Review 已使用自定义 Skill:




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
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
KaranocaVe, thanks for your pull request. All authors of the commits have signed the CLA. 👍


/compile


| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |


您好,pr合入已准备就绪,请尽快联系committer进行检视,谢谢!
@wang-xing001 @yangyang016 @fengying555682 @chaotang233 @pingchuantang @lwx1255555 @gitcode-chenjiao @gitee-duhuiping @caiwenwen


/lgtm
/approve


/approve
/lgtm


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


[Docs] 补充 SoftMarginLoss 的 BFLOAT16 产品限制
变更
aclnnSoftMarginLoss参数表把self、target和out的数据类型统一列为FLOAT、FLOAT16、BFLOAT16,但没有说明产品架构差异。在固定验收源码ae873b119fb5499c41a6893f920171551fb0a197中,类型校验按架构选择支持列表:DAV_2201或 Regbase 支持 BFLOAT16,其他架构仅支持 FLOAT/FLOAT16,文档可能误导调用方在 Atlas 推理系列(310p)和 Atlas 训练系列(910)使用 BFLOAT16。在参数表后增加
npu="910,310p"产品限定,明确 Atlas 推理系列和 Atlas 训练系列不支持 BFLOAT16。Atlas A2、Atlas A3 和 Ascend 950 的 BFLOAT16 支持保持由实现和现有产品支持表表达,不修改算子实现或其他参数合同。关联工作
out的 shape/rank,均与 dtype 产品范围不同。验证
关联 Issue: https://gitcode.com/cann/ops-nn/issues/8575