fixes

aahill · aahill · commit 2aa28a6d50b6 · 2025-07-01T11:30:23.000-07:00
diff --git a/articles/ai-foundry/openai/concepts/assistants.md b/articles/ai-foundry/openai/concepts/assistants.md
@@ -85,7 +85,7 @@ We strongly recommend the following data access controls:
 
 ## Parameters
 
-The Assistants API has support for several parameters that let you customize the Assistants' output. The `tool_choice` parameter lets you force the Assistant to use a specified tool. You can also create messages with the `assistant` role to create custom conversation histories in Threads. `temperature`, `top_p`, `response_format` let you further tune responses. For more information, see the [reference](../assistants-reference.md#create-an-assistant) documentation.
+The Assistants API has support for several parameters that let you customize the Assistants' output. The `tool_choice` parameter lets you force the Assistant to use a specified tool. You can also create messages with the `assistant` role to create custom conversation histories in Threads. `temperature`, `top_p`, `response_format` let you further tune responses. For more information, see the [reference](../reference-preview.md#list---assistants) documentation.
 
 ## Context window management
 
diff --git a/articles/ai-foundry/openai/concepts/audio.md b/articles/ai-foundry/openai/concepts/audio.md
@@ -33,7 +33,7 @@ GPT-4o audio completion is designed to generate audio from audio or text prompts
 The audio models via the `/audio` API can be used for speech to text, translation, and text to speech. To get started with the audio API, see the [Whisper quickstart](../whisper-quickstart.md) for speech to text.
 
 > [!NOTE]
