Merge branch 'main' into feedback

Author: haileytap

.github/policies/disallow-edits.yml

@@ -62,15 +62,15 @@ configuration:
                 - isActivitySender:
                     user: laujan
                 - isActivitySender:
-                    user: patrickfarley
+                    user: PatrickFarley
                 - isActivitySender:
-                    user: heidisteen
+                    user: HeidiSteen
                 - isActivitySender:
                     user: haileytap
         then:
           - addReply:
               reply: >-
-                @${issueAuthor} - Please don't sign off on this PR. The area owners will sign off once they've reviewed your contribution.
+                ${issueAuthor} - Please don't sign off on this PR. The area owners will sign off once they've reviewed your contribution.
           - mentionUsers:
               mentionees:
                 - eric-urban

.gitignore

@@ -20,3 +20,5 @@ _repo.*/
 .github/prompts/*.md
 .github/prompts/*.zip
 .github/patterns/*.md
+
+articles/ai-foundry/includes/get-started-fdp.md

.openpublishing.redirection.json

@@ -5,12 +5,17 @@
       "redirect_url": "/azure/ai-foundry/how-to/connections-add",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/ai-foundry/how-to/develop/connections-add-sdk.md",
+      "redirect_url": "/azure/ai-foundry/how-to/connections-add?pivots=hub-project",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/ai-foundry/how-to/develop/vscode.md",
       "redirect_url": "/azure/ai-foundry/how-to/develop/get-started-projects-vs-code",
       "redirect_document_id": false
     },
-        {
+    {
       "source_path": "articles/ai-foundry/azure-openai-in-azure-ai-foundry.md",
       "redirect_url": "/azure/ai-foundry/what-is-azure-ai-foundry",
       "redirect_document_id": false
@@ -295,6 +300,16 @@
       "redirect_url": "/azure/ai-foundry",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/ai-foundry/openai/concepts/models.md",
+      "redirect_url": "/azure/ai-foundry/foundry-models/concepts/models-sold-directly-by-azure?pivots=azure-openai",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/ai-foundry/foundry-models/concepts/models.md",
+      "redirect_url": "/azure/ai-foundry/foundry-models/concepts/models-sold-directly-by-azure?pivots=azure-direct-others",
+      "redirect_document_id": false
+    },
     {
       "source_path_from_root": "/articles/ai-services/speech-service/text-to-speech-avatar/custom-avatar-endpoint.md",
       "redirect_url": "/azure/ai-services/speech-service/custom-avatar-create",
@@ -514,6 +529,21 @@
       "source_path": "articles/machine-learning/how-to-package-models.md",
       "redirect_url": "/azure/machine-learning/concept-endpoints",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/ai-services/create-account-terraform.md",
+      "redirect_url": "/azure/ai-foundry/how-to/create-resource-terraform",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/ai-services/create-account-bicep.md",
+      "redirect_url": "/azure/ai-foundry/how-to/create-resource-template",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/ai-foundry/foundry-models/how-to/inference.md",
+      "redirect_url": "/azure/ai-foundry/foundry-models/concepts/endpoints",
+      "redirect_document_id": true
     }
   ]
-}
+}

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

@@ -215,6 +215,11 @@
             "redirect_url": "/azure/ai-foundry/how-to/deploy-models-managed",
             "redirect_document_id": true
           },
+          {
+            "source_path_from_root": "/articles/ai-foundry/how-to/autoscale.md",
+            "redirect_url": "/azure/ai-services/autoscale?context=%2Fazure%2Fai-foundry%2Fcontext%2Fcontext",
+            "redirect_document_id": true
+          },
           {
             "source_path_from_root": "/articles/ai-studio/how-to/deploy-models-mistral-codestral.md",
             "redirect_url": "/azure/ai-foundry/how-to/deploy-models-mistral-codestral",
@@ -1223,6 +1228,11 @@
           "redirect_url": "/azure/ai-foundry/",
           "redirect_document_id": false
         },
+        {
+          "source_path_from_root": "/articles/ai-foundry/agents/concepts/tracing.md",
+          "redirect_url": "/azure/ai-foundry/how-to/develop/trace-agents-sdk",
+          "redirect_document_id": true
+        },
         {
           "source_path_from_root": "/articles/ai-foundry/how-to/online-evaluation.md",
           "redirect_url": "/azure/ai-foundry/how-to/monitor-applications",
@@ -1252,6 +1262,26 @@
           "source_path_from_root": "/articles/ai-foundry/how-to/evaluate-prompts-playground.md",
           "redirect_url": "/azure/ai-foundry/concepts/observability",
           "redirect_document_id": false
+        },
+        {
+          "source_path_from_root": "/articles/ai-foundry/openai/quickstart.md",
+          "redirect_url": "/azure/ai-foundry/openai/how-to/responses",
+          "redirect_document_id": false
+        },
+     {
+          "source_path_from_root": "/articles/ai-foundry/openai/how-to/work-with-code.md",
+          "redirect_url": "/azure/ai-foundry/openai/how-to/responses",
+          "redirect_document_id": false
+        },
+     {
+          "source_path_from_root": "/articles/ai-foundry/openai/how-to/completions.md",
+          "redirect_url": "/azure/ai-foundry/openai/how-to/responses",
+          "redirect_document_id": false
+        },
+     {
+          "source_path_from_root": "/articles/ai-foundry/openai/how-to/chat-markup-language.md",
+          "redirect_url": "/azure/ai-foundry/openai/how-to/responses",
+          "redirect_document_id": false
         }
     ]
 }

articles/ai-foundry/agents/concepts/capability-hosts.md

@@ -50,6 +50,14 @@ Capability hosts follow a hierarchy where more specific configurations override
 2. **Account-level capability host** - Provides shared defaults for all projects under the account.
 3. **Project-level capability host** - Overrides account-level and service defaults for that specific project. 
 
+## Understand capability host constraints
+
+When creating capability hosts, be aware of these important constraints to avoid conflicts:
+
+- **One capability host per scope**: Each account and each project can only have one active capability host. Attempting to create a second capability host with a different name at the same scope will result in a 409 conflict.
+
+- **Configuration updates are not supported**: If you need to change configuration, you must delete the existing capability host and recreate it.
+
 
 ## Recommended setup 
 
@@ -79,6 +87,7 @@ PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{
   }
 }
 ```
+
 **Project capability host**
 
 This configuration overrides service defaults and any account-level settings. All agents in this project will use your specified resources:
@@ -134,6 +143,120 @@ DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroup
 DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/projects/{projectName}/capabilityHosts/{name}?api-version=2025-06-01
 ```
 
+## Troubleshooting
+
+If you're experiencing issues when creating capability hosts, this section provides solutions to the most common problems and errors.
+
+### HTTP 409 Conflict errors
+
+#### Problem: Multiple capability hosts per scope
+
+**Symptoms:** You receive a 409 Conflict error when trying to create a capability host, even though you believe the scope is empty.
+
+**Error message:**
+```json
+{
+  "error": {
+    "code": "Conflict",
+    "message": "There is an existing Capability Host with name: existing-host, provisioning state: Succeeded for workspace: /subscriptions/.../workspaces/my-workspace, cannot create a new Capability Host with name: new-host for the same ClientId."
+  }
+}
+```
+
+**Root cause:** Each account and each project can only have one active capability host. You're trying to create a capability host with a different name when one already exists at the same scope.
+
+**Solution:**
+1. **Check existing capability hosts** - Query the scope to see what already exists
+2. **Use consistent naming** - Ensure you're using the same name across all requests for the same scope
+3. **Review your requirements** - Determine if the existing capability host meets your needs
+
+**Validation steps:**
+```http
+# For account-level capability hosts
+GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/capabilityHosts?api-version=2025-06-01
+
+# For project-level capability hosts  
+GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/projects/{projectName}/capabilityHosts?api-version=2025-06-01
+```
+
+#### Problem: Concurrent operations in progress
+
+**Symptoms:** You receive a 409 Conflict error indicating that another operation is currently running.
+
+**Error message:**
+```json
+{
+  "error": {
+    "code": "Conflict", 
+    "message": "Create: Capability Host my-host is currently in non creating, retry after its complete: /subscriptions/.../workspaces/my-workspace"
+  }
+}
+```
+
+**Root cause:** You're trying to create a capability host while another operation (update, delete, modify) is in progress at the same scope.
+
+**Solution:**
+1. **Wait for current operation to complete** - Check the status of ongoing operations
+2. **Monitor operation progress** - Use the operations API to track completion
+3. **Implement retry logic** - Add exponential backoff for temporary conflicts
+
+**Operation monitoring:**
+```http
+GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/locations/{location}/operationResults/{operationId}?api-version=2025-06-01
+```
+
+### Best practices for conflict prevention
+
+#### 1. Pre-request validation
+Always verify the current state before making changes:
+- Query existing capability hosts in the target scope
+- Check for any ongoing operations
+- Understand the current configuration
+
+#### 2. Implement retry logic with exponential backoff
+```csharp
+try 
+{
+    var response = await CreateCapabilityHostAsync(request);
+    return response;
+}
+catch (HttpRequestException ex) when (ex.Message.Contains("409"))
+{
+    if (ex.Message.Contains("existing Capability Host with name"))
+    {
+        // Handle name conflict - check if existing resource is acceptable
+        var existing = await GetExistingCapabilityHostAsync();
+        if (IsAcceptable(existing))
+        {
+            return existing; // Use existing resource
+        }
+        else
+        {
+            throw new InvalidOperationException("Scope already has a capability host with different name");
+        }
+    }
+    else if (ex.Message.Contains("currently in non creating"))
+    {
+        // Handle concurrent operation - implement retry with backoff
+        await Task.Delay(TimeSpan.FromSeconds(30));
+        return await CreateCapabilityHostAsync(request); // Retry once
+    }
+}
+```
+
+#### 3. Understand idempotent behavior
+The system supports idempotent create requests:
+- **Same name + same configuration** → Returns existing resource (200 OK)
+- **Same name + different configuration** → Returns 400 Bad Request  
+- **Different name** → Returns 409 Conflict
+
+#### 4. Configuration change workflow
+Since updates aren't supported, follow this sequence for configuration changes:
+1. Delete the existing capability host
+2. Wait for deletion to complete  
+3. Create a new capability host with the desired configuration
+
+
 ## Next steps
 - Learn more about the [Standard Agent Setup](standard-agent-setup.md) 
 - Get started with [Agent Service](../environment-setup.md)

articles/ai-foundry/agents/concepts/model-region-support.md

@@ -25,7 +25,8 @@ All deployments can perform the exact same inference operations, however the bil
 Azure AI Foundry Agent Service supports the following Azure OpenAI models in the listed regions.
 
 > [!NOTE]
-> * [Hub based projects](../../what-is-azure-ai-foundry.md#project-types) are limited to the following models: gpt-4o, gpt-4o-mini, gpt-4, gpt-35-turbo
+> * [Hub-based projects](../../what-is-azure-ai-foundry.md#project-types) are limited to the following models: gpt-4o, gpt-4o-mini, gpt-4, gpt-35-turbo
+> * [Spillover traffic management](../../openai/how-to/spillover-traffic-management.md) for [provisioned throughput](../../openai/concepts/provisioned-throughput.md) is compatible with agents
 > * For information on class A subnet support, see the setup guide on [GitHub](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/15-private-network-standard-agent-setup).
 > * The [file search tool](../how-to/tools/file-search.md) is currently unavailable in the following regions:
 >     * Italy north

articles/ai-foundry/agents/concepts/tracing.md

@@ -2,9 +2,8 @@
 title: 'How to use connected agents'
 titleSuffix: Azure AI Foundry
 description: Learn how to create multi-agentic systems using connected agents in the Azure AI Foundry Agent Service.
-services: cognitive-services
 manager: nitinme
-ms.service: azure
+ms.service: azure-ai-agent-service
 ms.topic: how-to
 ms.date: 07/11/2025
 author: aahill