Merge branch 'main' of github.com:MicrosoftDocs/azure-ai-docs-pr into sdg-patches

Author: sdgilley

.openpublishing.redirection.json

@@ -282,7 +282,7 @@
     },
     {
       "source_path": "articles/ai-services/index.yml",
-      "redirect_url": "articles/azure/ai-foundry",
+      "redirect_url": "/azure/ai-foundry",
       "redirect_document_id": false
     }
   ]

articles/ai-foundry/concepts/fine-tuning-overview.md

@@ -348,6 +348,15 @@ The Stability AI collection of image generation models include Stable Image Core
 | [Stable Image Core](https://ai.azure.com/explore/models/Stable-Image-Core/version/1/registry/azureml-stabilityai) | Image generation | - **Input:** text (1000 tokens)  <br /> - **Output:** 1 Image  <br />  - **Tool calling:** No <br /> - **Response formats:** Image (PNG and JPG) |
 | [Stable Image Ultra](https://ai.azure.com/explore/models/Stable-Image-Ultra/version/1/registry/azureml-stabilityai) | Image generation | - **Input:** text (1000 tokens)  <br /> - **Output:** 1 Image  <br />  - **Tool calling:** No <br /> - **Response formats:** Image (PNG and JPG) |
 
+### xAI
+
+xAI's Grok 3 and Grok 3 Mini models are designed to excel in various enterprise domains. Grok 3, a non-reasoning model pre-trained by the Colossus datacenter, is tailored for business use cases such as data extraction, coding, and text summarization, with exceptional instruction-following capabilities. It supports a 131,072 token context window, allowing it to handle extensive inputs while maintaining coherence and depth, and is particularly adept at drawing connections across domains and languages. On the other hand, Grok 3 Mini is a lightweight reasoning model trained to tackle agentic, coding, mathematical, and deep science problems with test-time compute. It also supports a 131,072 token context window for understanding codebases and enterprise documents, and excels at using tools to solve complex logical problems in novel environments, offering raw reasoning traces for user inspection with adjustable thinking budgets.
+
+| Model  | Type | Capabilities |
+| ------ | ---- | ------------ |
+| [grok-3](https://ai.azure.com/explore/models/grok-3/version/1/registry/azureml-xai) | chat-completion | - **Input:** text (131,072 tokens) <br /> - **Output:** text (131,072 tokens) <br /> - **Languages:** `en` <br />  - **Tool calling:** yes <br /> - **Response formats:** text |
+| [grok-3-mini](https://ai.azure.com/explore/models/grok-3-mini/version/1/registry/azureml-xai) | chat-completion |  - **Input:** text (131,072 tokens) <br /> - **Output:** text (131,072 tokens) <br /> - **Languages:** `en` <br />  - **Tool calling:** yes <br /> - **Response formats:** text |
+
 #### Inference examples: Stability AI
 
 Stability AI models deployed via standard deployment implement the Foundry Models API on the route `/image/generations`.

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

@@ -35,17 +35,22 @@ Also, ensure you have administrative privileges to install software on your devi
 
 Get started with Foundry Local quickly:
 
-1. [**Download Foundry Local Installer**](https://aka.ms/foundry-local-installer) and **install** by following the on-screen prompts. 
-    > [!TIP]
-    > If you're installing on Windows, you can also use `winget` to install Foundry Local. Open a terminal window and run the following command:
-    >
-    > ```powershell
-    > winget install Microsoft.FoundryLocal
-    > ```
+1. **Install Foundry Local** 
+    - **Windows**: Open a terminal and run the following command:
+        ```bash
+        winget install Microsoft.FoundryLocal
+        ```
+    - **macOS**: Open a terminal and run the following command:
+        ```bash
+        brew tap microsoft/foundrylocal
+        brew install foundrylocal
+        ```
+    Alternatively, you can download the installer from the [Foundry Local GitHub repository](https://aka.ms/foundry-local-installer).
+
 1. **Run your first model** Open a terminal window and run the following command to run a model: 
 
     ```bash
-    foundry model run deepseek-r1-1.5b 
+    foundry model run phi-3.5-mini 
     ```
 
     The model downloads - which can take a few minutes, depending on your internet speed - and the model runs. Once the model is running, you can interact with it using the command line interface (CLI). For example, you can ask:
@@ -59,7 +64,7 @@ Get started with Foundry Local quickly:
 
 
 > [!TIP]
-> You can replace `deepseek-r1-1.5b` with any model name from the catalog (see `foundry model list` for available models). Foundry Local downloads the model variant that best matches your system's hardware and software configuration. For example, if you have an NVIDIA GPU, it downloads the CUDA version of the model. If you have a Qualcomm NPU, it downloads the NPU variant. If you have no GPU or NPU, it downloads the CPU version.
+> You can replace `phi-3.5-mini` with any model name from the catalog (see `foundry model list` for available models). Foundry Local downloads the model variant that best matches your system's hardware and software configuration. For example, if you have an NVIDIA GPU, it downloads the CUDA version of the model. If you have a Qualcomm NPU, it downloads the NPU variant. If you have no GPU or NPU, it downloads the CPU version.
 
 ## Explore commands
 

articles/ai-foundry/foundry-local/get-started.md

@@ -32,7 +32,7 @@ import { FoundryLocalManager } from "foundry-local-sdk";
 // to your end-user's device.
 // TIP: You can find a list of available models by running the 
 // following command in your terminal: `foundry model list`.
-const alias = "deepseek-r1-1.5b";
+const alias = "phi-3.5-mini";
 
 // Create a FoundryLocalManager instance. This will start the Foundry 
 // Local service if it is not already running.
@@ -83,7 +83,7 @@ import { FoundryLocalManager } from "foundry-local-sdk";
 // to your end-user's device.
 // TIP: You can find a list of available models by running the 
 // following command in your terminal: `foundry model list`.
-const alias = "deepseek-r1-1.5b";
+const alias = "phi-3.5-mini";
 
 // Create a FoundryLocalManager instance. This will start the Foundry 
 // Local service if it is not already running.
@@ -133,7 +133,7 @@ import { FoundryLocalManager } from "foundry-local-sdk";
 // to your end-user's device.
 // TIP: You can find a list of available models by running the 
 // following command in your terminal: `foundry model list`.
-const alias = "deepseek-r1-1.5b";
+const alias = "phi-3.5-mini";
 
 // Create a FoundryLocalManager instance. This will start the Foundry 
 // Local service if it is not already running.
@@ -176,7 +176,7 @@ import { FoundryLocalManager } from "foundry-local-sdk";
 // to your end-user's device.
 // TIP: You can find a list of available models by running the 
 // following command in your terminal: `foundry model list`.
-const alias = "deepseek-r1-1.5b";
+const alias = "phi-3.5-mini";
 
 // Create a FoundryLocalManager instance. This will start the Foundry 
 // Local service if it is not already running.

articles/ai-foundry/foundry-local/includes/integrate-examples/javascript.md

@@ -31,7 +31,7 @@ from foundry_local import FoundryLocalManager
 
 # By using an alias, the most suitable model will be downloaded 
 # to your end-user's device. 
-alias = "deepseek-r1-1.5b"
+alias = "phi-3.5-mini"
 
 # Create a FoundryLocalManager instance. This will start the Foundry
 # Local service if it is not already running and load the specified model.
@@ -66,7 +66,7 @@ from foundry_local import FoundryLocalManager
 
 # By using an alias, the most suitable model will be downloaded 
 # to your end-user's device.
-alias = "deepseek-r1-1.5b"
+alias = "phi-3.5-mini"
 
 # Create a FoundryLocalManager instance. This will start the Foundry 
 # Local service if it is not already running and load the specified model.
@@ -109,7 +109,7 @@ from foundry_local import FoundryLocalManager
 
 # By using an alias, the most suitable model will be downloaded 
 # to your end-user's device. 
-alias = "deepseek-r1-1.5b"
+alias = "phi-3.5-mini"
 
 # Create a FoundryLocalManager instance. This will start the Foundry
 # Local service if it is not already running and load the specified model.

articles/ai-foundry/foundry-local/includes/integrate-examples/python.md

@@ -92,7 +92,7 @@ import { FoundryLocalManager } from "foundry-local-sdk";
 // to your end-user's device.
 // TIP: You can find a list of available models by running the 
 // following command in your terminal: `foundry model list`.
-const alias = "deepseek-r1-1.5b";
+const alias = "phi-3.5-mini";
 
 const manager = new FoundryLocalManager()
 
@@ -141,7 +141,7 @@ import { FoundryLocalManager } from "foundry-local-sdk";
 // to your end-user's device.
 // TIP: You can find a list of available models by running the 
 // following command in your terminal: `foundry model list`.
-const alias = "deepseek-r1-1.5b";
+const alias = "phi-3.5-mini";
 
 // Create a FoundryLocalManager instance. This will start the Foundry 
 // Local service if it is not already running.
@@ -208,7 +208,7 @@ const endpoint = "ENDPOINT"
 
 const manager = new FoundryLocalManager({serviceUrl: endpoint})
 
-const alias = 'deepseek-r1-1.5b'
+const alias = 'phi-3.5-mini'
 
 // Get all available models
 const catalog = await manager.listCatalogModels()

articles/ai-foundry/foundry-local/includes/sdk-reference/javascript.md

@@ -86,7 +86,7 @@ from foundry_local import FoundryLocalManager
 
 # By using an alias, the most suitable model will be selected 
 # to your end-user's device.
-alias = "deepseek-r1-1.5b"
+alias = "phi-3.5-mini"
 
 # Create a FoundryLocalManager instance. This will start the Foundry.
 manager = FoundryLocalManager()
@@ -128,7 +128,7 @@ from foundry_local import FoundryLocalManager
 
 # By using an alias, the most suitable model will be downloaded 
 # to your end-user's device.
-alias = "deepseek-r1-1.5b"
+alias = "phi-3.5-mini"
 
 # Create a FoundryLocalManager instance. This will start the Foundry 
 # Local service if it is not already running and load the specified model.

articles/ai-foundry/foundry-local/includes/sdk-reference/python.md

@@ -313,7 +313,7 @@ Retrieves all available models, including both local models and registered exter
 
 - Response body
   ```json
-  ["Phi-4-mini-instruct-generic-cpu", " deepseek-r1-distill-qwen-7b-generic-cpu"]
+  ["Phi-4-mini-instruct-generic-cpu", "phi-3.5-mini-instruct-generic-cpu"]
   ```
 
 ### GET /openai/load/{name}
@@ -395,7 +395,7 @@ Retrieves a list of currently loaded models.
 
 - Response body
   ```json
-  ["Phi-4-mini-instruct-generic-cpu", " deepseek-r1-distill-qwen-7b-generic-cpu"]
+  ["Phi-4-mini-instruct-generic-cpu", "phi-3.5-mini-instruct-generic-cpu"]
   ```
 
 ### GET /openai/getgpudevice