RDBC-934 Deprecate schema_type parameter

Author: poissoncorp

ravendb/documents/operations/ai/agents/add_or_update_ai_agent_operation.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 import json
+import warnings
 from typing import Optional, Type, Dict, Any, TYPE_CHECKING
 
 from ravendb.documents.operations.definitions import MaintenanceOperation
@@ -28,6 +29,13 @@ def from_json(cls, json_dict: Dict[str, Any]) -> AiAgentConfigurationResult:
 
 class AddOrUpdateAiAgentOperation(MaintenanceOperation[AiAgentConfigurationResult]):
     def __init__(self, configuration: AiAgentConfiguration, schema_type: Type = None):
+        if schema_type is not None:
+            warnings.warn(
+                "The 'schema_type' parameter is deprecated and will be removed in 8.0 version of Python client."
+                " Use 'sample_object' or 'output_schema' inside AiAgentConfiguration instead.",
+                DeprecationWarning,
+                stacklevel=2
+            )
         if configuration is None:
             raise ValueError("configuration cannot be None")