-> To help you decide whether to use Azure AI Speech or Azure OpenAI, see the [Azure AI Speech batch transcription](../../speech-service/batch-transcription-create.md), [What is the Whisper model?](../../speech-service/whisper-overview.md), and [OpenAI text to speech voices](../../speech-service/openai-voices.md#openai-text-to-speech-voices-via-azure-openai-or-via-azure-ai-speech) guides.
+> To help you decide whether to use Azure AI Speech or Azure OpenAI, see the [Azure AI Speech batch transcription](../../../ai-services/speech-service/batch-transcription-create.md), [What is the Whisper model?](../../../ai-services/speech-service/whisper-overview.md), and [OpenAI text to speech voices](../../../ai-services/speech-service/openai-voices.md#openai-text-to-speech-voices-via-azure-openai-or-via-azure-ai-speech) guides.
 
 ## Related content
 
diff --git a/articles/ai-foundry/openai/concepts/gov-provisioned.md b/articles/ai-foundry/openai/concepts/gov-provisioned.md
@@ -3,6 +3,7 @@ title: Azure OpenAI Provisioned Managed Offering in Azure Government
 titleSuffix: Azure OpenAI
 description: Learn how to use Azure OpenAI Provisioned Managed Deployments in the Azure Government cloud.
 author: challenp
+ms.author: chaparker
 ms.service: azure-ai-openai
 ms.topic: how-to
 ms.custom: references_regions, azuregovernment
diff --git a/articles/ai-foundry/openai/concepts/provisioned-throughput.md b/articles/ai-foundry/openai/concepts/provisioned-throughput.md
@@ -116,7 +116,7 @@ If an acceptable region isn't available to support the desired model, version, a
 
 ### How can I monitor capacity?
 
-The [Provisioned-Managed Utilization V2 metric](../how-to/monitor-openai.md#azure-openai-metrics) in Azure Monitor measures a given deployments utilization on 1-minute increments. All provisioned deployment types are optimized to ensure that accepted calls are processed with a consistent model processing time (actual end-to-end latency is dependent on a call's characteristics).  
+The [Provisioned-Managed Utilization V2 metric](../how-to/monitor-openai.md#azure-monitor-platform-metrics) in Azure Monitor measures a given deployments utilization on 1-minute increments. All provisioned deployment types are optimized to ensure that accepted calls are processed with a consistent model processing time (actual end-to-end latency is dependent on a call's characteristics).  
 
 ### How utilization performance works
 
diff --git a/articles/ai-foundry/openai/encrypt-data-at-rest.md b/articles/ai-foundry/openai/encrypt-data-at-rest.md
@@ -55,7 +55,7 @@ Only RSA and RSA-HSM keys of size 2048 are supported with Azure OpenAI encryptio
 1. Select **Create**.
 1. Under **Key permissions**, select **Get**, **Wrap Key**, and **Unwrap Key**. Leave the remaining checkboxes unselected.
 
-   :::image type="content" source="../media/cognitive-services-encryption/key-vault-access-policy.png" alt-text="Screenshot of the Azure portal page for a key vault access policy. The permissions selected are Get Key, Wrap Key, and Unwrap Key.":::
+   :::image type="content" source="../../ai-services/media/cognitive-services-encryption/key-vault-access-policy.png" alt-text="Screenshot of the Azure portal page for a key vault access policy. The permissions selected are Get Key, Wrap Key, and Unwrap Key.":::
 
 1. Select **Next**.
 1. Search for the name of your Azure OpenAI resource and select its managed identity.
@@ -87,13 +87,13 @@ To specify a key as a URI, follow these steps:
 1. Select the desired key, and then select the key to view its versions. Select a key version to view the settings for that version.
 1. Copy the **Key Identifier** value, which provides the URI.
 
-   :::image type="content" source="../media/cognitive-services-encryption/key-uri-portal.png" alt-text="Screenshot of the Azure portal page for a key version. The Key Identifier box contains a placeholder for a key URI.":::
+   :::image type="content" source="../../ai-services/media/cognitive-services-encryption/key-uri-portal.png" alt-text="Screenshot of the Azure portal page for a key version. The Key Identifier box contains a placeholder for a key URI.":::
 
 1. Go back to your Azure OpenAI resource, and then select **Encryption**.
 1. Under **Encryption key**, select **Enter key URI**.
 1. Paste the URI that you copied into the **Key URI** box.
 
-   :::image type="content" source="../media/cognitive-services-encryption/ssecmk2.png" alt-text="Screenshot of the Encryption page for an Azure OpenAI resource. The Enter key URI option is selected, and the Key URI box contains a value.":::
+   :::image type="content" source="../../ai-services/media/cognitive-services-encryption/ssecmk2.png" alt-text="Screenshot of the Encryption page for an Azure OpenAI resource. The Enter key URI option is selected, and the Key URI box contains a value.":::
 
 1. Under **Subscription**, select the subscription that contains the key vault.
 1. Save your changes.
diff --git a/articles/ai-foundry/openai/faq.yml b/articles/ai-foundry/openai/faq.yml
@@ -45,7 +45,7 @@ sections:
       - question: |
           Does Azure OpenAI support VNETs and Private Endpoints?
         answer: | 
-          Yes, Azure OpenAI supports VNETs and Private Endpoints. To learn more, consult the [virtual networking guidance](../cognitive-services-virtual-networks.md?context=/azure/ai-services/openai/context/context). 
+          Yes, Azure OpenAI supports VNETs and Private Endpoints. To learn more, consult the [virtual networking guidance](../../ai-services/cognitive-services-virtual-networks.md?context=/azure/ai-services/openai/context/context). 
       - question: |
           Do the GPT-4 models currently support image input?
         answer: | 
@@ -263,7 +263,7 @@ sections:
       - question: |
           How long is this data stored?
         answer: |
-          All used data persists in this system unless you explicitly delete this data. Use the [delete function](./assistants-reference-threads.md) with the thread ID of the thread you want to delete. Clearing the Run in the Assistants Playground does not delete threads, however deleting them using delete function will not list them in the thread page. 
+          All used data persists in this system unless you explicitly delete this data. Use the delete function with the thread ID of the thread you want to delete. Clearing the Run in the Assistants Playground does not delete threads, however deleting them using delete function will not list them in the thread page. 
       - question: |
           Can I bring my own data store to use with Assistants? 
         answer: |
diff --git a/articles/ai-foundry/openai/how-to/assistant-functions.md b/articles/ai-foundry/openai/how-to/assistant-functions.md
@@ -202,6 +202,6 @@ After you submit tool outputs, the **Run** will enter the `queued` state before
 
 ## See also
 
-* [Assistants API Reference](../assistants-reference.md)
+* [Assistants API Reference](../reference-preview.md#list---assistants)
 * Learn more about how to use Assistants with our [How-to guide on Assistants](../how-to/assistant.md).
 * [Azure OpenAI Assistants API samples](https://github.com/Azure-Samples/azureai-samples/tree/main/scenarios/Assistants)
diff --git a/articles/ai-foundry/openai/how-to/code-interpreter.md b/articles/ai-foundry/openai/how-to/code-interpreter.md
@@ -269,6 +269,6 @@ curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/files/<YOUR-FILE-ID>/con
 ## See also
 
 * [File Upload API reference](/rest/api/azureopenai/files/upload?view=rest-azureopenai-2024-02-15-preview&tabs=HTTP&preserve-view=true)
-* [Assistants API Reference](../assistants-reference.md)
+* [Assistants API Reference](../reference-preview.md#list---assistants)
 * Learn more about how to use Assistants with our [How-to guide on Assistants](../how-to/assistant.md).
 * [Azure OpenAI Assistants API samples](https://github.com/Azure-Samples/azureai-samples/tree/main/scenarios/Assistants)
diff --git a/articles/ai-foundry/openai/how-to/managed-identity.md b/articles/ai-foundry/openai/how-to/managed-identity.md
@@ -22,7 +22,7 @@ In the following sections, you'll use the Azure CLI to sign in, and obtain a bea
 - An Azure subscription - <a href="https://azure.microsoft.com/free/cognitive-services" target="_blank">Create one for free</a>
 
 - [Custom subdomain names are required to enable features like Microsoft Entra ID for authentication.](
-../../cognitive-services-custom-subdomains.md)
+../../../ai-services/cognitive-services-custom-subdomains.md)
 
 - Azure CLI - [Installation Guide](/cli/azure/install-azure-cli)
 - The following Python libraries: os, requests, json, openai, azure-identity
diff --git a/articles/ai-foundry/openai/how-to/on-your-data-best-practices.md b/articles/ai-foundry/openai/how-to/on-your-data-best-practices.md
@@ -70,7 +70,7 @@ If the correct document chunks don't appear in the retrieved documents, you need
 
 * Do you have semistructured data in your documents, such as numerous tables? There might be an ingestion problem. Your data might need special handling during ingestion.
 
-  * If the file format is PDF, we offer optimized ingestion for tables by using the offline scripts available on [GitHub](https://github.com/microsoft/sample-app-aoai-chatGPT/tree/main/scripts). To use the scripts, you need to have a [Document Intelligence](../../document-intelligence/overview.md) resource and use the [layout model](../../document-intelligence/concept-layout.md).
+  * If the file format is PDF, we offer optimized ingestion for tables by using the offline scripts available on [GitHub](https://github.com/microsoft/sample-app-aoai-chatGPT/tree/main/scripts). To use the scripts, you need to have a [Document Intelligence](../../../ai-services/document-intelligence/overview.md) resource and use the [layout model](../../../ai-services/document-intelligence/concept-layout.md).
   
   * You can adjust your [chunk size](../concepts/use-your-data.md#chunk-size-preview) to make sure your largest table fits within it.
 
diff --git a/articles/ai-foundry/openai/how-to/provisioned-throughput-onboarding.md b/articles/ai-foundry/openai/how-to/provisioned-throughput-onboarding.md
@@ -65,7 +65,7 @@ Customers that require long-term usage of regional provisioned, data zone provis
 > It's not recommended to scale production deployments according to incoming traffic and pay for them purely on an hourly basis. There are two reasons for this:
 > * The cost savings achieved by purchasing Azure Reservations for Azure AI Foundry Provisioned Throughput, Data Zone Provisioned, and Global Provisioned are significant, and it will be less expensive in many cases to maintain a deployment sized for full production volume paid for via a reservation than it would be to scale the deployment with incoming traffic.
 > * Having unused provisioned quota (PTUs) doesn't guarantee that capacity will be available to support an increase in the size of the deployment when required. Quota limits the maximum number of PTUs that can be deployed, but it isn't a capacity guarantee. Provisioned capacity for each region and model dynamically changes throughout the day and might not be available when required. As a result, it's recommended to maintain a permanent deployment to cover your traffic needs (paid for via a reservation).
-> Charges for deployments on a deleted resource will continue until the resource is purged. To prevent this, delete a resource's deployment before deleting the resource. For more information, see [Recover or purge deleted Azure OpenAI resources](../../recover-purge-resources.md). 
+> Charges for deployments on a deleted resource will continue until the resource is purged. To prevent this, delete a resource's deployment before deleting the resource. For more information, see [Recover or purge deleted Azure OpenAI resources](../../../ai-services/recover-purge-resources.md). 
 
 ## How much throughput per PTU you get for each model
 
diff --git a/articles/ai-foundry/openai/quotas-limits.md b/articles/ai-foundry/openai/quotas-limits.md
@@ -330,7 +330,7 @@ To minimize issues related to rate limits, it's a good idea to use the following
 
 Quota increase requests can be submitted via the [quota increase request form](https://aka.ms/oai/stuquotarequest). Due to high demand, quota increase requests are being accepted and are filled in the order they're received. Priority is given to customers who generate traffic that consumes the existing quota allocation, and your request might be denied if this condition isn't met.
 
-For other rate limits, [submit a service request](../cognitive-services-support-options.md?context=/azure/ai-services/openai/context/context).
+For other rate limits, [submit a service request](../../ai-services/cognitive-services-support-options.md?context=/azure/ai-services/openai/context/context).
 
 ## Regional quota capacity limits
 
diff --git a/articles/ai-foundry/openai/toc.yml b/articles/ai-foundry/openai/toc.yml
@@ -262,7 +262,7 @@ items:
   - name: Networking and security
     items:
       - name: Use virtual networks
-        href: ../cognitive-services-virtual-networks.md?context=/azure/ai-services/openai/context/context
+        href: ../../ai-services/cognitive-services-virtual-networks.md?context=/azure/ai-services/openai/context/context
       - name: Virtual networks with private endpoints
         href: ./how-to/network.md        
       - name: Encryption of data at rest
@@ -327,7 +327,7 @@ items:
     - name: Data, privacy, and security
       href: ../../ai-foundry/responsible-ai/openai/data-privacy.md
     - name: Use virtual networks
-      href: ../cognitive-services-virtual-networks.md?context=/azure/ai-services/openai/context/context
+      href: ../../ai-services/cognitive-services-virtual-networks.md?context=/azure/ai-services/openai/context/context
     - name: Encryption of data at rest
       href: encrypt-data-at-rest.md
     - name: Managed identity
@@ -446,7 +446,7 @@ items:
 - name: Resources
   items: 
     - name: Support and help options
-      href: ../cognitive-services-support-options.md?context=/azure/ai-services/openai/context/context
+      href: ../../ai-services/cognitive-services-support-options.md?context=/azure/ai-services/openai/context/context
     - name: Intro to Azure OpenAI training
       href: /training/modules/explore-azure-openai/
     - name: Azure OpenAI Samples
diff --git a/articles/ai-foundry/openai/whats-new.md b/articles/ai-foundry/openai/whats-new.md
@@ -519,7 +519,7 @@ A refresh of the Assistants API is now publicly available. It contains the follo
 * [File search tool and vector storage](https://go.microsoft.com/fwlink/?linkid=2272425)
 * [Max completion and max prompt token support](./concepts/assistants.md) for managing token usage.
 * `tool_choice` parameter for forcing the Assistant to use a specified tool. 
-You can now create messages with the [assistant](.//assistants-reference-messages.md#create-message) role to create custom conversation histories in Threads.
+You can now create messages with the assistant role to create custom conversation histories in Threads.
 * Support for `temperature`, `top_p`, `response_format` parameters.
 * Streaming and polling support. You can use the helper functions in our Python SDK to create runs and stream responses. We have also added polling SDK helpers to share object status updates without the need for polling. 
 * Experiment with [Logic Apps and Function Calling using Azure OpenAI Studio](./how-to/assistants-logic-apps.md). Import your REST APIs implemented in Logic Apps as functions and the studio invokes the function (as a Logic Apps workflow) automatically based on the user prompt.
diff --git a/articles/ai-foundry/openai/whisper-quickstart.md b/articles/ai-foundry/openai/whisper-quickstart.md
@@ -16,12 +16,12 @@ zone_pivot_groups: programming-languages-rest-ps-py-js-cs
 
 # Quickstart: Speech to text with the Azure OpenAI Whisper model
 
-This quickstart explains how to use the [Azure OpenAI Whisper model](../speech-service/whisper-overview.md) for speech to text conversion. The Whisper model can transcribe human speech in numerous languages, and it can also translate other languages into English.
+This quickstart explains how to use the [Azure OpenAI Whisper model](../../ai-services/speech-service/whisper-overview.md) for speech to text conversion. The Whisper model can transcribe human speech in numerous languages, and it can also translate other languages into English.
 
 > [!NOTE]
 > For information about other audio models that you can use with Azure OpenAI, see [Audio models](./concepts/models.md?tabs=standard-audio#standard-deployment-regional-models-by-endpoint).
 
-The file size limit for the Whisper model is 25 MB. If you need to transcribe a file larger than 25 MB, you can use the Azure AI Speech [batch transcription](../speech-service/batch-transcription-create.md#use-a-whisper-model) API.
+The file size limit for the Whisper model is 25 MB. If you need to transcribe a file larger than 25 MB, you can use the Azure AI Speech [batch transcription](../../ai-services/speech-service/batch-transcription-create.md#use-a-whisper-model) API.
 
 ::: zone pivot="rest-api"
 
@@ -68,5 +68,5 @@ If you want to clean up and remove an Azure OpenAI resource, you can delete the
 
 ## Next steps
 
-* To learn how to convert audio data to text in batches, see [Create a batch transcription](../speech-service/batch-transcription-create.md).
+* To learn how to convert audio data to text in batches, see [Create a batch transcription](../../ai-services/speech-service/batch-transcription-create.md).
 * For more examples, check out the [Azure OpenAI Samples GitHub repository](https://github.com/Azure-Samples/openai).
