Merge pull request #7475 from MicrosoftDocs/main

Auto Publish – main to live - 2025-10-05 22:00 UTC

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

.gitignore

@@ -21,4 +21,5 @@ _repo.*/
 .github/prompts/*.zip
 .github/patterns/*.md
 
-articles/ai-foundry/includes/get-started-fdp.md
+articles/ai-foundry/includes/get-started-fdp.md
+articles/ai-foundry/toc-files/setup-management/toc.yml

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

@@ -58,10 +58,10 @@ Get started fast with Foundry Local:
      winget install Microsoft.FoundryLocal
      ```
    - **macOS**: Open a terminal and run the following command:
-     `bash
-brew tap microsoft/foundrylocal
-brew install foundrylocal
-`
+     ```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 and run this command:

articles/ai-foundry/openai/api-version-lifecycle.md

@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-openai
 ms.topic: conceptual 
-ms.date: 10/01/2025
+ms.date: 10/06/2025
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -31,6 +31,7 @@ Starting in August 2025, you can now opt in to our next generation v1 Azure Open
 - Faster API release cycle with new features launching more frequently.
 - OpenAI client support with minimal code changes to swap between OpenAI and Azure OpenAI when using key-based authentication.
 - OpenAI client support for token based authentication and automatic token refresh without the need to take a dependency on a separate Azure OpenAI client.
+- Make chat completions calls with models from other providers like DeepSeek and Grok which support the v1 chat completions syntax.
 
 Access to new API calls that are still in preview will be controlled by passing feature specific preview headers allowing you to opt in to the features you want, without having to swap API versions. Alternatively, some features will indicate preview status through their API path and don't require an additional header.
 
@@ -271,70 +272,199 @@ curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/responses \
     }'
 ```
 
-# [Output](#tab/output)
-
-```json
-{
-  "id": "resp_682f7eb5dc408190b491cbbe57be2fbf0f98d661c3dc276d",
-  "created_at": 1747943093.0,
-  "error": null,
-  "incomplete_details": null,
-  "instructions": null,
-  "metadata": {},
-  "model": "gpt-4.1-nano",
-  "object": "response",
-  "output": [
-    {
-      "id": "msg_682f7eb61d908190926a004c15c5ddd00f98d661c3dc276d",
-      "content": [
-        {
-          "annotations": [],
-          "text": "Hello! It looks like you've sent a test message. How can I assist you today?",
-          "type": "output_text"
+---
+
+## Model support
+
+For Azure OpenAI models we recommend using the [Responses API](./supported-languages.md), however, the v1 API also allows you to make chat completions calls with models from other providers like DeepSeek and Grok which support the OpenAI v1 chat completions syntax.
+
+`base_url` will accept both `https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/` and `https://YOUR-RESOURCE-NAME.services.ai.azure.com/openai/v1/` formats.
+
+# [Python](#tab/python)
+
+```python
+from openai import OpenAI
+from azure.identity import DefaultAzureCredential, get_bearer_token_provider
+
+token_provider = get_bearer_token_provider(
+    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
+)
+
+client = OpenAI(  
+  base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",  
+  api_key=token_provider,
+)
+completion = client.chat.completions.create(
+  model="grok-3-mini", # Replace with your model deployment name.
+  messages=[
+    {"role": "system", "content": "You are a helpful assistant."},
+    {"role": "user", "content": "Tell me about the attention is all you need paper"}
+  ]
+)
+
+#print(completion.choices[0].message)
+print(completion.model_dump_json(indent=2))
+```
+
+# [C#](#tab/dotnet)
+
+```csharp
+using Azure.Identity;
+using OpenAI;
+using OpenAI.Chat;
+using System.ClientModel.Primitives;
+
+#pragma warning disable OPENAI001
+
+BearerTokenPolicy tokenPolicy = new(
+    new DefaultAzureCredential(),
+    "https://cognitiveservices.azure.com/.default");
+
+ChatClient client = new(
+    model: "grok-3-mini", // Replace with your model deployment name.
+    authenticationPolicy: tokenPolicy,
+    options: new OpenAIClientOptions() { 
+    
+        Endpoint = new Uri("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1")
+   }
+);
+
+ChatCompletion completion = client.CompleteChat("Tell me about the attention is all you need paper");
+
+Console.WriteLine($"[ASSISTANT]: {completion.Content[0].Text}");
+```
+
+# [JavaScript](#tab/javascript)
+
+```javascript
+import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";
+import { OpenAI } from "openai";
+
+const tokenProvider = getBearerTokenProvider(
+    new DefaultAzureCredential(),
+    'https://cognitiveservices.azure.com/.default');
+const client = new OpenAI({
+    baseURL: "https://france-central-test-001.openai.azure.com/openai/v1/",
+    apiKey: tokenProvider
+});
+
+const messages = [
+    { role: 'system', content: 'You are a helpful assistant.' },
+    { role: 'user', content: 'Tell me about the attention is all you need paper' }
+];
+
+// Make the API request with top-level await
+const result = await client.chat.completions.create({ 
+    messages, 
+    model: 'grok-3-mini', // model deployment name
+    max_tokens: 100 
+});
+
+// Print the full response
+console.log('Full response:', result);
+
+// Print just the message content from the response
+console.log('Response content:', result.choices[0].message.content);
+```
+
+# [Go](#tab/go)
+
+```go
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
+	"github.com/openai/openai-go/v2"
+	"github.com/openai/openai-go/v2/azure"
+	"github.com/openai/openai-go/v2/option"
+)
+
+func main() {
+	// Create an Azure credential
+	tokenCredential, err := azidentity.NewDefaultAzureCredential(nil)
+	if err != nil {
+		panic(fmt.Sprintf("Failed to create credential: %v", err))
+	}
+
+	// Create a client with Azure OpenAI endpoint and token credential
+	client := openai.NewClient(
+		option.WithBaseURL("https://YOUR-RESOURCE_NAME.openai.azure.com/openai/v1/"),
+		azure.WithTokenCredential(tokenCredential),
+	)
+
+	// Make a completion request
+	chatCompletion, err := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
+		Messages: []openai.ChatCompletionMessageParamUnion{
+			openai.UserMessage("Explain what the bitter lesson is?"),
+		},
+		Model: "grok-3-mini", // Use your deployed model name on Azure
+	})
+	if err != nil {
+		panic(err.Error())
+	}
+
+	fmt.Println(chatCompletion.Choices[0].Message.Content)
+}
+```
+
+# [Java](#tab/Java)
+
+```java
+package com.example;
+
+import com.openai.client.OpenAIClient;
+import com.openai.client.okhttp.OpenAIOkHttpClient;
+import com.openai.models.ChatModel;
+import com.openai.models.chat.completions.ChatCompletion;
+import com.openai.models.chat.completions.ChatCompletionCreateParams;
+
+public class OpenAITest {
+    public static void main(String[] args) {
+        // Get API key from environment variable for security
+        String apiKey = System.getenv("OPENAI_API_KEY");
+        String resourceName = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1";
+        String modelDeploymentName = "grok-3-mini"; //replace with you model deployment name
+
+        try {
+            OpenAIClient client = OpenAIOkHttpClient.builder()
+                    .baseUrl(resourceName)
+                    .apiKey(apiKey)
+                    .build();
+
+           ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
+              .addUserMessage("Explain what the bitter lesson is?")
+              .model(modelDeploymentName)
+              .build();
+           ChatCompletion chatCompletion = client.chat().completions().create(params);
         }
-      ],
-      "role": "assistant",
-      "status": "completed",
-      "type": "message"
     }
-  ],
-  "parallel_tool_calls": true,
-  "temperature": 1.0,
-  "tool_choice": "auto",
-  "tools": [],
-  "top_p": 1.0,
-  "background": null,
-  "max_output_tokens": null,
-  "previous_response_id": null,
-  "reasoning": {
-    "effort": null,
-    "generate_summary": null,
-    "summary": null
-  },
-  "service_tier": "default",
-  "status": "completed",
-  "text": {
-    "format": {
-      "type": "text"
-    }
-  },
-  "truncation": "disabled",
-  "usage": {
-    "input_tokens": 12,
-    "input_tokens_details": {
-      "cached_tokens": 0
-    },
-    "output_tokens": 19,
-    "output_tokens_details": {
-      "reasoning_tokens": 0
-    },
-    "total_tokens": 31
-  },
-  "user": null,
-  "store": true
 }
 ```
 
+# [REST](#tab/rest)
+
+```bash
+curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
+  -d '{
+      "model": "grok-3-mini",
+      "messages": [
+      {
+        "role": "developer",
+        "content": "You are a helpful assistant."
+      },
+      {
+        "role": "user",
+        "content": "Explain what the bitter lesson is?"
+      }
+    ]
+  }'
+```
+
 ---
 
 ## v1 API support

articles/ai-foundry/openai/includes/language-overview/dotnet.md

@@ -170,8 +170,6 @@ BearerTokenPolicy tokenPolicy = new(
     new DefaultAzureCredential(),
     "https://cognitiveservices.azure.com/.default");
 
-#pragma warning disable OPENAI001
-
 OpenAIResponseClient client = new(
     model: "o4-mini",
     authenticationPolicy: tokenPolicy,
@@ -244,6 +242,45 @@ await foreach (StreamingResponseUpdate update
 }
 ```
 
+### MCP Server
+
+```csharp
+using OpenAI;
+using OpenAI.Responses;
+using System.ClientModel.Primitives;
+using Azure.Identity;
+
+#pragma warning disable OPENAI001 //currently required for token based authentication
+
+BearerTokenPolicy tokenPolicy = new(
+    new DefaultAzureCredential(),
+    "https://cognitiveservices.azure.com/.default");
+
+OpenAIResponseClient client = new(
+    model: "o4-mini",
+    authenticationPolicy: tokenPolicy,
+    options: new OpenAIClientOptions()
+    {
+        Endpoint = new Uri("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1")
+    }
+);
+
+ResponseCreationOptions options = new();
+options.Tools.Add(ResponseTool.CreateMcpTool(
+    serverLabel: "microsoft_learn",
+    serverUri: new Uri("https://learn.microsoft.com/api/mcp"),
+    toolCallApprovalPolicy: new McpToolCallApprovalPolicy(GlobalMcpToolCallApprovalPolicy.NeverRequireApproval)
+));
+
+OpenAIResponse response = (OpenAIResponse)client.CreateResponse([
+    ResponseItem.CreateUserMessageItem([
+        ResponseContentPart.CreateInputTextPart("Search for information about Azure Functions")
+    ])
+], options);
+
+Console.WriteLine(response.GetOutputText());
+```
+
 ## Error handling
 
 ### Error codes

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

@@ -114,6 +114,37 @@ for await (const event of stream) {
 }
 ```
 
+### MCP Server
+
+```javascript
+import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";
+import { OpenAI } from "openai";
+
+const tokenProvider = getBearerTokenProvider(
+    new DefaultAzureCredential(),
+    'https://cognitiveservices.azure.com/.default');
+const client = new OpenAI({
+    baseURL: "https://YOUR-RESORCE-NAME.openai.azure.com/openai/v1/",
+    apiKey: tokenProvider
+});
+
+const resp = await client.responses.create({
+  model: "gpt-5",
+  tools: [
+    {
+      type: "mcp",
+      server_label: "microsoft_learn",
+      server_description: "Microsoft Learn MCP server for searching and fetching Microsoft documentation.",
+      server_url: "https://learn.microsoft.com/api/mcp",
+      require_approval: "never",
+    },
+  ],
+  input: "Search for information about Azure Functions",
+});
+
+console.log(resp.output_text);
+```
+
 ## Chat
 
 `chat.completions.create`