Add public API spec for LLM Observability prompt registry CRUD endpoints

docs/datadog_api_client.v2.model.rst

@@ -21956,6 +21956,48 @@ datadog\_api\_client.v2.model.llm\_obs\_content\_block\_type module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.llm\_obs\_create\_prompt\_data module
+-------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_create_prompt_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_create\_prompt\_data\_attributes module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_create_prompt_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_create\_prompt\_request module
+----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_create_prompt_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_create\_prompt\_version\_data module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_create_prompt_version_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_create\_prompt\_version\_data\_attributes module
+----------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_create_prompt_version_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_create\_prompt\_version\_request module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_create_prompt_version_request
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.llm\_obs\_cursor\_meta module
 -----------------------------------------------------------
 
@@ -22656,6 +22698,27 @@ datadog\_api\_client.v2.model.llm\_obs\_delete\_projects\_request module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.llm\_obs\_deleted\_prompt\_data module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_deleted_prompt_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_deleted\_prompt\_data\_attributes module
+--------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_deleted_prompt_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_deleted\_prompt\_response module
+------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_deleted_prompt_response
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.llm\_obs\_display\_block\_annotated\_interaction\_item module
 -------------------------------------------------------------------------------------------
 
@@ -23727,6 +23790,146 @@ datadog\_api\_client.v2.model.llm\_obs\_projects\_response module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_chat\_message module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_chat_message
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_data module
+-----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_data\_attributes module
+-----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_dataset module
+--------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_dataset
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_response module
+---------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_response\_source module
+-----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_response_source
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_sdk\_data module
+----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_sdk_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_sdk\_data\_attributes module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_sdk_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_sdk\_response module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_sdk_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_template module
+---------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_template
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_type module
+-----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_data module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_data\_attributes module
+--------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_label module
+---------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_label
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_list\_data module
+--------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_list_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_list\_data\_attributes module
+--------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_list_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_response module
+------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_version\_type module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_version_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompt\_versions\_response module
+-------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompt_versions_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_prompts\_response module
+----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_prompts_response
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.llm\_obs\_record\_type module
 -----------------------------------------------------------
 
@@ -23902,6 +24105,48 @@ datadog\_api\_client.v2.model.llm\_obs\_trace\_interaction\_type module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.llm\_obs\_update\_prompt\_data module
+-------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_update_prompt_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_update\_prompt\_data\_attributes module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_update_prompt_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_update\_prompt\_request module
+----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_update_prompt_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_update\_prompt\_version\_data module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_update_prompt_version_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_update\_prompt\_version\_data\_attributes module
+----------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_update_prompt_version_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_update\_prompt\_version\_request module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_update_prompt_version_request
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.llm\_obs\_upsert\_annotation\_item module
 -----------------------------------------------------------------------
 

examples/v2/llm-observability/CreateLLMObsPrompt.py

@@ -0,0 +1,29 @@
+"""
+Create an LLM Observability prompt returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+from datadog_api_client.v2.model.llm_obs_create_prompt_data import LLMObsCreatePromptData
+from datadog_api_client.v2.model.llm_obs_create_prompt_data_attributes import LLMObsCreatePromptDataAttributes
+from datadog_api_client.v2.model.llm_obs_create_prompt_request import LLMObsCreatePromptRequest
+from datadog_api_client.v2.model.llm_obs_prompt_type import LLMObsPromptType
+
+body = LLMObsCreatePromptRequest(
+    data=LLMObsCreatePromptData(
+        attributes=LLMObsCreatePromptDataAttributes(
+            prompt_id="Example-LLM-Observability",
+            title="Customer Support Assistant",
+            template="You are a helpful customer support assistant for {{company_name}}. Help {{customer_name}} with this question: {{question}}",
+        ),
+        type=LLMObsPromptType.PROMPT_TEMPLATES,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["create_llm_obs_prompt"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.create_llm_obs_prompt(body=body)
+
+    print(response)

examples/v2/llm-observability/CreateLLMObsPromptVersion.py

@@ -0,0 +1,33 @@
+"""
+Create a new LLM Observability prompt version returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+from datadog_api_client.v2.model.llm_obs_create_prompt_version_data import LLMObsCreatePromptVersionData
+from datadog_api_client.v2.model.llm_obs_create_prompt_version_data_attributes import (
+    LLMObsCreatePromptVersionDataAttributes,
+)
+from datadog_api_client.v2.model.llm_obs_create_prompt_version_request import LLMObsCreatePromptVersionRequest
+from datadog_api_client.v2.model.llm_obs_prompt_version_type import LLMObsPromptVersionType
+
+# there is a valid "prompt" in the system
+PROMPT_DATA_ATTRIBUTES_PROMPT_ID = environ["PROMPT_DATA_ATTRIBUTES_PROMPT_ID"]
+
+body = LLMObsCreatePromptVersionRequest(
+    data=LLMObsCreatePromptVersionData(
+        attributes=LLMObsCreatePromptVersionDataAttributes(
+            template="You are a concise customer support assistant for {{company_name}}. Answer {{customer_name}}'s question: {{question}}",
+        ),
+        type=LLMObsPromptVersionType.PROMPT_TEMPLATE_VERSIONS,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["create_llm_obs_prompt_version"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.create_llm_obs_prompt_version(prompt_id=PROMPT_DATA_ATTRIBUTES_PROMPT_ID, body=body)
+
+    print(response)

examples/v2/llm-observability/DeleteLLMObsPrompt.py

@@ -0,0 +1,20 @@
+"""
+Delete an LLM Observability prompt returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+
+# there is a valid "prompt" in the system
+PROMPT_DATA_ATTRIBUTES_PROMPT_ID = environ["PROMPT_DATA_ATTRIBUTES_PROMPT_ID"]
+
+configuration = Configuration()
+configuration.unstable_operations["delete_llm_obs_prompt"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.delete_llm_obs_prompt(
+        prompt_id=PROMPT_DATA_ATTRIBUTES_PROMPT_ID,
+    )
+
+    print(response)

examples/v2/llm-observability/GetLLMObsPrompt.py

@@ -0,0 +1,20 @@
+"""
+Get an LLM Observability prompt returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+
+# there is a valid "prompt" in the system
+PROMPT_DATA_ATTRIBUTES_PROMPT_ID = environ["PROMPT_DATA_ATTRIBUTES_PROMPT_ID"]
+
+configuration = Configuration()
+configuration.unstable_operations["get_llm_obs_prompt"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.get_llm_obs_prompt(
+        prompt_id=PROMPT_DATA_ATTRIBUTES_PROMPT_ID,
+    )
+
+    print(response)