Merge pull request #5787 from MicrosoftDocs/main

Merged by Learn.Build PR Management system

Author: learn-build-service-prod[bot]

articles/ai-foundry/foundry-local/reference/reference-best-practice.md

@@ -47,6 +47,7 @@ Foundry Local is designed for on-device inference and *not* distributed, contain
 | Model download failures | Network connectivity issues | Check your internet connection and run `foundry cache list` to verify cache status |
 | The service fails to start | Port conflicts or permission issues | Try `foundry service restart` or [report an issue](https://github.com/microsoft/Foundry-Local/issues) with logs using `foundry zip-logs` |
 | Qualcomm NPU error (`Qnn error code 5005: "Failed to load from EpContext model. qnn_backend_manager."`) | Qualcomm NPU error | Under investigation |
+| `winget install Microsoft.FoundryLocal --scope machine` fails with “The current system configuration does not support the installation of this package.” | Winget blocks MSIX machine-scope installs due to an OS bug when using provisioning APIs from a packaged context | Use `Add-AppxProvisionedPackage` instead. Download the `.msix` and its dependency, then run in **elevated** PowerShell: `Add-AppxProvisionedPackage -Online -PackagePath .\FoundryLocal.msix -DependencyPackagePath .\VcLibs.appx -SkipLicense`. This installs Foundry Local for all users.|
 
 ### Improving performance
 
@@ -56,4 +57,4 @@ If you experience slow inference, consider the following strategies:
 - Use GPU acceleration when available
 - Identify bottlenecks by monitoring memory usage during inference.
 - Try more quantized model variants (like INT8 instead of FP16)
-- Adjust batch sizes for non-interactive workloads
+- Adjust batch sizes for non-interactive workloads

articles/ai-foundry/foundry-models/concepts/models.md

@@ -229,4 +229,4 @@ Those models can be of open access or IP protected. In both cases, you have to d
 
 ## Next steps
 
-- Get started today and [deploy your fist model in Azure AI Foundry Models](../../model-inference/how-to/create-model-deployments.md)
+- Get started today and [deploy your first model in Azure AI Foundry Models](../../model-inference/how-to/create-model-deployments.md)

articles/ai-foundry/includes/clean-up-resources.md

@@ -0,0 +1,15 @@
+---
+title: Include file
+description: Include file
+author: sdgilley
+ms.reviewer: sgilley
+ms.author: sgilley
+ms.service: azure-ai-foundry
+ms.topic: include
+ms.date: 06/30/2025
+ms.custom: include
+---
+
+If you no longer need any of the resources you created, delete the resource group associated with your project.
+
+In the Azure AI Foundry portal, select your project name in the top right corner. Then select the link for the resource group to open it in the Azure portal. Select the resource group, and then select **Delete**. Confirm that you want to delete the resource group.

articles/ai-foundry/includes/create-project-access.md

@@ -18,6 +18,6 @@ What you do next depends on where you are:
 
     :::image type="content" source="../media/how-to/projects/create-new-resource.png" alt-text="Screenshot shows creating a new project from a breadcrumb.":::
 
-* **If you're not in a project**: Select **Create new** in the top right to create a new [!INCLUDE [fdp-project-name-plural](fdp-project-name.md)]
+* **If you're not in a project**: Select **Create new** in the top right to create a new [!INCLUDE [fdp-project-name](fdp-project-name.md)]
 
     :::image type="content" source="../media/how-to/projects/create-new.png" alt-text="Screenshot shows how to create a new project in Azure AI Foundry.":::

articles/ai-foundry/includes/create-second-fdp-project.md

@@ -16,9 +16,9 @@ ms.custom:
 ---
 
 
-Create multiple [!INCLUDE [fdp-project-name-plural](fdp-project-name-plural.md)] on an existing `AI Foundry` resource, so you can share your environment with your team for collaboration. 
+Create multiple [!INCLUDE [fdp-project-name](fdp-project-name.md)]s on an existing `AI Foundry` resource, so you can share your environment with your team for collaboration. 
 
-[!INCLUDE [fdp-project-name-plural](fdp-project-name-plural.md)] as Azure child resources may get assigned their own access controls, but share common settings such as network security, deployments, and Azure tool integration from their parent resource.
+[!INCLUDE [fdp-project-name](fdp-project-name.md)]s as Azure child resources may get assigned their own access controls, but share common settings such as network security, deployments, and Azure tool integration from their parent resource.
 
 Your first project (default project) plays a special role and has access to more features:
 

articles/ai-foundry/includes/fdp-project-name-plural.md

@@ -10,6 +10,7 @@ ms.custom:
   - include file
   - build-aifnd
   - build-2025
+  - update-code
 ---
 
 In this quickstart, you use [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs) to:
@@ -71,7 +72,16 @@ No installation is necessary to use the Azure AI Foundry portal.
 1. [!INCLUDE [find-endpoint](find-endpoint.md)]
 1. Set these environment variables to use in your scripts:
 
-    :::code language="plaintext" source="~/foundry-samples-main/samples/microsoft/java/mslearn-resources/quickstart/.env.template":::
+    <!-- :::code language="plaintext" source="~/foundry-samples-main/samples/microsoft/java/mslearn-resources/quickstart/.env.template"::: -->
+
+```txt
+AZURE_ENDPOINT=your_endpoint_here
+AZURE_DEPLOYMENT=your_deployment_name_here 
+# Project ID (Optional - will be generated if not provided)
+PROJECT_ID=your_project_id_here
+MODEL_DEPLOYMENT_NAME=gpt-4o
+```
+
 
 1. Make sure to sign in using the CLI `az login` (or `az login --use-device-code`) command to authenticate before running your Java scripts.
 1. Download [POM.XML](https://github.com/azure-ai-foundry/foundry-samples/blob/main/samples/microsoft/java/mslearn-resources/quickstart/pom.xml) to your Java IDE.
@@ -255,10 +265,9 @@ Replace `YOUR-FOUNDRY-RESOURCE-NAME` and `YOUR-PROJECT-NAME` with your values:
 
 ## Clean up resources
 
-If you no longer need them, delete the resource group associated with your project.
-
-In the Azure AI Foundry portal, select your project name in the top right corner. Then select the link for the resource group to open it in the Azure portal. Select the resource group, and then select **Delete**. Confirm that you want to delete the resource group.
+[!INCLUDE [clean-up-resources](clean-up-resources.md)]
 
-## Related content
+## Next step
 
-[Azure AI Foundry client library overview](../how-to/develop/sdk-overview.md)
+> [!div class="nextstepaction"]
+> [Azure AI Foundry client library overview](../how-to/develop/sdk-overview.md)

articles/ai-foundry/includes/get-started-fdp.md

@@ -6,7 +6,7 @@ author: sdgilley
 ms.author: sgilley
 manager: scottpolly
 ms.reviewer: dantaylo
-ms.date: 05/12/2025
+ms.date: 06/30/2025
 ms.service: azure-ai-foundry
 ms.topic: how-to
 ms.custom:
@@ -40,12 +40,15 @@ In this quickstart, we walk you through setting up your local development enviro
 
 1. [Set up your development environment](../how-to/develop/install-cli-sdk.md?pivots=programming-language-python)
 
-1. Make sure you install these packages:
+1. Install these packages.
 
     ```bash
-    pip install azure-ai-projects azure-ai-inference azure-identity 
+    pip install azure-ai-inference azure-identity azure-ai-projects==1.0.0b10
     ```
 
+    > [!NOTE]
+    > Different project types require different versions of the `azure-ai-projects` package. To avoid conflicts, create separate Python environments: use version `1.0.0b10` for [!INCLUDE [hub-project-name](../includes/hub-project-name.md)]s and the latest version for [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)]s.
+
 ## Deploy a model
 
 [!INCLUDE [tip-left-pane](../includes/tip-left-pane.md)]
@@ -117,6 +120,9 @@ Run the revised script to see the response from the model with this new input.
 python chat.py
 ```
 
+## Clean up resources
+
+[!INCLUDE [clean-up-resources](../includes/clean-up-resources.md)]
 
 ## Next step
 

articles/ai-foundry/quickstarts/get-started-code.md

@@ -6,6 +6,7 @@ manager: scottpolly
 ms.service: azure-ai-foundry
 ms.custom:
   - ignite-2024
+  - update-code
 ms.topic: tutorial
 ms.date: 06/27/2025
 ms.reviewer: lebaro

articles/ai-foundry/tutorials/copilot-sdk-create-resources.md

@@ -1364,6 +1364,11 @@
       "source_path_from_root": "/articles/ai-services/agents/whats-new.md",
       "redirect_url": "/azure/ai-foundry/agents/whats-new",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/language-service/question-answering/how-to/configure-resources.md",
+      "redirect_url": "/azure/ai-services/language-service/question-answering/how-to/configure-azure-resources",
+      "redirect_document_id": true
     }
   ]
 }