Merge pull request #5497 from aahill/foundry-move

[bulk] moving Agent Service docs

Author: denrea

articles/ai-services/agents/breadcrumb/toc.yml renamed to articles/ai-foundry/agents/breadcrumb/toc.yml

@@ -17,12 +17,10 @@ ms.custom:
 Accelerate your agent development using code samples and best practices for creating agents. Each agent sample below links to a GitHub Repository, where you can browse the agent's configuration files, setup instructions and source code to start integrating them into your own project in code.
 With agents you create using these code samples, be sure to assess safety and legal implications, and to comply with all applicable laws and safety standards. See the [transparency note](/legal/cognitive-services/agents/transparency-note) for more information.
 
-[!INCLUDE [feature-preview](../../../ai-foundry/includes/feature-preview.md)]
-
 ## Prerequisites
 
 - [Azure subscription](https://azure.microsoft.com/free)
-- An [Azure AI Foundry project](../../../ai-foundry/how-to/create-projects.md).
+- An [Azure AI Foundry project](../../how-to\create-projects.md).
 
 ## Find the Agent Catalog in the Azure AI Foundry portal
 
@@ -31,7 +29,7 @@ With agents you create using these code samples, be sure to assess safety and le
 1. On the left pane, select **Agents**.
 1. Near the top of the screen, select **Catalog**. Find the code sample you want to use.
 
-    :::image type="content" source="../media/agent-catalog.png" alt-text="A screenshot of the model catalog." lightbox="../media/agent-catalog.png":::
+    :::image type="content" source="../media\agent-catalog.png" alt-text="A screenshot of the model catalog." lightbox="../media\agent-catalog.png":::
 
 1. Select **Open in Github** to view the entire sample application.
 

articles/ai-services/agents/concepts/agent-catalog.md renamed to articles/ai-foundry/agents/concepts/agent-catalog.md

@@ -22,13 +22,13 @@ Azure OpenAI provides customers with choices on the hosting structure that fits
 - **Standard** is offered with a global deployment option, routing traffic globally to provide higher throughput.
 - **Provisioned** is also offered with a global deployment option, allowing customers to purchase and deploy provisioned throughput units across Azure global infrastructure.
 
-All deployments can perform the exact same inference operations, however the billing, scale, and performance are substantially different. To learn more about Azure OpenAI deployment types see [deployment types guide](../../openai/how-to/deployment-types.md).
+All deployments can perform the exact same inference operations, however the billing, scale, and performance are substantially different. To learn more about Azure OpenAI deployment types see [deployment types guide](../../../ai-services/openai/how-to/deployment-types.md).
 
 Azure AI Foundry Agent Service supports the following Azure OpenAI models in the listed regions.
 
 > [!NOTE]
-> * The following table is for standard deployment availability. For information on Provisioned Throughput Unit (PTU) availability, see [provisioned throughput](../../openai/concepts/provisioned-throughput.md) in the Azure OpenAI documentation. `GlobalStandard` customers also have access to [global standard models](../../openai/concepts/models.md#global-standard-model-availability). 
-> * [Hub based projects](../../../ai-foundry/what-is-azure-ai-foundry.md#project-types) are limited to the following models: gpt-4o, gpt-4o-mini, gpt-4, gpt-35-turbo
+> * The following table is for standard deployment availability. For information on Provisioned Throughput Unit (PTU) availability, see [provisioned throughput](../../../ai-services/openai/concepts/provisioned-throughput.md) in the Azure OpenAI documentation. `GlobalStandard` customers also have access to [global standard models](../../../ai-services/openai/concepts/models.md#global-standard-model-availability). 
+> * [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
 
 | REGION           | o1 | o3-mini | gpt-4.1, 2025-04-14 | gpt-4.1-mini, 2025-04-14 | gpt-4.1-nano, 2025-04-14 | gpt-4o, 2024-05-13 | gpt-4o, 2024-08-06 | gpt-4o, 2024-11-20 | gpt-4o-mini, 2024-07-18 | gpt-4, 0613 | gpt-4, turbo-2024-04-09 | gpt-4-32k, 0613 | gpt-35-turbo, 1106 | gpt-35-turbo, 0125 |
 |------------------|----|---------|---------------------|--------------------------|--------------------------|--------------------|--------------------|--------------------|-------------------------|-------------|-------------------------|-----------------|--------------------|--------------------|

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

@@ -26,7 +26,7 @@ When you use an Agent, there are a series of steps that are involved.
 - **Check the run status:** Monitor the run until it has completed. 
 - **Getting the response:** After the agent has created a response, display it to the user.
 
-:::image type="content" source="../media/run-thread-model.png" alt-text="A diagram showing an example of an agent run." lightbox="../media/run-thread-model.png":::
+:::image type="content" source="../media\run-thread-model.png" alt-text="A diagram showing an example of an agent run." lightbox="../media\run-thread-model.png":::
 
 ## Agent
 
@@ -46,4 +46,4 @@ A run involves invoking the agent on the thread, where it processes the messages
 
 ## Next steps
 
-* [Quickstart: create an agent](../quickstart.md)
+* [Quickstart: create an agent](../quickstart.md)

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

@@ -66,14 +66,14 @@ Azure AI Foundry Agent Service offers three environment configuration modes to s
 | Private Network Isolation (Bring your own virtual network)              |             |                                        | ✅                                      |
 
 ### Deployment options
-To customize these templates, see [use your own resources](./how-to/use-your-own-resources.md). 
+To customize these templates, see [use your own resources](how-to\use-your-own-resources.md). 
 
-If you want support for Private Network Isolation see [network-secured setup](./how-to/virtual-networks.md) for more information on how to bring your own virtual network.
+If you want support for Private Network Isolation see [network-secured setup](how-to\virtual-networks.md) for more information on how to bring your own virtual network.
 
 | Description and Autodeploy  |  Diagram (click to zoom in) |
 |-----------------------------|------------------------------|
-| Deploy a basic agent setup that uses **Managed Identity** for authentication. <br> An account and project are created. <br> A GPT-4o model is deployed. <br> A Microsoft-managed Key Vault is used by default. <br> [![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fazure-ai-foundry%2Ffoundry-samples%2Frefs%2Fheads%2Fmain%2Fsamples%2Fmicrosoft%2Finfrastructure-setup%2F40-basic-agent-setup%2Fbasic-setup.json) | :::image type="content" source="./media/quickstart/basic-setup-resources-foundry.png" alt-text="An architecture diagram for basic agent setup." lightbox="./media/quickstart/basic-setup-resources-foundry.png"::: |
-| Deploy a standard agent setup that uses **Managed Identity** for authentication. <br>An account and project are created. <br> A GPT-4o model is deployed. <br> Azure resources for storing customer data - **Azure Storage**, **Azure Cosmos DB**, and **Azure AI Search** - are automatically created if existing resources are't  provided. <br> These resources are connected to your project to store files, threads, and vector data. <br> A Microsoft-managed Key Vault is used by default.</li></ul> <br> [![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fazure-ai-foundry%2Ffoundry-samples%2Frefs%2Fheads%2Fmain%2Fsamples%2Fmicrosoft%2Finfrastructure-setup%2F41-standard-agent-setup%2Fazuredeploy.json) | :::image type="content" source="./media/quickstart/standard-agent-setup.png" alt-text="An architecture diagram for standard agent setup." lightbox="./media/quickstart/standard-agent-setup.png"::: |
+| Deploy a basic agent setup that uses **Managed Identity** for authentication. <br> An account and project are created. <br> A GPT-4o model is deployed. <br> A Microsoft-managed Key Vault is used by default. <br> [![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fazure-ai-foundry%2Ffoundry-samples%2Frefs%2Fheads%2Fmain%2Fsamples%2Fmicrosoft%2Finfrastructure-setup%2F40-basic-agent-setup%2Fbasic-setup.json) | :::image type="content" source="./media\quickstart\basic-setup-resources-foundry.png" alt-text="An architecture diagram for basic agent setup." lightbox="./media\quickstart\basic-setup-resources-foundry.png"::: |
+| Deploy a standard agent setup that uses **Managed Identity** for authentication. <br>An account and project are created. <br> A GPT-4o model is deployed. <br> Azure resources for storing customer data - **Azure Storage**, **Azure Cosmos DB**, and **Azure AI Search** - are automatically created if existing resources are't  provided. <br> These resources are connected to your project to store files, threads, and vector data. <br> A Microsoft-managed Key Vault is used by default.</li></ul> <br> [![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fazure-ai-foundry%2Ffoundry-samples%2Frefs%2Fheads%2Fmain%2Fsamples%2Fmicrosoft%2Finfrastructure-setup%2F41-standard-agent-setup%2Fazuredeploy.json) | :::image type="content" source="./media\quickstart\standard-agent-setup.png" alt-text="An architecture diagram for standard agent setup." lightbox="./media\quickstart\standard-agent-setup.png"::: |
 
 ### [Optional] Model selection in autodeploy template
 You can customize the model used by your agent by editing the model parameters in the autodeploy template. To deploy a different model, you need to update at least the `modelName` and `modelVersion` parameters. 
@@ -91,11 +91,11 @@ By default, the deployment template is configured with the following values:
 > [!IMPORTANT]
 > **Don't change the modelFormat parameter.** 
 >
-> The templates only support deployment of Azure OpenAI models. See which Azure OpenAI models are supported in the [Azure AI Foundry Agent Service model support](./concepts/model-region-support.md) documentation.
+> The templates only support deployment of Azure OpenAI models. See which Azure OpenAI models are supported in the [Azure AI Foundry Agent Service model support](concepts\model-region-support.md) documentation.
 
 
 ### What's next?
-* [Create your first agent](./quickstart.md)
+* [Create your first agent](quickstart.md)
 * Explore more:
-    * [Use your existing resources](./how-to/use-your-own-resources.md)
-    * [Network secured agent setup](./how-to/virtual-networks.md)
+    * [Use your existing resources](how-to\use-your-own-resources.md)
+    * [Network secured agent setup](how-to\virtual-networks.md)

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

@@ -12,7 +12,7 @@ metadata:
   author: aahill
 title: Azure AI Foundry Agent Service frequently asked questions
 summary: |
-  If you can't find answers to your questions in this document, and still need help check the [Azure AI services support options guide](../cognitive-services-support-options.md). Azure AI Foundry Agent Service is part of Azure AI services.
+  If you can't find answers to your questions in this document, and still need help check the [Azure AI services support options guide](../../ai-services/cognitive-services-support-options.md). Azure AI Foundry Agent Service is part of Azure AI services.
 sections:
   - name: General
     questions:
@@ -53,8 +53,8 @@ sections:
       - question: |
           Is there any additional pricing or quota for using Foundry Agent Service? 
         answer: |
-          No. All [quotas](./quotas-limits.md) apply to using models with Foundry Agent Service.
+          No. All [quotas](quotas-limits.md) apply to using models with Foundry Agent Service.
       - question: |
           Does the Foundry Agent Service API support non-Azure OpenAI models?   
         answer: |
-          Yes, the Foundry Agent Service API supports non-Azure OpenAI models. See the [models](./concepts/model-region-support.md) page for more information.
+          Yes, the Foundry Agent Service API supports non-Azure OpenAI models. See the [models](concepts\model-region-support.md) page for more information.

articles/ai-services/agents/concepts/tracing.md renamed to articles/ai-foundry/agents/concepts/tracing.md

@@ -73,7 +73,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
 
 ## Limitations
 
-* Connected agents cannot call local functions using the function calling tool. We recommend using the [OpenAPI tool](./tools/openapi-spec.md) or [Azure Functions](./tools/azure-functions.md) instead.
+* Connected agents cannot call local functions using the function calling tool. We recommend using the [OpenAPI tool](tools\openapi-spec.md) or [Azure Functions](tools\azure-functions.md) instead.
 * It is currently not possible to guarantee citations will be passed from connected agents. You can try using prompt engineering combined with different models to try and improve the possibility that citations will be outputted by the main agent, but results are subject to variability. 
 
 :::zone pivot="portal"
@@ -85,7 +85,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
 2. Select an existing agent from the list or create a new one.
 3. Scroll down to the **Connected agents** section in the agent's setup panel and select **Add +**.
 
-:::image type="content" source="../media/connected-agents/connected-agents-foundry.png" alt-text="A screenshot of the agents page in the Azure AI Foundry." lightbox="../media/connected-agents/connected-agents-foundry.png":::
+:::image type="content" source="../media\connected-agents\connected-agents-foundry.png" alt-text="A screenshot of the agents page in the Azure AI Foundry." lightbox="../media\connected-agents\connected-agents-foundry.png":::
 
 4. In the dialog that appears, choose an agent for the main agent to delegate tasks to, and describe:
    - Select an **existing agent** from the dropdown. This is the connected agent that the main agent will delegate tasks to.
@@ -100,7 +100,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
 
     The `research_agent` should delegate this request to `stock_price_bot` based on the routing description you defined.
 
-:::image type="content" source="../media/connected-agents/connected-agents-foundry-2.png" alt-text="A screenshot of the connected agents screen" lightbox="../media/connected-agents/connected-agents-foundry-2.png":::
+:::image type="content" source="../media\connected-agents\connected-agents-foundry-2.png" alt-text="A screenshot of the connected agents screen" lightbox="../media\connected-agents\connected-agents-foundry-2.png":::
 
 ::: zone-end