refactor: introduce ai operator namespace and deprecated semantics

bigframes/_config/compute_options.py

@@ -84,6 +84,9 @@ class ComputeOptions:
     semantic_ops_confirmation_threshold: Optional[int] = 0
     semantic_ops_threshold_autofail = False
 
+    ai_ops_confirmation_threshold: Optional[int] = 0
+    ai_ops_threshold_autofail = False
+
     def assign_extra_query_labels(self, **kwargs: Any) -> None:
         """
         Assigns additional custom labels for query configuration. The method updates the

bigframes/_config/experiment_options.py

@@ -24,6 +24,7 @@ class ExperimentOptions:
 
     def __init__(self):
         self._semantic_operators: bool = False
+        self._ai_operators: bool = False
         self._blob: bool = False
         self._udf: bool = False
 
@@ -41,6 +42,20 @@ def semantic_operators(self, value: bool):
             warnings.warn(msg, category=bfe.PreviewWarning)
         self._semantic_operators = value
 
+    @property
+    def ai_operators(self) -> bool:
+        return self._ai_operators
+
+    @ai_operators.setter
+    def ai_operators(self, value: bool):
+        if value is True:
+            msg = bfe.format_message(
+                "AI operators are still under experiments, and are subject "
+                "to change in the future."
+            )
+            warnings.warn(msg, category=bfe.PreviewWarning)
+        self._ai_operators = value
+
     @property
     def blob(self) -> bool:
         return self._blob

bigframes/dataframe.py

@@ -74,6 +74,7 @@
 import bigframes.operations as ops
 import bigframes.operations.aggregations
 import bigframes.operations.aggregations as agg_ops
+import bigframes.operations.ai
 import bigframes.operations.plotting as plotting
 import bigframes.operations.semantics
 import bigframes.operations.structs
@@ -4574,4 +4575,12 @@ def _throw_if_null_index(self, opname: str):
 
     @property
     def semantics(self):
+        warnings.warn(
+            "The 'semantic' property will be removed. Please use 'ai' instead.",
+            FutureWarning,
+        )
         return bigframes.operations.semantics.Semantics(self)
+
+    @property
+    def ai(self):
+        return bigframes.operations.ai.Ai(self)