doc ml obs Expose LLM Observability annotation endpoints (#1696)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -0,0 +1,30 @@
+// Delete annotations returns "OK — annotations deleted. Errors for annotations
+// that could not be deleted are listed in `errors`." response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_llm_observability::LLMObservabilityAPI;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationsType;
+use datadog_api_client::datadogV2::model::LLMObsDeleteAnnotationsDataAttributesRequest;
+use datadog_api_client::datadogV2::model::LLMObsDeleteAnnotationsDataRequest;
+use datadog_api_client::datadogV2::model::LLMObsDeleteAnnotationsRequest;
+
+#[tokio::main]
+async fn main() {
+    let body = LLMObsDeleteAnnotationsRequest::new(LLMObsDeleteAnnotationsDataRequest::new(
+        LLMObsDeleteAnnotationsDataAttributesRequest::new(vec![
+            "00000000-0000-0000-0000-000000000000".to_string(),
+            "00000000-0000-0000-0000-000000000001".to_string(),
+        ]),
+        LLMObsAnnotationsType::ANNOTATIONS,
+    ));
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.DeleteLLMObsAnnotations", true);
+    let api = LLMObservabilityAPI::with_config(configuration);
+    let resp = api
+        .delete_llm_obs_annotations("queue_id".to_string(), body)
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_llm-observability_DeleteLLMObsAnnotations.rs

@@ -0,0 +1,42 @@
+// Create or update annotations returns "OK — annotations created or updated.
+// Per-item errors are listed in `errors`." response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_llm_observability::LLMObservabilityAPI;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationLabelValue;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationLabelValueValue;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationsDataAttributesRequest;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationsDataRequest;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationsRequest;
+use datadog_api_client::datadogV2::model::LLMObsAnnotationsType;
+use datadog_api_client::datadogV2::model::LLMObsUpsertAnnotationItem;
+
+#[tokio::main]
+async fn main() {
+    let body = LLMObsAnnotationsRequest::new(LLMObsAnnotationsDataRequest::new(
+        LLMObsAnnotationsDataAttributesRequest::new(vec![LLMObsUpsertAnnotationItem::new(
+            "00000000-0000-0000-0000-000000000001".to_string(),
+            vec![
+                LLMObsAnnotationLabelValue::new(
+                    "abc-123".to_string(),
+                    LLMObsAnnotationLabelValueValue::AnyValueString("good".to_string()),
+                ),
+                LLMObsAnnotationLabelValue::new(
+                    "ef56gh78".to_string(),
+                    LLMObsAnnotationLabelValueValue::AnyValueString("positive".to_string()),
+                ),
+            ],
+        )]),
+        LLMObsAnnotationsType::ANNOTATIONS,
+    ));
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.UpsertLLMObsAnnotations", true);
+    let api = LLMObservabilityAPI::with_config(configuration);
+    let resp = api
+        .upsert_llm_obs_annotations("queue_id".to_string(), body)
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_llm-observability_UpsertLLMObsAnnotations.rs

@@ -159,6 +159,7 @@ impl Default for Configuration {
                 "v2.delete_llm_obs_annotation_queue_interactions".to_owned(),
                 false,
             ),
+            ("v2.delete_llm_obs_annotations".to_owned(), false),
             ("v2.delete_llm_obs_custom_eval_config".to_owned(), false),
             ("v2.delete_llm_obs_data".to_owned(), false),
             ("v2.delete_llm_obs_dataset_records".to_owned(), false),
@@ -206,6 +207,7 @@ impl Default for Configuration {
             ("v2.update_llm_obs_experiment".to_owned(), false),
             ("v2.update_llm_obs_project".to_owned(), false),
             ("v2.upload_llm_obs_dataset_records_file".to_owned(), false),
+            ("v2.upsert_llm_obs_annotations".to_owned(), false),
             ("v2.create_annotation".to_owned(), false),
             ("v2.delete_annotation".to_owned(), false),
             ("v2.get_page_annotations".to_owned(), false),