edits

Author: diberry

articles/ai-services/openai/includes/language-overview/javascript.md

@@ -25,18 +25,6 @@ Feature availability in Azure OpenAI is dependent on what version of the REST AP
 npm install openai
 ```
 
-## Configuration
-
-The `AzureClientOptions` object is used to configure the API client for interfacing with the Azure OpenAI API. The configuration object extends the existing OpenAi `ClientOptions` object. Below are the Azure OpenAI specific properties, their default values, and descriptions:
-
-| Property | Details |
-|--|--|
-| azureADTokenProvider: `(() => Promise<string>)` | A function that returns an access token for Microsoft Entra (formerly known as Azure Active Directory), invoked on every request.|
-| apiKey: `string` | Your API key for authenticating requests. Default environment variable is `AZURE_OPENAI_API_KEY`.|
-| apiVersion: `string` | Specifies the API version to use. Default environment variable is `OPENAI_API_VERSION` |
-| deployment: `string` | A model deployment. If provided, sets the base client URL to include `/deployments/{deployment}`. Non-deployment endpoints cannot be used (not supported with Assistants APIs).|
-| endpoint: `string` | Your Azure OpenAI endpoint.|
-
 ## Authentication
 
 # [Microsoft Entra ID](#tab/secure)
@@ -60,14 +48,27 @@ const endpoint = "https://your-azure-openai-resource.com";
 const apiVersion = "2024-10-21"
 const scope = "https://cognitiveservices.azure.com/.default";
 const azureADTokenProvider = getBearerTokenProvider(credential, scope);
+const deployment = "gpt-35-turbo";
 
 const client = new AzureOpenAI({ 
     endpoint, 
     apiVersion,
+    deployment,
     azureADTokenProvider
-     });
+});
 ```
 
+### Configuration
+
+The `AzureClientOptions` object extends the OpenAI `ClientOptions` object. This Azure-specific client object is used to configure the connection and behavior of the Azure OpenAI client. It includes properties for specifying the properties unique to Azure.
+
+| Property | Details |
+|--|--|
+| apiVersion: `string` | Specifies the API version to use. |
+| azureADTokenProvider: `(() => Promise<string>)` | A function that returns an access token for Microsoft Entra (formerly known as Azure Active Directory), invoked on every request.|
+| deployment: `string` | A model deployment. If provided, sets the base client URL to include `/deployments/{deployment}`. Non-deployment endpoints cannot be used (not supported with Assistants APIs).|
+| endpoint: `string` | Your Azure OpenAI endpoint with the following format: `https://RESOURCE-NAME.azure.openai.com/`.|
+
 # [API Key](#tab/api-key)
 
 API keys are not recommended for production use because they are less secure than other authentication methods. 
@@ -77,38 +78,29 @@ import { AzureKeyCredential } from "@azure/openai";
 const apiKey = new AzureKeyCredential("your API key");
 const endpoint = "https://your-azure-openai-resource.com";
 const apiVersion = "2024-10-21"
+const deployment = "gpt-35-turbo";
 
-const client = new AzureOpenAI({ apiKey, endpoint, apiVersion });
+const client = new AzureOpenAI({ 
+    apiKey, 
+    endpoint, 
+    apiVersion, 
+    deployment 
+});
 ```
 
-`AzureOpenAI` can be authenticated with an API key by setting the `AZURE_OPENAI_API_KEY` environment variable or by setting the `apiKey` string property in the [`AzureClientOptions`](#configuration) object when creating the `AzureOpenAI` client.
+The `AzureClientOptions` object extends the OpenAI `ClientOptions` object. This Azure-specific client object is used to configure the connection and behavior of the Azure OpenAI client. It includes properties for specifying the properties unique to Azure.
+
+| Property | Details |
+|--|--|
+| apiKey: `string` | Your API key for authenticating requests. |
+| apiVersion: `string` | Specifies the API version to use. |
+| deployment: `string` | A model deployment. If provided, sets the base client URL to include `/deployments/{deployment}`. Non-deployment endpoints cannot be used (not supported with Assistants APIs).|
+| endpoint: `string` | Your Azure OpenAI endpoint with the following format: `https://RESOURCE-NAME.azure.openai.com/`.|
 
 [!INCLUDE [Azure key vault](~/reusable-content/ce-skilling/azure/includes/ai-services/security/azure-key-vault.md)]
 
 ---
 
-## Description
-
-The `AzureClientOptions` object is used to configure the connection and behavior of the Azure Cosmos DB client. It includes properties for specifying the endpoint, authentication credentials, database and container names, consistency level, connection policy, and request timeout.
-
-### Example Usage
-
-```typescript
-import { CosmosClient, AzureClientOptions } from "@azure/cosmos";
-
-const options: AzureClientOptions = {
-  endpoint: process.env.AZURE_COSMOS_DB_ENDPOINT,
-  key: process.env.AZURE_COSMOS_DB_KEY,
-  databaseName: process.env.AZURE_COSMOS_DB_DATABASE,
-  containerName: process.env.AZURE_COSMOS_DB_CONTAINER,
-  aadCredentials: new DefaultAzureCredential(),
-  consistencyLevel: "Session",
-  connectionPolicy: { retryOptions: { maxRetryAttempts: 3 } },
-  timeout: 60000,
-};
-
-const client = new CosmosClient(options);
-```
 
 ## Audio