Remove preview versions. Add examples.

Author: bojunehsu

specification/ai/ContentUnderstanding/audioVisualContent.tsp

@@ -28,7 +28,7 @@ model AudioVisualContent extends MediaContent {
   @doc("Height of each video frame in pixels, if applicable.")
   height?: int32;
 
-  @added(Versions.v2025_05_01_preview)
+  // @added(Versions.v2025_05_01_preview)
   @doc("List of camera shot changes in the video, represented by its timestamp in milliseconds.  Only if returnDetails is true.")
   cameraShotTimesMs?: int64[];
 
@@ -38,14 +38,14 @@ model AudioVisualContent extends MediaContent {
   @doc("List of transcript phrases.  Only if returnDetails is true.")
   transcriptPhrases?: TranscriptPhrase[];
 
-  @removed(Versions.v2025_05_01_preview)
-  @doc("List of faces in the video.  Only if enableFace and returnDetails are true.")
-  faces?: ImageFace[];
+  // @removed(Versions.v2025_05_01_preview)
+  // @doc("List of faces in the video.  Only if enableFace and returnDetails are true.")
+  // faces?: ImageFace[];
 
-  @added(Versions.v2025_05_01_preview)
-  @removed(Versions.v2025_11_01)
-  @doc("List of detected persons in the video.  Only if enableFace and returnDetails are true.")
-  persons?: DetectedPerson[];
+  // @added(Versions.v2025_05_01_preview)
+  // @removed(Versions.v2025_11_01)
+  // @doc("List of detected persons in the video.  Only if enableFace and returnDetails are true.")
+  // persons?: DetectedPerson[];
 
   @added(Versions.v2025_11_01)
   @doc("List of detected content segments.  Only if enableSegment is true.")
@@ -96,38 +96,39 @@ model TranscriptWord {
   span?: ContentSpan;
 }
 
-@added(Versions.v2025_05_01_preview)
-@removed(Versions.v2025_11_01)
-@doc("Audio visual segment, such as a scene, chapter, etc.")
-model AudioVisualSegment {
-  @doc("Segment ID.")
-  segmentId: string;
+// @added(Versions.v2025_05_01_preview)
+// @removed(Versions.v2025_11_01)
+// @doc("Audio visual segment, such as a scene, chapter, etc.")
+// model AudioVisualSegment {
+//   @doc("Segment ID.")
+//   segmentId: string;
 
-  @doc("Start time of the segment in milliseconds.")
-  startTimeMs: int64;
+//   @doc("Start time of the segment in milliseconds.")
+//   startTimeMs: int64;
 
-  @doc("End time of the segment in milliseconds.")
-  endTimeMs: int64;
+//   @doc("End time of the segment in milliseconds.")
+//   endTimeMs: int64;
 
-  @doc("Short description of the segment.")
-  description: string;
+//   @doc("Short description of the segment.")
+//   description: string;
 
-  @doc("Span of the segment in the markdown content.")
-  span?: ContentSpan;
-}
+//   @doc("Span of the segment in the markdown content.")
+//   span?: ContentSpan;
+// }
 
-@added(Versions.v2025_05_01_preview)
-@doc("Detected person.")
-model DetectedPerson {
-  @doc("Person identifier in the optional person directory if found.  Otherwise, each unknown person is assigned a unique `Person-{Number}`.")
-  personId?: string;
+// @added(Versions.v2025_05_01_preview)
+// @removed(Versions.v2025_11_01)
+// @doc("Detected person.")
+// model DetectedPerson {
+//   @doc("Person identifier in the optional person directory if found.  Otherwise, each unknown person is assigned a unique `Person-{Number}`.")
+//   personId?: string;
 
-  @doc("Confidence of the person identification, if a person directory is provided.")
-  confidence?: float32;
+//   @doc("Confidence of the person identification, if a person directory is provided.")
+//   confidence?: float32;
 
-  @doc("Encoded source that identifies the position of the person in the input content.")
-  source?: SourceExpression;
-}
+//   @doc("Encoded source that identifies the position of the person in the input content.")
+//   source?: SourceExpression;
+// }
 
 @added(Versions.v2025_11_01)
 @doc("Detected audio/visual content segment.")

specification/ai/ContentUnderstanding/client.tsp

@@ -16,20 +16,42 @@ namespace ClientCustomizations;
 interface ContentUnderstandingClient {
   // Flatten all ContentAnalyzers operations to client level
   // LRO operations will automatically get "begin_" prefix in Python
+
   analyze is ContentAnalyzers.analyze;
+
   analyzeBinary is ContentAnalyzers.analyzeBinary;
+
   copyAnalyzer is ContentAnalyzers.copy;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Doesn't fit standard naming"
   createAnalyzer is ContentAnalyzers.createOrReplace;
+
   deleteAnalyzer is ContentAnalyzers.delete;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Doesn't fit standard ops"
   deleteResult is ContentAnalyzers.deleteResult;
+
   getAnalyzer is ContentAnalyzers.get;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Doesn't fit standard ops"
   getDefaults is ContentAnalyzers.getDefaults;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Doesn't fit standard ops"
   getOperationStatus is ContentAnalyzers.getOperationStatus;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Doesn't fit standard ops"
   getResult is ContentAnalyzers.getResult;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Doesn't fit standard ops"
   getResultFile is ContentAnalyzers.getResultFile;
+
   grantCopyAuthorization is ContentAnalyzers.grantCopyAuthorization;
+
   listAnalyzers is ContentAnalyzers.list;
+
   updateAnalyzer is ContentAnalyzers.update;
+
+  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Doesn't fit standard ops"
   updateDefaults is ContentAnalyzers.updateDefaults;
 }
 
@@ -53,8 +75,6 @@ interface ContentUnderstandingClient {
 @@clientName(AnalyzeInput.range, "inputRange");
 @@clientName(AnalyzeBinaryRequest.range, "inputRange");
 
-//@@clientName(ContentFieldDefinition.$ref, "reference", "javascript");
-
 // Mark polling operations as internal - client generators automatically handle
 // the polling pattern for long-running operations. When users call analyze(), the
 // generated SDK returns a poller that internally uses these endpoints to check status
@@ -73,9 +93,3 @@ interface ContentUnderstandingClient {
   "getAnalyzers",
   "csharp"
 );
-
-// Client-only docs clarifying that these properties accept raw binary bytes (not base64 strings) in Python SDK.
-@@clientDoc(AnalyzeInput.data,
-  "Raw image bytes. Provide bytes-like object; do not base64-encode. Only one of url or data should be specified.",
-  DocumentationMode.replace
-);

specification/ai/ContentUnderstanding/documentContent.tsp

@@ -42,9 +42,10 @@ model DocumentContent extends MediaContent {
   @doc("List of figures in the document.  Only if enableLayout and returnDetails are true.")
   figures?: DocumentFigure[];
 
-  @added(Versions.v2025_05_01_preview)
-  @doc("List of detected persons in the document.  Only if enableFace and returnDetails are true.")
-  persons?: DetectedPerson[];
+  // @added(Versions.v2025_05_01_preview)
+  // @removed(Versions.v2025_11_01)
+  // @doc("List of detected persons in the document.  Only if enableFace and returnDetails are true.")
+  // persons?: DetectedPerson[];
 
   @added(Versions.v2025_11_01)
   @doc("List of annotations in the document.  Only if enableAnnotations and returnDetails are true.")
@@ -488,18 +489,18 @@ union DocumentTableCellKind {
   description: "description",
 }
 
-@removed(Versions.v2025_05_01_preview)
-@doc("Face in an image.")
-model ImageFace {
-  @doc("Face identifier.")
-  faceId?: string;
+// @removed(Versions.v2025_05_01_preview)
+// @doc("Face in an image.")
+// model ImageFace {
+//   @doc("Face identifier.")
+//   faceId?: string;
 
-  @doc("Confidence of predicting the face.")
-  confidence?: float32;
+//   @doc("Confidence of predicting the face.")
+//   confidence?: float32;
 
-  @doc("Encoded source that identifies the position of the face in the content.")
-  source?: SourceExpression;
-}
+//   @doc("Encoded source that identifies the position of the face in the content.")
+//   source?: SourceExpression;
+// }
 
 @added(Versions.v2025_11_01)
 @doc("Annotation in a document, such as a strikethrough or a comment.")

specification/ai/data-plane/ContentUnderstanding/preview/2025-05-01-preview/examples/ContentAnalyzers_Analyze.json renamed to specification/ai/ContentUnderstanding/examples/2025-11-01/ContentAnalyzers_Analyze.json

@@ -2,16 +2,20 @@
   "title": "Analyze URL",
   "operationId": "ContentAnalyzers_Analyze",
   "parameters": {
-    "api-version": "2025-05-01-preview",
+    "api-version": "2025-11-01",
     "analyzerId": "myAnalyzer",
     "body": {
-      "url": "https://host.com/doc.pdf"
+      "inputs": [
+        {
+          "url": "https://host.com/doc.pdf"
+        }
+      ]
     }
   },
   "responses": {
     "202": {
       "headers": {
-        "Operation-Location": "https://myendpoint.cognitiveservices.azure.com/contentunderstanding/analyzerResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-05-01-preview"
+        "Operation-Location": "https://myendpoint.cognitiveservices.azure.com/contentunderstanding/analyzerResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-11-01"
       },
       "body": {
         "id": "3b31320d-8bab-4f88-b19c-2322a7f11034",

specification/ai/data-plane/ContentUnderstanding/preview/2025-05-01-preview/examples/ContentAnalyzers_AnalyzeBinary.json renamed to specification/ai/ContentUnderstanding/examples/2025-11-01/ContentAnalyzers_AnalyzeBinary.json

@@ -2,14 +2,14 @@
   "title": "Analyze File",
   "operationId": "ContentAnalyzers_AnalyzeBinary",
   "parameters": {
-    "api-version": "2025-05-01-preview",
+    "api-version": "2025-11-01",
     "analyzerId": "myAnalyzer",
     "input": "RXhhbXBsZSBGaWxl"
   },
   "responses": {
     "202": {
       "headers": {
-        "Operation-Location": "https://myendpoint.cognitiveservices.azure.com/contentunderstanding/analyzerResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-05-01-preview"
+        "Operation-Location": "https://myendpoint.cognitiveservices.azure.com/contentunderstanding/analyzerResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-11-01"
       },
       "body": {
         "id": "3b31320d-8bab-4f88-b19c-2322a7f11034",

specification/ai/ContentUnderstanding/examples/2025-11-01/ContentAnalyzers_Copy.json

@@ -0,0 +1,44 @@
+{
+  "title": "Copy Analyzer",
+  "operationId": "ContentAnalyzers_Copy",
+  "parameters": {
+    "api-version": "2025-11-01",
+    "analyzerId": "targetAnalyzer",
+    "body": {
+      "sourceAzureResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/myResource",
+      "sourceRegion": "westus2",
+      "sourceAnalyzerId": "sourceAnalyzer"
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Operation-Location": "https://myendpoint.cognitiveservices.azure.com/contentunderstanding/analyzers/targetAnalyzer/operations/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-11-01"
+      },
+      "body": {
+        "analyzerId": "targetAnalyzer",
+        "description": "My analyzer",
+        "status": "creating",
+        "createdAt": "2025-05-01T18:46:36.051Z",
+        "lastModifiedAt": "2025-05-01T18:46:36.051Z",
+        "baseAnalyzerId": "prebuilt-document",
+        "config": {
+          "enableOcr": true,
+          "enableLayout": true,
+          "returnDetails": true
+        },
+        "fieldSchema": {
+          "name": "MyForm",
+          "description": "My form",
+          "fields": {
+            "Company": {
+              "type": "string",
+              "description": "Name of company."
+            }
+          },
+          "definitions": {}
+        }
+      }
+    }
+  }
+}