Merge branch 'main' of https://github.com/microsoftdocs/azure-ai-docs-pr into endpoints

Author: v-thepet

articles/ai-services/cognitive-services-container-support.md

@@ -7,7 +7,7 @@ author: aahill
 manager: nitinme
 ms.service: azure-ai-services
 ms.topic: overview
-ms.date: 08/23/2024
+ms.date: 09/25/2024
 ms.author: aahi
 keywords: on-premises, Docker, container, Kubernetes
 #Customer intent: As a potential customer, I want to know more about how Azure AI services provides and supports Docker containers for each service.

articles/ai-services/content-safety/quickstart-protected-material-code.md

@@ -50,7 +50,7 @@ curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMat
 --header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-  "code": "to everyone, the best things in life are free. the stars belong to everyone, they gleam there for you and me. the flowers in spring, the robins that sing, the sunbeams that shine"
+  "code": "python import pygame pygame.init() win = pygame.display.set_mode((500, 500)) pygame.display.set_caption(My Game) x = 50 y = 50 width = 40 height = 60 vel = 5 run = True while run: pygame.time.delay(100) for event in pygame.event.get(): if event.type == pygame.QUIT: run = False keys = pygame.key.get_pressed() if keys[pygame.K_LEFT] and x > vel: x -= vel if keys[pygame.K_RIGHT] and x < 500 - width - vel: x += vel if keys[pygame.K_UP] and y > vel: y -= vel if keys[pygame.K_DOWN] and y < 500 - height - vel: y += vel win.fill((0, 0, 0)) pygame.draw.rect(win, (255, 0, 0), (x, y, width, height)) pygame.display.update() pygame.quit()"
 }'
 ```
 The below fields must be included in the url:
@@ -120,4 +120,4 @@ If you want to clean up and remove an Azure AI services subscription, you can de
 ## Related content
 
 * [Protected material detection concepts](./concepts/protected-material.md)
-* Configure filters for each category and test on datasets using [Content Safety Studio](studio-quickstart.md), export the code and deploy.
+* Configure filters for each category and test on datasets using [Content Safety Studio](studio-quickstart.md), export the code and deploy.

articles/ai-services/openai/assistants-reference-messages.md

@@ -5,9 +5,9 @@ description: Learn how to use Azure OpenAI's Python & REST API messages with Ass
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 07/25/2024
-author: mrbullwinkle
-ms.author: mbullwin
+ms.date: 09/25/2024
+author: aahill
+ms.author: aahi
 recommendations: false
 ms.custom: devx-track-python
 ---

articles/ai-services/openai/how-to/use-your-data-securely.md

@@ -8,7 +8,7 @@ ms.service: azure-ai-openai
 ms.topic: how-to
 author: aahill
 ms.author: aahi
-ms.date: 07/15/2024
+ms.date: 09/24/2024
 recommendations: false
 ---
 
@@ -83,6 +83,11 @@ If you are using a published [web app](./use-web-app.md), you need to redeploy i
 
 When using the API, pass the `filter` parameter in each API request. For example:
 
+> [!IMPORTANT]
+> The following is for example only. If you use an API key, store it securely somewhere else, such as in [Azure Key Vault](/azure/key-vault/general/overview). Don't include the API key directly in your code, and never post it publicly.
+
+For more information about AI services security, see [Authenticate requests to Azure AI services](/azure/ai-services/authentication).
+
 ```json
 {
     "messages": [
@@ -91,13 +96,13 @@ When using the API, pass the `filter` parameter in each API request. For example
             "content": "who is my manager?"
         }
     ],
