Merge branch 'main' of https://github.com/MicrosoftDocs/azure-ai-docs-pr into voicelive-api-reference-new

Author: goergenj

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

@@ -4,7 +4,8 @@ titleSuffix: Azure AI Foundry
 description: Learn how to create and delete capability hosts
 services: cognitive-services
 manager: nitinme
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ms.topic: conceptual
 ms.date: 07/07/2025
 author: fosteramanda

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

@@ -5,7 +5,8 @@ description: Learn about the models you can use with Azure AI Foundry Agent Serv
 manager: nitinme
 author: aahill
 ms.author: aahi
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ms.topic: conceptual
 ms.date: 08/04/2025
 ms.custom: azure-ai-agents, references_regions

articles/ai-foundry/agents/concepts/standard-agent-setup.md

@@ -5,7 +5,8 @@ description: Learn about the enterprise features of the standard setup
 manager: nitinme
 author: fosteramanda
 ms.author: fosteramanda
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ms.topic: conceptual
 ms.date: 05/05/2025
 ms.custom: azure-ai-agents

articles/ai-foundry/agents/concepts/threads-runs-messages.md

@@ -1,17 +1,18 @@
 ---
-title: Threads, Runs, and Messages in Azure AI Foundry Agent Service
+title: Threads, Runs, and Messages in the Azure AI Foundry Agent Service
 titleSuffix: Azure AI Foundry
 description: Learn about the components used in the Azure AI Foundry Agent Service.
 manager: nitinme
 author: aahill
 ms.author: aahi
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ms.topic: conceptual
-ms.date: 04/15/2025
+ms.date: 09/24/2025
 ms.custom: azure-ai-agents
 ---
 
-# Threads, Runs, and Messages in Azure AI Foundry Agent Service
+# Threads, runs, and messages in Azure AI Foundry Agent Service
 
 Azure AI Foundry Agent Service supports persistent threads, runs, and messages, which are essential components for managing conversation states and interactions with users.
 
@@ -30,7 +31,7 @@ When you use an Agent, there are a series of steps that are involved.
 
 ## Agent
 
-A custom AI that uses AI models in conjunction with tools.
+An agent is a configurable orchestration component that uses AI models with instructions, tools, parameters, and optional safety/governance controls. At run time an agent uses these components and a given thread's message history to respond to user inputs. 
 
 ## Threads
 

articles/ai-foundry/agents/environment-setup.md

@@ -6,7 +6,8 @@ manager: nitinme
 author: aahill
 ms.author: aahi
 ms.reviewer: fosteramanda 
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
 ms.date: 06/18/2025
 ms.custom: azure-ai-agents

articles/ai-foundry/agents/faq.yml

@@ -5,7 +5,8 @@ metadata:
   description: Get answers to the most popular questions about Azure AI Foundry Agent Service
   #services: cognitive-services
   manager: nitinme
-  ms.service: azure-ai-agent-service
+  ms.service: azure-ai-foundry
+  ms.subservice: azure-ai-foundry-agent-service
   ms.topic: faq
   ms.date: 06/30/2025
   ms.author: aahi

articles/ai-foundry/agents/how-to/connected-agents.md

@@ -3,7 +3,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.
 manager: nitinme
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
 ms.date: 07/11/2025
 author: aahill

articles/ai-foundry/agents/how-to/metrics.md

@@ -1,12 +1,13 @@
 ---
 title: Monitor Azure AI Foundry Agent Service
 description: Start here to learn how to use Azure Monitor to capture and analyze metrics for your Azure AI Foundry Agent Service.
-ms.date: 06/02/2025
+ms.date: 09/24/2025
 ms.custom: horz-monitor, subject-monitoring
 ms.topic: conceptual
 author: aahill
 ms.author: aahi
-ms.service: azure-ai-agent-service
+ms.service: azure-ai-foundry
+ms.subservice: azure-ai-foundry-agent-service
 ---
 
 # Monitor Azure AI Foundry Agent Service