feat(attributes): Add gen_ai.request.reasoning_effort attribute

javascript/sentry-conventions/src/attributes.ts

@@ -4430,6 +4430,26 @@ export const GEN_AI_REQUEST_PRESENCE_PENALTY = 'gen_ai.request.presence_penalty'
  */
 export type GEN_AI_REQUEST_PRESENCE_PENALTY_TYPE = number;
 
+// Path: model/attributes/gen_ai/gen_ai__request__reasoning_effort.json
+
+/**
+ * Constrains the effort on reasoning for reasoning models. Supported values vary by provider. `gen_ai.request.reasoning_effort`
+ *
+ * Attribute Value Type: `string` {@link GEN_AI_REQUEST_REASONING_EFFORT_TYPE}
+ *
+ * Contains PII: false
+ *
+ * Attribute defined in OTEL: No
+ *
+ * @example "high"
+ */
+export const GEN_AI_REQUEST_REASONING_EFFORT = 'gen_ai.request.reasoning_effort';
+
+/**
+ * Type for {@link GEN_AI_REQUEST_REASONING_EFFORT} gen_ai.request.reasoning_effort
+ */
+export type GEN_AI_REQUEST_REASONING_EFFORT_TYPE = string;
+
 // Path: model/attributes/gen_ai/gen_ai__request__seed.json
 
 /**
@@ -11960,6 +11980,7 @@ export const ATTRIBUTE_TYPE: Record<string, AttributeType> = {
   [GEN_AI_REQUEST_MESSAGES]: 'string',
   [GEN_AI_REQUEST_MODEL]: 'string',
   [GEN_AI_REQUEST_PRESENCE_PENALTY]: 'double',
+  [GEN_AI_REQUEST_REASONING_EFFORT]: 'string',
   [GEN_AI_REQUEST_SEED]: 'string',
   [GEN_AI_REQUEST_TEMPERATURE]: 'double',
   [GEN_AI_REQUEST_TOP_K]: 'integer',
@@ -12520,6 +12541,7 @@ export type AttributeName =
   | typeof GEN_AI_REQUEST_MESSAGES
   | typeof GEN_AI_REQUEST_MODEL
   | typeof GEN_AI_REQUEST_PRESENCE_PENALTY
+  | typeof GEN_AI_REQUEST_REASONING_EFFORT
   | typeof GEN_AI_REQUEST_SEED
   | typeof GEN_AI_REQUEST_TEMPERATURE
   | typeof GEN_AI_REQUEST_TOP_K
@@ -15576,6 +15598,17 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
       { version: '0.1.0', prs: [57] },
     ],
   },
+  [GEN_AI_REQUEST_REASONING_EFFORT]: {
+    brief:
+      'Constrains the effort on reasoning for reasoning models. Supported values vary by provider.',
+    type: 'string',
+    pii: {
+      isPii: 'false',
+    },
+    isInOtel: false,
+    example: 'high',
+    changelog: [{ version: 'next', prs: [334], description: 'Added gen_ai.request.reasoning_effort attribute' }],
+  },
   [GEN_AI_REQUEST_SEED]: {
     brief: 'The seed, ideally models given the same seed and same other parameters will produce the exact same output.',
     type: 'string',
@@ -19937,6 +19970,7 @@ export type Attributes = {
   [GEN_AI_REQUEST_MESSAGES]?: GEN_AI_REQUEST_MESSAGES_TYPE;
   [GEN_AI_REQUEST_MODEL]?: GEN_AI_REQUEST_MODEL_TYPE;
   [GEN_AI_REQUEST_PRESENCE_PENALTY]?: GEN_AI_REQUEST_PRESENCE_PENALTY_TYPE;
+  [GEN_AI_REQUEST_REASONING_EFFORT]?: GEN_AI_REQUEST_REASONING_EFFORT_TYPE;
   [GEN_AI_REQUEST_SEED]?: GEN_AI_REQUEST_SEED_TYPE;
   [GEN_AI_REQUEST_TEMPERATURE]?: GEN_AI_REQUEST_TEMPERATURE_TYPE;
   [GEN_AI_REQUEST_TOP_K]?: GEN_AI_REQUEST_TOP_K_TYPE;

model/attributes/gen_ai/gen_ai__request__reasoning_effort.json

@@ -0,0 +1,17 @@
+{
+  "key": "gen_ai.request.reasoning_effort",
+  "brief": "Constrains the effort on reasoning for reasoning models. Supported values vary by provider.",
+  "type": "string",
+  "pii": {
+    "key": "false"
+  },
+  "is_in_otel": false,
+  "example": "high",
+  "changelog": [
+    {
+      "version": "next",
+      "prs": [334],
+      "description": "Added gen_ai.request.reasoning_effort attribute"
+    }
+  ]
+}

python/src/sentry_conventions/attributes.py

@@ -2604,6 +2604,18 @@ class ATTRIBUTE_NAMES(metaclass=_AttributeNamesMeta):
     Example: 0.5
     """
 
+    # Path: model/attributes/gen_ai/gen_ai__request__reasoning_effort.json
+    GEN_AI_REQUEST_REASONING_EFFORT: Literal["gen_ai.request.reasoning_effort"] = (
+        "gen_ai.request.reasoning_effort"
+    )
+    """Constrains the effort on reasoning for reasoning models. Supported values vary by provider.
+
+    Type: str
+    Contains PII: false
+    Defined in OTEL: No
+    Example: "high"
+    """
+
     # Path: model/attributes/gen_ai/gen_ai__request__seed.json
     GEN_AI_REQUEST_SEED: Literal["gen_ai.request.seed"] = "gen_ai.request.seed"
     """The seed, ideally models given the same seed and same other parameters will produce the exact same output.
@@ -9447,6 +9459,20 @@ class ATTRIBUTE_NAMES(metaclass=_AttributeNamesMeta):
             ChangelogEntry(version="0.1.0", prs=[57]),
         ],
     ),
+    "gen_ai.request.reasoning_effort": AttributeMetadata(
+        brief="Constrains the effort on reasoning for reasoning models. Supported values vary by provider.",
+        type=AttributeType.STRING,
+        pii=PiiInfo(isPii=IsPii.FALSE),
+        is_in_otel=False,
+        example="high",
+        changelog=[
+            ChangelogEntry(
+                version="next",
+                prs=[334],
+                description="Added gen_ai.request.reasoning_effort attribute",
+            ),
+        ],
+    ),
     "gen_ai.request.seed": AttributeMetadata(
         brief="The seed, ideally models given the same seed and same other parameters will produce the exact same output.",
         type=AttributeType.STRING,
@@ -13889,6 +13915,7 @@ class ATTRIBUTE_NAMES(metaclass=_AttributeNamesMeta):
         "gen_ai.request.messages": str,
         "gen_ai.request.model": str,
         "gen_ai.request.presence_penalty": float,
+        "gen_ai.request.reasoning_effort": str,
         "gen_ai.request.seed": str,
         "gen_ai.request.temperature": float,
         "gen_ai.request.top_k": int,