Merge pull request #1125 from MicrosoftDocs/main

10/29/2024 PM Publish

Author: Taojunshen

articles/ai-services/content-safety/overview.md

@@ -99,6 +99,15 @@ Currently, Azure AI Content Safety has an **F0** and **S0** pricing tier. See th
 
 ## Service limits
 
+> [!CAUTION]
+> **Deprecation Notice**
+>
+> As part of Content Safety versioning and lifecycle management, we are announcing the deprecation of certain Public Preview and GA versions of our service APIs. Following our deprecation policy:
+> * **Public Preview versions**: Each new Public Preview version will trigger the deprecation of the previous preview version after a 90-day period, provided no breaking changes are introduced.
+> * **GA versions**: When a new GA version is released, the prior GA version will be deprecated after a 90-day period if compatibility is maintained.
+>
+> See the [What's new](./whats-new.md) page for upcoming deprecations.
+
 ### Input requirements
 
 See the following list for the input requirements for each feature.

articles/ai-services/content-safety/whats-new.md

@@ -16,6 +16,13 @@ ms.author: pafarley
 
 Learn what's new in the service. These items might be release notes, videos, blog posts, and other types of information. Bookmark this page to stay up to date with new features, enhancements, fixes, and documentation updates.
 
+## October 2024
+
+### Upcoming deprecations
+
+To align with Content Safety versioning and lifecycle management policies, the following versions are scheduled for deprecation:
+* **Effective January 28, 2024**: All versions except `2024-09-01`, `2024-09-15-preview`, and `2024-09-30-preview` will be deprecated and no longer supported. We encourage users to transition to the latest available versions to continue receiving full support and updates. If you have any questions about this process or need assistance with the transition, please reach out to our support team.
+
 ## September 2024
 
 ### Multimodal analysis (preview)

articles/ai-services/document-intelligence/toc.yml

@@ -9,6 +9,9 @@ items:
     href: overview.md
   - name: Which model should I choose?
     href: concept/choose-model-feature.md
+  - name: Create a Document Intelligence resource
+    displayName: endpoint, key, portal
+    href:  how-to-guides/create-document-intelligence-resource.md  
   - name: Document Intelligence Studio
     displayName: get started
     href: studio-overview.md
@@ -138,9 +141,9 @@ items:
   - name: Custom model lifecycle
     displayName: custom, train, modelId, model ID, expiration, train, build
     href: train/custom-lifecycle.md
-- name: Features
+- name: Add-on features
   items:
-  - name: Add-on capabilities
+  - name: Enhanced capabilities
     displayName: extract, formula, font, styles, fontStyle, ocr.highResolution, ocr.formula, high resolution, background color, inline, display
     href: concept-add-on-capabilities.md
   - name: Query field extraction
@@ -176,9 +179,6 @@ items:
   - name: Use Document Intelligence models
     displayName: documentAnalysisClient, document analysis client, polygon, boundingPolygon, begin_analyze_document,ormRecognizerClient, Document Intelligence client, boundingBox, box, begin_recognize, v2.1
     href: how-to-guides/use-sdk-rest-api.md
-  - name: Create a Document Intelligence resource
-    displayName: endpoint, key, portal
-    href:  how-to-guides/create-document-intelligence-resource.md
   - name: 🆕 Build and train a custom generative model
     displayName: ai studio, neural, template, custom
     href: how-to-guides/build-train-custom-generative-model.md

articles/ai-services/openai/dall-e-quickstart.md

@@ -54,6 +54,12 @@ zone_pivot_groups: openai-quickstart-dall-e
 
 ::: zone-end
 
+::: zone pivot="programming-language-typescript"
+
+[!INCLUDE [TypeScript SDK quickstart](includes/dall-e-typescript.md)]
+
+::: zone-end
+
 ::: zone pivot="programming-language-go"
 
 [!INCLUDE [Go SDK quickstart](includes/dall-e-go.md)]

articles/ai-services/openai/gpt-v-quickstart.md

@@ -17,9 +17,10 @@ zone_pivot_groups: openai-quickstart-gpt-v
 
 Get started using GPT-4 Turbo with images with the Azure OpenAI Service.
 
-## GPT-4 Turbo model upgrade
-
-[!INCLUDE [GPT-4 Turbo](./includes/gpt-4-turbo.md)]
+> [!NOTE]
+> **Model choice**
+>
+> The latest vision-capable models are `gpt-4o` and `gpt-4o mini`. These are in public preview. The latest available GA model is `gpt-4` version `turbo-2024-04-09`.
 
 ::: zone pivot="programming-language-studio"
 
@@ -45,6 +46,12 @@ Get started using GPT-4 Turbo with images with the Azure OpenAI Service.
 
 ::: zone-end
 
+::: zone pivot="programming-language-typescript"
+
+[!INCLUDE [TypeScript quickstart](includes/gpt-v-typescript.md)]
+
+::: zone-end
+
 ::: zone pivot="programming-language-dotnet"
 
 [!INCLUDE [.NET quickstart](includes/gpt-v-dotnet.md)]

articles/ai-services/openai/includes/dall-e-javascript.md

@@ -8,7 +8,7 @@ ms.service: azure-ai-openai
 ms.topic: include
 author: PatrickFarley
 ms.author: pafarley
-ms.date: 09/06/2024
+ms.date: 10/23/2024
 ---
 
 Use this guide to get started generating images with the Azure OpenAI SDK for JavaScript.
@@ -17,22 +17,13 @@ Use this guide to get started generating images with the Azure OpenAI SDK for Ja
 
 ## Prerequisites
 
-#### [TypeScript](#tab/typescript)
 
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true)
 - [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
-- [TypeScript](https://www.typescriptlang.org/download/)
+- [Azure CLI](/cli/azure/install-azure-cli) used for passwordless authentication in a local development environment, create the necessary context by signing in with the Azure CLI.
 - An Azure OpenAI resource created in a supported region (see [Region availability](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability)). For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
 
 
-#### [JavaScript](#tab/javascript)
-
-- An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true)
-- [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
-- An Azure OpenAI resource created in a supported region (see [Region availability](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability)). For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
-
----
-
 ## Setup
 
 [!INCLUDE [get-key-endpoint](get-key-endpoint.md)]
@@ -62,15 +53,19 @@ Your app's _package.json_ file will be updated with the dependencies.
 
 Create a new file named _ImageGeneration.js_ and open it in your preferred code editor. Copy the following code into the _ImageGeneration.js_ file:
 
-#### [TypeScript](#tab/typescript)
 
-```typescript
-import "dotenv/config";
-import { AzureOpenAI } from "openai";
+
+#### [Microsoft Entra ID](#tab/javascript-keyless)
+
+```javascript
+const { AzureOpenAI } = require("openai");
+const { 
+    DefaultAzureCredential, 
+    getBearerTokenProvider 
+} = require("@azure/identity");
 
 // You will need to set these environment variables or edit the following values
 const endpoint = process.env["AZURE_OPENAI_ENDPOINT"];
-const apiKey = process.env["AZURE_OPENAI_API_KEY"];
 
 // Required Azure OpenAI deployment name and API version
 const apiVersion = "2024-07-01";
@@ -80,10 +75,15 @@ const deploymentName = "dall-e-3";
 const prompt = "a monkey eating a banana";
 const numberOfImagesToGenerate = 1;
 
+// keyless authentication    
+const credential = new DefaultAzureCredential();
+const scope = "https://cognitiveservices.azure.com/.default";
+const azureADTokenProvider = getBearerTokenProvider(credential, scope);
+
 function getClient(): AzureOpenAI {
   return new AzureOpenAI({
     endpoint,
-    apiKey,
+    azureADTokenProvider,
     apiVersion,
     deployment: deploymentName,
   });
@@ -111,23 +111,17 @@ main().catch((err) => {
 });
 ```
 
-1. Build the application with the following command:
-
-    ```console
-    tsc
-    ```
+Run the script with the following command:
 
-1. Run the application with the following command:
+```console
+node ImageGeneration.js
+```
 
-    ```console
-    node ImageGeneration.js
-    ```
 
 
-#### [JavaScript](#tab/javascript)
+#### [API key](#tab/javascript-key)
 
 ```javascript
-require("dotenv/config");
 const { AzureOpenAI } = require("openai");
 
 // You will need to set these environment variables or edit the following values
@@ -178,6 +172,7 @@ Run the script with the following command:
 ```console
 node ImageGeneration.js
 ```
+
 ---
 
 ## Output