Merge pull request #293045 from MicrosoftDocs/main

1/14/2025 PM Publish

Author: Taojunshen

articles/api-management/set-edit-policies.md

@@ -221,7 +221,7 @@ To modify the policy evaluation order using the policy editor:
 
     > [!NOTE]
     > * You can place the `base` element before or after any policy element in a section.
-    > * If you want to prevent inheriting policies from the parent scope, remove the `base` element. In most cases, this isn't recommended.
+    > * If you want to prevent inheriting policies from the parent scope, remove the `base` element. In most cases, this isn't recommended. However, it may be useful in certain situations, such as when you want to apply different policies to a specific operation than are configured for the API (all operations) scope.
 
 1. Continue to configure the `base` element in policy definitions at successively broader scopes.
 

articles/azure-app-configuration/quickstart-feature-flag-spring-boot.md

@@ -85,15 +85,28 @@ To create a new Spring Boot project:
 ## Connect to an App Configuration store
 
 
-1. Navigate to the `resources` directory of your app and open `bootstrap.properties`. If the file does not exist, create it. Add the following line to the file.
+1. Navigate to the `resources` directory of your app and open the `bootstrap.properties` or `bootstrap.yaml` file. If the file does not exist, create it. Add the following line to the file.
 
     ### [Microsoft Entra ID (recommended)](#tab/entra-id)
     You use the `DefaultAzureCredential` to authenticate to your App Configuration store. Follow the [instructions](./concept-enable-rbac.md#authentication-with-token-credentials) to assign your credential the **App Configuration Data Reader** role. Be sure to allow sufficient time for the permission to propagate before running your application. Create a new file named *AppConfigCredential.java* and add the following lines:
 
-    ```properties
+   If you are using a properties file, use the following code:
+   ```properties
     spring.cloud.azure.appconfiguration.stores[0].endpoint= ${APP_CONFIGURATION_ENDPOINT}
     spring.cloud.azure.appconfiguration.stores[0].feature-flags.enabled=true
     ```
+    
+    If you are using a yaml file, use the following code:
+    ```yaml
+    spring:
+      cloud:
+        azure:
+          appconfiguration:
+            stores[0]:
+              feature-flags:
+                enabled: 'true'
+              connection-string: ${APP_CONFIGURATION_CONNECTION_STRING}
+    ```
 
     Additionally, you need to add the following code to your project, unless you want to use Managed Identity:
 
@@ -122,10 +135,23 @@ To create a new Spring Boot project:
     ```
 
     ### [Connection string](#tab/connection-string)
-    ```properties
+   If you are using a properties file, use the following code:
+   ```properties
     spring.cloud.azure.appconfiguration.stores[0].endpoint= ${APP_CONFIGURATION_CONNECTION_STRING}
     spring.cloud.azure.appconfiguration.stores[0].feature-flags.enabled=true
     ```
+
+   If you are using a yaml file, use the following code:
+    ```yaml
+    spring:
+      cloud:
+        azure:
+          appconfiguration:
+            stores[0]:
+              feature-flags:
+                enabled: 'true'
+              connection-string: ${APP_CONFIGURATION_CONNECTION_STRING}
+    ```
     ---
 
 1. Set an environment variable.

articles/azure-functions/functions-bindings-openai-assistant-trigger.md

@@ -10,7 +10,7 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/24/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
 
@@ -40,21 +40,17 @@ This example demonstrates how to create an assistant that adds a new todo task t
 :::code language="java" source="~/functions-openai-extension/samples/assistant/java/src/main/java/com/azfs/AssistantSkills.java" range="27-43":::
 
 ::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript"
+This example demonstrates how to create an assistant that adds a new todo task to a database. The trigger has a static description of `Create a new todo task` used by the model. The function itself takes a string, which represents a new task to add. When executed, the function adds the task as a new todo item in a custom item store and returns a response from the store. 
+::: zone-end
 ::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
-{{This comes from the example code comment}} 
 
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.ts}}" range="{{named is better than range}}":::
+:::code language="javascript" source="~/functions-openai-extension/samples/assistant/javascript/src/functions/assistantSkills.js" range="4-25":::
 
-{{Add more examples if available}}
--->
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
 
-This example demonstrates how to create an assistant that adds a new todo task to a database. The trigger has a static description of `Create a new todo task` used by the model. The function itself takes a string, which represents a new task to add. When executed, the function adds the task as a new todo item in a custom item store and returns a response from the store. 
-
-:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantSkills.ts" range="9-24" :::
+:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantSkills.ts" range="4-24" :::
 
 ::: zone-end  
 ::: zone pivot="programming-language-powershell"  

articles/azure-functions/functions-bindings-openai-assistantcreate-output.md

@@ -10,7 +10,7 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/20/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
 
@@ -35,26 +35,20 @@ This example demonstrates the creation process, where the HTTP PUT function that
 ::: zone pivot="programming-language-java"
 This example demonstrates the creation process, where the HTTP PUT function that creates a new assistant chat bot with the specified ID. The response to the prompt is returned in the HTTP response.  
 
-:::code language="java" source="~/functions-openai-extension/samples/assistant/java/src/main/java/com/azfs/AssistantApis.java" range="33-58":::
-
+:::code language="java" source="~/functions-openai-extension/samples/assistant/java/src/main/java/com/azfs/AssistantApis.java" range="33-58":::  
 
+::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript"  
+This example demonstrates the creation process, where the HTTP PUT function that creates a new assistant chat bot with the specified ID. The response to the prompt is returned in the HTTP response.  
 ::: zone-end  
 ::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
 
-{{This comes from the example code comment}} 
+:::code language="javascript" source="~/functions-openai-extension/samples/assistant/javascript/src/functions/assistantApis.js" range="6-33" :::
 
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.js}}" range="{{named is better than range}}":::
-
-{{Add more examples if available}}
--->
-::: zone-end  
+::: zone-end 
 ::: zone pivot="programming-language-typescript"
 
-This example demonstrates the creation process, where the HTTP PUT function that creates a new assistant chat bot with the specified ID. The response to the prompt is returned in the HTTP response.  
-
-:::code language="javascript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantApis.ts" range="7-29" :::
+:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantApis.ts" range="4-33" :::
 
 ::: zone-end  
 ::: zone pivot="programming-language-powershell"  

articles/azure-functions/functions-bindings-openai-assistantpost-input.md

@@ -10,7 +10,7 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/20/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
 
@@ -38,24 +38,19 @@ This example demonstrates the creation process, where the HTTP POST function tha
 
 :::code language="java" source="~/functions-openai-extension/samples/assistant/java/src/main/java/com/azfs/AssistantApis.java" range="83-103":::
 
+::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript" 
+This example demonstrates the creation process, where the HTTP POST function that sends user prompts to the assistant chat bot. The response to the prompt is returned in the HTTP response.
 ::: zone-end  
 ::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
-{{This comes from the example code comment}} 
-
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.js}}" range="{{named is better than range}}":::
+:::code language="javascript" source="~/functions-openai-extension/samples/assistant/javascript/src/functions/assistantApis.js" range="6-7,36-60":::
 
-{{Add more examples if available}}
--->
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
 
-This example demonstrates the creation process, where the HTTP POST function that sends user prompts to the assistant chat bot. The response to the prompt is returned in the HTTP response.
-
-:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantApis.ts" range="32-50":::
+:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantApis.ts" range="6-7,36-60":::
 
- ::: zone-end  
+::: zone-end  
 ::: zone pivot="programming-language-powershell"  
 
 This example demonstrates the creation process, where the HTTP POST function that sends user prompts to the assistant chat bot. The response to the prompt is returned in the HTTP response.

articles/azure-functions/functions-bindings-openai-assistantquery-input.md

@@ -10,7 +10,7 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/20/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
 
@@ -40,30 +40,26 @@ This example demonstrates the creation process, where the HTTP GET function that
 :::code language="java" source="~/functions-openai-extension/samples/assistant/java/src/main/java/com/azfs/AssistantApis.java" range="63-78":::
 
 
+::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript" 
+This example demonstrates the creation process, where the HTTP GET function that queries the conversation history of the assistant chat bot. The response to the prompt is returned in the HTTP response.
 ::: zone-end  
 ::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
-
-{{This comes from the example code comment}} 
 
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.js}}" range="{{named is better than range}}":::
+:::code language="javascript" source="~/functions-openai-extension/samples/assistant/javascript/src/functions/assistantApis.js" range="6-7,63-79":::  
 
-{{Add more examples if available}}
--->
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
 
 This example demonstrates the creation process, where the HTTP GET function that queries the conversation history of the assistant chat bot. The response to the prompt is returned in the HTTP response.
 
-:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantApis.ts" range="57-71":::
+:::code language="typescript" source="~/functions-openai-extension/samples/assistant/typescript/src/functions/assistantApis.ts" range="6-7,63-79":::
 
- ::: zone-end  
+::: zone-end  
 ::: zone pivot="programming-language-powershell"  
 
 This example demonstrates the creation process, where the HTTP GET function that queries the conversation history of the assistant chat bot. The response to the prompt is returned in the HTTP response.
 
-
 Here's the _function.json_ file for Get Chat State:
 
 :::code language="json" source="~/functions-openai-extension/samples/assistant/powershell/GetChatState/function.json" :::

articles/azure-functions/functions-bindings-openai-embeddings-input.md

@@ -10,7 +10,7 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/20/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
 
@@ -46,24 +46,30 @@ This example shows how to retrieve embeddings stored at a specified file that is
 :::code language="java" source="~/functions-openai-extension/samples/embeddings/java/src/main/java/com/azfs/EmbeddingsGenerator.java" range="61-90":::
 
 ::: zone-end  
-::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
-{{This comes from the example code comment}} 
+::: zone pivot="programming-language-javascript,programming-language-typescript" 
+This example shows how to generate embeddings for a raw text string.
+::: zone-end  
+::: zone pivot="programming-language-javascript"  
 
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.js}}" range="{{named is better than range}}":::
+:::code language="javascript" source="~/functions-openai-extension/samples/embeddings/javascript/src/app.js" range="3-31":::
 
-{{Add more examples if available}}
--->
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
+
+:::code language="typescript" source="~/functions-openai-extension/samples/embeddings/typescript/src/app.ts" range="3-31":::
+
+::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript" 
 This example shows how to generate embeddings for a raw text string.
+::: zone-end  
+::: zone pivot="programming-language-javascript"  
 
-:::code language="typescript" source="~/functions-openai-extension/samples/embeddings/typescript/src/app.ts" range="7-31":::
+:::code language="javascript" source="~/functions-openai-extension/samples/embeddings/javascript/src/app.js" range="29-54":::
 
-This example shows how to retrieve embeddings stored at a specified file that is accessible to the function.
+::: zone-end  
+::: zone pivot="programming-language-typescript"  
 
-:::code language="typescript" source="~/functions-openai-extension/samples/embeddings/typescript/src/app.ts" range="37-61":::
+:::code language="typescript" source="~/functions-openai-extension/samples/embeddings/typescript/src/app.ts" range="33-62":::
 
 ::: zone-end  
 ::: zone pivot="programming-language-powershell"  

articles/azure-functions/functions-bindings-openai-embeddingsstore-output.md

@@ -10,11 +10,10 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/20/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
-<!--- Question: It seems like this binding uses Azure AI Search and not Azure OpenAI. Do we need to rename the article to:
-"Azure AI Search semantic output binding" or something like that?-->
+
 # Azure OpenAI embeddings store output binding for Azure Functions
 
 [!INCLUDE [preview-support](../../includes/functions-openai-support-limitations.md)]
@@ -30,29 +29,26 @@ For information on setup and configuration details of the Azure OpenAI extension
 ::: zone pivot="programming-language-csharp"  
 This example writes an HTTP input stream to a semantic document store at the provided URL. 
 
-:::code language="csharp" source="~/functions-openai-extension/samples/rag-aisearch/csharp-ooproc/FilePrompt.cs" range="29-61"::: 
+:::code language="csharp" source="~/functions-openai-extension/samples/rag-aisearch/csharp-ooproc/FilePrompt.cs" range="29-70"::: 
 
 ::: zone-end  
 ::: zone pivot="programming-language-java"
 This example writes an HTTP input stream to a semantic document store at the provided URL. 
 
 :::code language="java" source="~/functions-openai-extension/samples/rag-aisearch/java/src/main/java/com/azfs/FilePrompt.java" range="24-68":::
 
+::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript" 
+This example writes an HTTP input stream to a semantic document store at the provided URL. 
 ::: zone-end  
 ::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
-{{This comes from the example code comment}} 
 
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.js}}" range="{{named is better than range}}":::
+:::code language="javascript" source="~/functions-openai-extension/samples/rag-aisearch/javascript/src/app.js" range="5-37":::
 
-{{Add more examples if available}}
--->
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
-This example writes an HTTP input stream to a semantic document store at the provided URL. 
 
-:::code language="typescript" source="~/functions-openai-extension/samples/embeddings/typescript/src/app.ts" range="7-38":::
+:::code language="typescript" source="~/functions-openai-extension/samples/rag-aisearch/typescript/src/app.ts" range="4-40":::
 
 ::: zone-end  
 ::: zone pivot="programming-language-powershell"  

articles/azure-functions/functions-bindings-openai-semanticsearch-input.md

@@ -10,7 +10,7 @@ ms.custom:
   - devx-track-ts
 ms.collection: 
   - ce-skilling-ai-copilot
-ms.date: 05/08/2024
+ms.date: 01/07/2025
 zone_pivot_groups: programming-languages-set-functions
 ---
 # Azure OpenAI Semantic Search Input Binding for Azure Functions
@@ -32,31 +32,24 @@ This example shows how to perform a semantic search on a file.
 
 ::: zone-end  
 ::: zone pivot="programming-language-java"
-
-This example shows how to perform a semantic search on a file.
-
+This example shows how to perform a semantic search on a file.  
 
 :::code language="java" source="~/functions-openai-extension/samples/rag-aisearch/java/src/main/java/com/azfs/FilePrompt.java" range="70-84":::
 
+::: zone-end  
+::: zone pivot="programming-language-javascript,programming-language-typescript" 
+This example shows how to perform a semantic search on a file.
 ::: zone-end  
 ::: zone pivot="programming-language-javascript"
-[!INCLUDE [functions-examples-not-available-note](../../includes/functions-examples-not-available-note.md)]
-<!---uncomment when code example is available:
-{{This comes from the example code comment}} 
 
-:::code language="javascript" source="~/functions-openai-extension/samples/{{link to the correct sample.js}}" range="{{named is better than range}}":::
+:::code language="javascript" source="~/functions-openai-extension/samples/rag-aisearch/javascript/src/app.js" range="39-57":::
 
-{{Add more examples if available}}
--->
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"
 
-This example shows how to perform a semantic search on a file.
+:::code language="typescript" source="~/functions-openai-extension/samples/rag-aisearch/typescript/src/app.ts" range="42-60":::
 
-:::code language="typescript" source="~/functions-openai-extension/samples/embeddings/typescript/src/app.ts" range="40-58":::
-
-
- ::: zone-end  
+::: zone-end  
 ::: zone pivot="programming-language-powershell"  
 
 This example shows how to perform a semantic search on a file.