New docs

Author: GiovanniGiacometti

md-docs/api/python/client.md

@@ -425,9 +425,9 @@ Task ID                   Name     Type            Status     Status start date
 ### .create_model
 ```python
 .create_model(
-   task_id: str, name: str, version: str, metric_name: ModelMetricName,
-   preferred_suggestion_type: SuggestionType, retraining_cost: float = 0.0,
-   resampled_dataset_size: (int|None) = None
+   task_id: str, name: str, version: str, metric_name: (ModelMetricName|None),
+   preferred_suggestion_type: (SuggestionType|None) = None,
+   retraining_cost: float = 0.0, resampled_dataset_size: (int|None) = None
 )
 ```
 
@@ -593,7 +593,7 @@ Show a list of models included in a task to stdout.
 ```
 Model Id                  Task Id                   Name                    Version    Status           Status start timestamp    Status insert date          Metric Name
 ------------------------  ------------------------  ----------------------  ---------  ---------------  ------------------------  --------------------------  --------------------
-64fecf7d323311ab78f17280  64fecf7c323311ab78f17262  model_local_experiment  v0.0.1     not_initialized                            2023-09-11 08:27:41.431000  ModelMetricName.RMSE
+64fecf7d323311ab78f17280  64fecf7c323311ab78f17262  model_local_experiment  v0.0.1     ok                                         2023-09-11 08:27:41.431000  ModelMetricName.RMSE
 ```
 
 ### .get_suggestions_info
@@ -1284,6 +1284,41 @@ the retraining report
 
 `GetRetrainingReportException`
 
+### .get_monitoring_status
+```python
+.get_monitoring_status(
+   task_id: str, monitoring_target: MonitoringTarget,
+   monitoring_metric: (MonitoringMetric|None) = None
+)
+```
+
+---
+Get the monitoring status of a monitoring target (or metric) in a task.
+
+**Allowed Roles:**
+
+- At least `PROJECT_VIEW` for that project
+- `COMPANY_OWNER`
+- `COMPANY_ADMIN`
+
+
+**Args**
+
+* **task_id**  : the identifier of the task
+* **monitoring_target**  : the type of monitoring target to get the status
+* **monitoring_metric**  : the type of monitoring metric to get the status
+    If ``None``, only the monitoring target is considered
+
+
+**Returns**
+
+* **monitoring_quantity_status**  : `MonitoringQuantityStatus`
+
+
+**Raises**
+
+`SDKClientException`
+
 ### .get_jobs
 ```python
 .get_jobs(

md-docs/api/python/enums.md

@@ -32,6 +32,19 @@ Describe the role of a column
 ----
 
 
+## ColumnSubRole
+```python 
+ColumnSubRole()
+```
+
+
+---
+Column subrole enum
+Describe the subrole of a column
+
+----
+
+
 ## Currency
 ```python 
 Currency()
@@ -222,36 +235,35 @@ Name of the model metrics that is associated with the model
 ----
 
 
-## ModelStatus
+## MonitoringMetric
 ```python 
-ModelStatus()
+MonitoringMetric()
 ```
 
 
 ---
 **Fields:**
 
-- NOT_INITIALIZED
-- OK
-- WARNING
-- DRIFT
+- FEATURE
+- TEXT_TOXICITY
+- TEXT_EMOTION
+- TEXT_SENTIMENT
 
 ----
 
 
-## MonitoringMetric
+## MonitoringStatus
 ```python 
-MonitoringMetric()
+MonitoringStatus()
 ```
 
 
 ---
 **Fields:**
 
-- FEATURE
-- TEXT_TOXICITY
-- TEXT_EMOTION
-- TEXT_SENTIMENT
+- OK
+- WARNING
+- DRIFT
 
 ----
 
@@ -269,6 +281,10 @@ MonitoringTarget()
 - INPUT
 - CONCEPT
 - PREDICTION
+- USER_INPUT
+- USER_INPUT_RETRIEVED_CONTEXT
+- USER_INPUT_MODEL_OUTPUT
+- MODEL_OUTPUT_RETRIEVED_CONTEXT
 
 ----
 
@@ -335,22 +351,6 @@ type of suggestion
 ----
 
 
-## TaskStatus
-```python 
-TaskStatus()
-```
-
-
----
-**Fields:**
-
-- OK
-- WARNING
-- DRIFT
-
-----
-
-
 ## TaskType
 ```python 
 TaskType()

md-docs/api/python/models.md

@@ -166,6 +166,10 @@ Column base model
 * **classes_names**  : Optional[list[str]] = None
     it is mandatory when the column is the target
     in multilabel classification tasks
+* **subrole**  : Optional[ColumnSubRole] = None
+    Indicates the subrole of the column. It's used in
+    RAG tasks to define the role of the input columns
+    (e.g. user input or retrieved context)
 
 
 ----
@@ -278,7 +282,6 @@ An event created during the detection process.
 * **severity_type**  : Optional[DetectionEventSeverity]
 * **insert_datetime**  : str
 * **sample_timestamp**  : float
-* **sample_id**  : str
 * **model_id**  : Optional[str]
 * **model_name**  : Optional[str]
 * **model_version**  : Optional[str]
@@ -585,12 +588,6 @@ Base model to define model item
 * **task_id**  : str
 * **name**  : str
 * **version**  : str
-* **status**  : ModelStatus
-* **status_data_start_timestamp**  : Optional[float]
-* **status_insert_datetime**  : datetime
-* **prediction_status**  : ModelStatus
-* **prediction_status_data_start_timestamp**  : Optional[float]
-* **prediction_status_insert_datetime**  : datetime
 * **metric_name**  : performance or error metric associated with
     the model
 * **creation_datetime**  : Optional[datetime]
@@ -600,6 +597,19 @@ Base model to define model item
 ----
 
 
+## MonitoringQuantityStatus
+```python 
+MonitoringQuantityStatus()
+```
+
+
+---
+Base model to store the monitoring status
+of a monitoring quantity (target or metric)
+
+----
+
+
 ## MulticlassClassificationTaskCostInfo
 ```python 
 MulticlassClassificationTaskCostInfo()
@@ -962,10 +972,6 @@ Task model
 * **task_id**  : str
 * **name**  : str
 * **type**  : TaskType
-* **input_status**  : TaskStatus
-* **input_status_insert_datetime**  : str
-* **concept_status**  : TaskStatus
-* **concept_status_insert_datetime**  : str
 
 
 ----