update schema URL and docs

Author: lmolkova

instrumentation-genai/opentelemetry-instrumentation-openai-v2/README.rst

@@ -19,7 +19,7 @@ Many LLM platforms support the OpenAI SDK. This means systems such as the follow
    * - Name
      - gen_ai.system
    * - `Azure OpenAI <https://github.com/openai/openai-python?tab=readme-ov-file#microsoft-azure-openai>`_
-     - ``az.ai.openai``
+     - ``azure.ai.openai``
    * - `Gemini <https://developers.googleblog.com/en/gemini-is-now-accessible-from-the-openai-library/>`_
      - ``gemini``
    * - `Perplexity <https://docs.perplexity.ai/api-reference/chat-completions>`_
@@ -80,9 +80,26 @@ Enabling message content
 
 Message content such as the contents of the prompt, completion, function arguments and return values
 are not captured by default. To capture message content as log events, set the environment variable
-`OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` to `true`.
+``OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`` to one of the following values:
 
-TODO!
+- ``true`` - Legacy. Used to enable content capturing on ``gen_ai.{role}.message`` and ``gen_ai.choice`` events when
+  `latest experimental features <#enabling-the-latest-experimental-features>`_ are *not* enabled.
+- ``span`` - Used to enable content capturing on *span* attributes when
+  `latest experimental features <#enabling-the-latest-experimental-features>`_ are enabled.
+- ``event`` - Used to enable content capturing on *event* attributes when
+  `latest experimental features <#enabling-the-latest-experimental-features>`_ are enabled.
+
+Enabling the latest experimental features
+***********************************************
+
+To enable the latest experimental features, set the environment variable
+``OTEL_SEMCONV_STABILITY_OPT_IN`` to ``gen_ai_latest_experimental``. Or, if you use
+``OTEL_SEMCONV_STABILITY_OPT_IN`` to enable other features, append ``,gen_ai_latest_experimental`` to its value.
+
+Without this setting, OpenAI instrumentation aligns with `Semantic Conventions v1.28.0 <https://github.com/open-telemetry/semantic-conventions/tree/v1.28.0/docs/gen-ai>`_
+and would not capture additional details introduced in later versions.
+
+.. note:: Generative AI semantic conventions are still evolving. The latest experimental features will introduce breaking changes in future releases.
 
 Uninstrument
 ************

instrumentation-genai/opentelemetry-instrumentation-openai-v2/examples/manual/README.rst

@@ -11,7 +11,8 @@ your OpenAI requests.
 
 Note: `.env <.env>`_ file configures additional environment variables:
 
-- ``OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`` configures OpenAI instrumentation to capture prompt and completion contents on events.
+- ``OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span`` configures OpenAI instrumentation to capture prompt and completion contents on *span* attributes.
+- ``OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental`` enables latest experimental features.
 
 Setup
 -----

instrumentation-genai/opentelemetry-instrumentation-openai-v2/examples/zero-code/README.rst

@@ -13,10 +13,10 @@ your OpenAI requests.
 Note: `.env <.env>`_ file configures additional environment variables:
 
 - ``OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true`` configures OpenTelemetry SDK to export logs and events.
-- ``OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`` configures OpenAI instrumentation to capture prompt and completion contents on events.
+- ``OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span`` configures OpenAI instrumentation to capture prompt and completion contents on *span* attributes.
 - ``OTEL_LOGS_EXPORTER=otlp`` to specify exporter type.
+- ``OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental`` enables latest experimental features.
 
-TODO!
 Setup
 -----
 

instrumentation-genai/opentelemetry-instrumentation-openai-v2/src/opentelemetry/instrumentation/openai_v2/__init__.py

@@ -74,21 +74,21 @@ def _instrument(self, **kwargs):
             __name__,
             "",
             tracer_provider,
-            schema_url=Schemas.V1_28_0.value,
+            schema_url="https://opentelemetry.io/schemas/1.37.0", # TODO: Schemas.V1_37_0.value,
         )
         event_logger_provider = kwargs.get("event_logger_provider")
         event_logger = get_event_logger(
             __name__,
             "",
-            schema_url=Schemas.V1_28_0.value,
+            schema_url="https://opentelemetry.io/schemas/1.37.0",  # TODO: Schemas.V1_37_0.value,
             event_logger_provider=event_logger_provider,
         )
         meter_provider = kwargs.get("meter_provider")
         self._meter = get_meter(
             __name__,
             "",
             meter_provider,
-            schema_url=Schemas.V1_28_0.value,
+            schema_url="https://opentelemetry.io/schemas/1.37.0",  # TODO: Schemas.V1_37_0.value,
         )
 
         instruments = Instruments(self._meter)