Mark some APIs as deprecated (PaddlePaddle#77849)

* deprecated API

* fix CI for deprecated API

* fix test

Author: xpislp

python/paddle/incubate/nn/functional/fused_transformer.py

@@ -26,6 +26,7 @@
     in_dynamic_mode,
     in_dynamic_or_pir_mode,
 )
+from paddle.utils.deprecated import deprecated
 
 if TYPE_CHECKING:
     from collections.abc import Sequence
@@ -509,6 +510,11 @@ def fused_bias_dropout_residual_layer_norm(
         return final_out
 
 
+@deprecated(
+    since="3.4.0",
+    level=1,
+    update_to="paddle.nn.functional.scaled_dot_product_attention",
+)
 def fused_multi_head_attention(
     x: Tensor,
     qkv_weight: Tensor,

python/paddle/incubate/nn/functional/masked_multihead_attention.py

@@ -18,6 +18,7 @@
 
 from paddle import _C_ops
 from paddle.framework import LayerHelper, in_dynamic_or_pir_mode
+from paddle.utils.deprecated import deprecated
 
 if TYPE_CHECKING:
     from paddle import Tensor
@@ -71,6 +72,11 @@ def masked_multihead_attention(
 ) -> tuple[Tensor, Tensor, Tensor]: ...
 
 
+@deprecated(
+    since="3.4.0",
+    level=1,
+    update_to="paddle.nn.functional.scaled_dot_product_attention",
+)
 def masked_multihead_attention(
     x,
     cache_kv=None,

python/paddle/incubate/operators/softmax_mask_fuse_upper_triangle.py

@@ -18,11 +18,17 @@
 from paddle import _C_ops
 from paddle.base.layer_helper import LayerHelper
 from paddle.framework import in_dynamic_or_pir_mode
+from paddle.utils.deprecated import deprecated
 
 if TYPE_CHECKING:
     from paddle import Tensor
 
 
+@deprecated(
+    since="3.4.0",
+    level=1,
+    update_to="paddle.nn.functional.scaled_dot_product_attention",
+)
 def softmax_mask_fuse_upper_triangle(x: Tensor) -> Tensor:
     """
     Do a masked softmax on x, which will always mask upper triangle part of x.

test/legacy_test/test_softmax_mask_fuse_upper_triangle_op.py

@@ -23,6 +23,12 @@
 
 paddle.enable_static()
 
+_softmax_mask_fuse_upper_triangle_python_api = getattr(
+    paddle.incubate.softmax_mask_fuse_upper_triangle,
+    '__wrapped__',
+    paddle.incubate.softmax_mask_fuse_upper_triangle,
+)
+
 
 def _get_softmax_upper(x, fp16=True):
     x_lower = np.tril(x)
@@ -44,7 +50,7 @@ def _get_softmax_upper(x, fp16=True):
 class TestSoftmaxMaskFuseOp(OpTest):
     def setUp(self):
         self.op_type = "fused_softmax_mask_upper_triangle"
-        self.python_api = paddle.incubate.softmax_mask_fuse_upper_triangle
+        self.python_api = _softmax_mask_fuse_upper_triangle_python_api
         x = np.random.random((1, 4, 32, 32)).astype("float16")
         self.inputs = {'X': x}
         rst = _get_softmax_upper(x)
@@ -68,7 +74,7 @@ def test_check_grad(self):
 class TestSoftmaxMaskFuseOp_ZeroSize(TestSoftmaxMaskFuseOp):
     def setUp(self):
         self.op_type = "fused_softmax_mask_upper_triangle"
-        self.python_api = paddle.incubate.softmax_mask_fuse_upper_triangle
+        self.python_api = _softmax_mask_fuse_upper_triangle_python_api
         x = np.random.random((1, 1, 0, 32)).astype("float16")
         self.inputs = {'X': x}
         rst = _get_softmax_upper(x)
@@ -82,7 +88,7 @@ def setUp(self):
 class TestSoftmaxMaskFuseOp1(OpTest):
     def setUp(self):
         self.op_type = "fused_softmax_mask_upper_triangle"
-        self.python_api = paddle.incubate.softmax_mask_fuse_upper_triangle
+        self.python_api = _softmax_mask_fuse_upper_triangle_python_api
         x = np.random.random((1, 4, 32, 32))
         self.inputs = {'X': x}
         rst = _get_softmax_upper(x)