-    "dataSources": [
+    "data_sources": [
         {
-            "type": "AzureCognitiveSearch",
+            "type": "azure_search",
             "parameters": {
-                "endpoint": "'$AZURE_AI_SEARCH_ENDPOINT'",
-                "key": "'$AZURE_AI_SEARCH_API_KEY'",
-                "indexName": "'$AZURE_AI_SEARCH_INDEX'",
+                "endpoint": "<AZURE_AI_SEARCH_ENDPOINT>",
+                "key": "<AZURE_AI_SEARCH_API_KEY>",
+                "index_name": "<AZURE_AI_SEARCH_INDEX>",
                 "filter": "my_group_ids/any(g:search.in(g, 'group_id1, group_id2'))"
             }
         }
@@ -152,13 +157,13 @@ To set the managed identities via the management API, see [the management API re
 ```json
 
 "identity": {
-  "principalId": "12345678-abcd-1234-5678-abc123def",
-  "tenantId": "1234567-abcd-1234-1234-abcd1234",
+  "principalId": "<YOUR-PRINCIPAL-ID>",
+  "tenantId": "<YOUR-TENNANT-ID>",
   "type": "SystemAssigned, UserAssigned", 
   "userAssignedIdentities": {
-    "/subscriptions/1234-5678-abcd-1234-1234abcd/resourceGroups/my-resource-group",
-    "principalId": "12345678-abcd-1234-5678-abcdefg1234", 
-    "clientId": "12345678-abcd-efgh-1234-12345678"
+    "/subscriptions/<YOUR-SUBSCIRPTION-ID>/resourceGroups/my-resource-group",
+    "principalId": "<YOUR-PRINCIPAL-ID>", 
+    "clientId": "<YOUR-CLIENT-ID>"
   }
 }
 ```

articles/ai-services/openai/references/cosmos-db.md

@@ -5,7 +5,7 @@ description: Learn how to use Azure OpenAI on your Azure Cosmos DB data Python &
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 03/12/2024
+ms.date: 09/24/2024
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -93,10 +93,14 @@ Prerequisites:
 * Configure the role assignments from the user to the Azure OpenAI resource. Required role: `Cognitive Services OpenAI User`.
 * Install [Az CLI](/cli/azure/install-azure-cli) and run `az login`.
 * Define the following environment variables: `AzureOpenAIEndpoint`, `ChatCompletionsDeploymentName`,`ConnectionString`, `Database`, `Container`, `Index`, `EmbeddingDeploymentName`.
+
+> [!NOTE]
+> The following is for example only. If you use a connection string, store it securely somewhere else, such as in [Azure Key Vault](/azure/key-vault/general/overview). Don't include the API key directly in your code, and never post it publicly.
+
 ```bash
 export AzureOpenAIEndpoint=https://example.openai.azure.com/
 export ChatCompletionsDeploymentName=turbo
-export ConnectionString='mongodb+srv://username:***@example.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000'
+export ConnectionString='<db-connection-string>'
 export Database=testdb
 export Container=testcontainer
 export Index=testindex

articles/ai-studio/.openpublishing.redirection.ai-studio.json

@@ -119,6 +119,16 @@
             "source_path": "articles/ai-studio/how-to/commitment-tier.md",
             "redirect_url": "/azure/ai-services/commitment-tier.md",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/ai-studio/how-to/develop/flow-evaluate-sdk.md",
+            "redirect_url": "/azure/ai-studio/how-to/develop/evaluate-sdk",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/ai-studio/how-to/evaluate-flow-results.md",
+            "redirect_url": "/azure/ai-studio/how-to/evaluate-results",
+            "redirect_document_id": true
         }
     ]
 }

articles/ai-studio/concepts/evaluation-approach-gen-ai.md

@@ -101,5 +101,5 @@ After assessing your applications, flows, or data from any of these channels, yo
 
 - [Evaluate your generative AI apps via the playground](../how-to/evaluate-prompts-playground.md)
 - [Evaluate your generative AI apps with the Azure AI Studio or SDK](../how-to/evaluate-generative-ai-app.md)
-- [View the evaluation results](../how-to/evaluate-flow-results.md)
+- [View the evaluation results](../how-to/evaluate-results.md)
 - [Transparency Note for Azure AI Studio safety evaluations](safety-evaluations-transparency-note.md)

articles/ai-studio/concepts/evaluation-improvement-strategies.md

@@ -139,4 +139,4 @@ We recommend implementing the following user-centered design and user experience
 
 - [Evaluate your generative AI apps via the playground](../how-to/evaluate-prompts-playground.md)
 - [Evaluate your generative AI apps with the Azure AI Studio or SDK](../how-to/evaluate-generative-ai-app.md)
-- [View the evaluation results](../how-to/evaluate-flow-results.md)
+- [View the evaluation results](../how-to/evaluate-results.md)