Merge branch 'MicrosoftDocs:release-azure-agents' into release-azure-agents

Author: fosteramanda

articles/ai-services/.openpublishing.redirection.ai-services.json

@@ -790,6 +790,21 @@
       "redirect_url": "/azure/ai-services/language-service/question-answering/overview",
       "redirect_document_id": true
     },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/try-document-intelligence-studio.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/studio-custom-project",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/train/custom-generative-extraction.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/train/custom-model",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/how-to-guides/build-train-custom-generative-model.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/how-to-guides/build-a-custom-model",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/ai-services/openai/how-to/integrate-synapseml.md",
       "redirect_url": "/azure/ai-services/openai/overview",

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

@@ -13,7 +13,7 @@ recommendations: false
 
 # Models supported by Azure AI Agent Service
 
-Agents are powered by a diverse set of models with different capabilities and price points. Model availability varies by region and cloud. Certain tools and capabilities require the latest models. The following models are available in the API, SDK, and Azure AI Foundry. The following table is for pay-as-you-go. For information on Provisioned Throughput Unit (PTU) availability, see [provisioned throughput](../../openai/concepts/provisioned-throughput.md) in the OpenAI documentation. You can use [global standard models](../../openai/concepts/models.md#global-standard-model-availability) if they're supported in the regions listed here. 
+Agents are powered by a diverse set of models with different capabilities and price points. Model availability varies by region and cloud. Certain tools and capabilities require the latest models. The following models are available in the available SDKs. The following table is for pay-as-you-go. For information on Provisioned Throughput Unit (PTU) availability, see [provisioned throughput](../../openai/concepts/provisioned-throughput.md) in the OpenAI documentation. You can use [global standard models](../../openai/concepts/models.md#global-standard-model-availability) if they're supported in the regions listed here. 
 
 | Region | `gpt-35-turbo (0613)` | `gpt-35-turbo (1106)`| `fine tuned gpt-3.5-turbo-0125` | `gpt-4 (0613)` | `gpt-4 (1106)` | `gpt-4 (0125)` | `gpt-4o (2024-05-13)` | `gpt-4o-mini (2024-07-18)` |
 |-----|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|

articles/ai-services/agents/how-to/tools/bing-grounding.md

@@ -25,13 +25,27 @@ Developers and end users don't have access to raw content returned from Groundin
 
 >[!IMPORTANT]
 > 1. Your usage of Grounding with Bing Search may incur costs. See the [pricing page](https://www.microsoft.com/bing/apis/grounding-pricing) for details.
-> 1. If you choose to create a new Grounding with Bing Search resource programatically, such as the Azure CLI or using a deployment template, you automatically agree to be bound by and comply with the [terms of use and use and display requirements](https://www.microsoft.com/en-us/bing/apis/grounding-legal).
+> 1. By creating and using a Grounding with Bing Search resource through code-first experience, such as Azure CLI, or deploying through deployment template, you agree to be bound by and comply with the terms available at https://www.microsoft.com/en-us/bing/apis/grounding-legal, which may be updated from time to time.
 
 
 ## Setup  
 
 > [!NOTE]
-> Grounding with Bing Search only works with the following Azure OpenAI models: `gpt-3.5-turbo-0125`, `gpt-4-0125-preview`, `gpt-4-turbo-2024-04-09`, `gpt-4o-0513`
+> 1. Grounding with Bing Search only works with the following Azure OpenAI models: `gpt-3.5-turbo-0125`, `gpt-4-0125-preview`, `gpt-4-turbo-2024-04-09`, `gpt-4o-0513`
+> 1. It works in the following regions: `West Central US` and `West US 2`
+
+In one click, you can start creating a **new Azure AI Foundry project and Grounding with Bing Search resource** with the available [deployment template](../../quickstart.md#choose-basic-or-standard-agent-setup). After the deployment, you can find your resources including: an AI hub, project, Grounding with Bing Search resource and more created in your resource group. You can find your Grounding with Bing Search connection in the **connected resources** for your project in Azure AI Foundry portal.
+ 
+:::image type="content" source="../../media/tools/bing/connected-resources.png" alt-text="A screenshot showing the connected resources for a project in the Azure AI Foundry portal." lightbox="../../media/tools/bing/connected-resources.png":::
+ 
+1. If you already have a Grounding with Bing Search resource, you can provide your resource ID in the bicep file. Your resource ID should be in this format `/subscriptions/{subscription ID}/resourceGroups/{resource group name}/providers/Microsoft.Bing/accounts/{resource name}`. Replace the following empty string with your resource ID:
+    ```bicep
+    @description('The full ARM Bing Resource ID. This is an optional field, and if not provided, the resource will be created.')
+    param bingSearchResourceID string = ''
+    ```
+ 
+ 
+Alternatively, you can also follow the step-by-step guide below:
 
 1. Create a standard Azure AI Agent by following the steps in the [quickstart](../../quickstart.md).
 

articles/ai-services/agents/how-to/tools/openapi-spec.md

@@ -42,14 +42,27 @@ work together, generate client code, create tests, apply design standards, and m
        :::image type="content" source="../../media/tools/bing/project-connections.png" alt-text="A screenshot of the connections screen for the AI project." lightbox="../../media/tools/bing/project-connections.png":::
 
    1. Select **custom keys** in **other resource types**.
-    ![image](https://github.com/user-attachments/assets/2e6e8efe-1a31-4097-a859-58ac5ee17a96)
+
+        :::image type="content" source="../../media/tools/bing/api-key-connection.png" alt-text="A screenshot of the custom keys selection for the AI project." lightbox="../../media/tools/bing/api-key-connection.png":::
 
    1. Enter the following information
       - `key`: "key"
       - value: YOUR_API_KEY
       - Connection name: `YOUR_CONNECTION_NAME` (You will use this connection name in the sample code below.)
       - Access: you can choose either *this project only* or *shared to all projects*. Just make sure in the sample code below, the project you entered connection string for has access to this connection.
-        
+     
+    1. Update your OpenAPI Spec with the following:
+    ```json
+        "components": {
+        "securitySchemes": {
+          "cosoLocationApiLambdaAuthorizer": {
+            "type": "apiKey",
+            "name": "key",
+            "in": "query"
+          }
+        }
+      }
+    ```
 ::: zone-end
 
 ::: zone pivot="code-example"

articles/ai-services/agents/how-to/tools/overview.md

@@ -26,15 +26,17 @@ Agents can access multiple tools in parallel. These can be both Azure OpenAI-hos
 
 ## Knowledge tools
 
-|Tool  |Description  |
-|---------|---------|
-| [Grounding with Bing Search](./bing-grounding.md)     | Allows your agents to incorporate real-time public web data when generating responses.         |
-|[File search](./file-search.md)    | Augments agents with knowledge from outside its model, such as proprietary product information or documents provided by your users.        |
+|Tool  |Description  | Python SDK |	C# SDK | JavaScript SDK |
+|---------|---------|---------|---------|---------|
+| [Grounding with Bing Search](./bing-grounding.md)     | Allows your agents to incorporate real-time public web data when generating responses.         | ✔️ | ✔️ | ✔️ |
+|[File search](./file-search.md)    | Augments agents with knowledge from outside its model, such as proprietary product information or documents provided by your users.        | ✔️ | ✔️ | ✔️ |
+| [Azure AI Search](./azure-ai-search.md) | Uses an existing Azure AI Search index as a knowledge base. | ✔️ | ✔️ | ✔️ |
 
 ## Action tools
 
-|Tool  |Description  |
-|---------|---------|
-| [Code interpreter](./code-interpreter.md)     | Enables agents to write and run Python code in a sandboxed execution environment.        |
-|[Function calling](./function-calling.md)     | Allows you to describe the structure of functions to an agent and then return the functions that need to be called along with their arguments.        |
+|Tool  |Description  | Python SDK |	C# SDK | JavaScript SDK |
+|---------|---------|---------|---------|---------|
+| [Code interpreter](./code-interpreter.md)     | Enables agents to write and run Python code in a sandboxed execution environment.        | ✔️ | ✔️ | ✔️ |
+|[Function calling](./function-calling.md)     | Allows you to describe the structure of functions to an agent and then return the functions that need to be called along with their arguments.        | ✔️ | ✔️ | ✔️ |
+| [OpenAPI specified tools](./openapi-spec.md) | Connects your Azure AI Agent to an external API using an OpenAPI 3.0 specified tool. | ✔️ | | |