Skip to content

Commit 3d2d3d3

Browse files
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into us423405-01
2 parents 657c5cf + 5ee3c97 commit 3d2d3d3

File tree

511 files changed

+2606
-22729
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

511 files changed

+2606
-22729
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/private-multi-access-edge-compute-mec/index.yml",
5+
"redirect_url": "/previous-versions/azure/private-multi-access-edge-compute-mec/index",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path": "articles/network-watcher/traffic-analytics-schema-update.md",
510
"redirect_url": "/previous-versions/azure/network-watcher/traffic-analytics-schema-update",

articles/api-management/api-management-region-availability.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: concept-article
9-
ms.date: 04/29/2025
9+
ms.date: 05/28/2025
1010
ms.author: danlep
1111
ms.custom: references_regions
1212
---
@@ -47,12 +47,10 @@ Information in the following table is updated regularly. Capacity availability i
4747
| Switzerland North ||| | |
4848
| UK South |||||
4949
| UK West ||| | |
50-
| West Europe ||| |<sup>1</sup> |
50+
| West Europe ||| ||
5151
| West US ||| ||
5252
| West US 2 ||| | |
5353

54-
<sup>1</sup> Request access to this region by emailing `[email protected]`
55-
5654
## Related content
5755

5856
Learn more about:

articles/app-service/includes/quickstart-java/quickstart-java-javase.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,7 @@ With all the configuration ready in your [pom.xml](https://github.com/Azure-Samp
205205
Once you select from a list of available subscriptions, Maven deploys to Azure App Service. When the deployment completes, you see the following output:
206206
207207
```output
208-
[INFO] Successfully deployed the artifact to https://<app-name>.azurewebsites.net
208+
[INFO] Successfully deployed the artifact to <URL>
209209
[INFO] ------------------------------------------------------------------------
210210
[INFO] BUILD SUCCESS
211211
[INFO] ------------------------------------------------------------------------
@@ -214,23 +214,23 @@ With all the configuration ready in your [pom.xml](https://github.com/Azure-Samp
214214
[INFO] ------------------------------------------------------------------------
215215
```
216216
217-
Your application is ready at `http://<appName>.azurewebsites.net/`.
217+
Your application is ready.
218218
219219
### [Spring Boot](#tab/springboot)
220220
221-
Open the URL `http://<appName>.azurewebsites.net/greeting` with your local web browser (note the `/greeting` path), and you should see:
221+
Get the default domain for your app in the Azure portal by selecting **Overview** for your app. Append `/greeting`. You should see:
222222
223223
:::image type="content" source="../../media/quickstart-java/springboot-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Spring Boot Hello World web app running in Azure App Service.":::
224224
225225
### [Quarkus](#tab/quarkus)
226226
227-
Open the URL `http://<appName>.azurewebsites.net/hello` with your local web browser (note the `/hello` path), and you should see:
227+
Get the default domain for your app in the Azure portal by selecting **Overview** for your app. Append `/hello`. You should see:
228228
229229
:::image type="content" source="../../media/quickstart-java/quarkus-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Quarkus web app running in Azure App Service.":::
230230
231231
### [Embedded Tomcat](#tab/embeddedtomcat)
232232
233-
Open the URLl with your local web browser, and you should see:
233+
Open the URL with your local web browser, and you should see:
234234
235235
:::image type="content" source="../../media/quickstart-java/embedded-tomcat-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of embedded Tomcat web app running in Azure App Service.":::
236236

articles/app-service/includes/quickstart-java/quickstart-java-jboss.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ With all the configuration ready in your *pom.xml* file, you can deploy your Jav
120120
mvn package azure-webapp:deploy -DskipTests
121121
```
122122

123-
Once you select from a list of available subscriptions, Maven deploys to Azure App Service. When deployment completes, your application is ready at `http://<appName>.azurewebsites.net/` (`http://petstoreee7-1745409173307.azurewebsites.net` in the demo). Open the URL with your local web browser, you should see
123+
Once you select from a list of available subscriptions, Maven deploys to Azure App Service. When deployment completes, your application is ready. In this demo, the URL is `http://petstoreee7-1745409173307.azurewebsites.net`. Open the URL with your local web browser, you should see
124124

125125
![Screenshot of Maven Hello World web app running in Azure App Service.](../../media/quickstart-java/jboss-sample-in-app-service.png)
126126

articles/app-service/includes/quickstart-java/quickstart-java-linux-maven-pivot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ mvn package azure-webapp:deploy -DskipTests
266266

267267
-----
268268

269-
Once deployment is completed, your application is ready at `http://<appName>.azurewebsites.net/` (`http://helloworld-1590394316693.azurewebsites.net` in the demo). Open the url with your local web browser, you should see
269+
Once deployment is completed, your application is ready at `http://helloworld-1590394316693.azurewebsites.net` in the demo. Open the url with your local web browser, you should see
270270

271271
# [Java SE](#tab/javase)
272272

articles/app-service/includes/quickstart-java/quickstart-java-tomcat.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ With all the configuration ready in your *pom.xml* file, you can deploy your Jav
110110
```azurecli-interactive
111111
mvn package azure-webapp:deploy
112112
```
113-
Once you select from a list of available subscriptions, Maven deploys to Azure App Service. When deployment completes, your application is ready at `http://<appName>.azurewebsites.net/` (`http://helloworld-1745408005556.azurewebsites.net` in the demo). Open the URL with your local web browser, you should see
113+
Once you select from a list of available subscriptions, Maven deploys to Azure App Service. When deployment completes, your application is ready. In this demo, the URL is `http://helloworld-1745408005556.azurewebsites.net`. Open the URL with your local web browser, you should see
114114

115115
![Screenshot of Maven Hello World web app running in Azure App Service.](../../media/quickstart-java/java-hello-world-in-browser-azure-app-service.png)
116116

articles/app-service/includes/quickstart-php/quickstart-php-windows-pivot.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ To complete this quickstart:
7878
When the web app has been created, the Azure CLI shows output similar to the following example:
7979
8080
<pre>
81-
Local git is configured with url of 'https://&lt;username&gt;@&lt;app-name&gt;.scm.azurewebsites.net/&lt;app-name&gt;.git'
81+
Local git is configured with url of &lt;URL>
8282
{
8383
"availabilityState": "Normal",
8484
"clientAffinityEnabled": true,
@@ -95,14 +95,10 @@ To complete this quickstart:
9595
You've created an empty new web app, with git deployment enabled.
9696

9797
> [!NOTE]
98-
> The URL of the Git remote is shown in the `deploymentLocalGitUrl` property, with the format `https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git`. Save this URL as you need it later.
98+
> The URL of the Git remote is shown in the `deploymentLocalGitUrl` property. Save this URL as you need it later.
9999
>
100100

101-
1. Browse to your newly created web app. Replace _&lt;app-name>_ with your unique app name created in the prior step.
102-
103-
```bash
104-
http://<app-name>.azurewebsites.net
105-
```
101+
1. Browse to your newly created web app.
106102

107103
Here's what your new web app should look like:
108104
@@ -131,18 +127,14 @@ To complete this quickstart:
131127
remote: Finished successfully.
132128
remote: Running post deployment command(s)...
133129
remote: Deployment successful.
134-
To https://&lt;app-name&gt;.scm.azurewebsites.net/&lt;app-name&gt;.git
130+
To &lt;URL>
135131
cc39b1e..25f1805 main -> main
136132
</pre>
137133
138134
## Browse to the app
139135
140136
Browse to the deployed application using your web browser.
141137
142-
```
143-
http://<app-name>.azurewebsites.net
144-
```
145-
146138
The PHP sample code is running in an Azure App Service web app.
147139
148140
![Sample app running in Azure](../../media/quickstart-php/hello-world-in-browser.png)

articles/app-service/invoke-openapi-web-app-from-azure-ai-agent-service.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
---
2-
title: 'Invoke an OpenAPI App Service web app from Azure AI Agent Service'
3-
description: Learn how to integrate App Service with AI Agent Service and get started with agentic AI
2+
title: 'Invoke an OpenAPI App Service web app from Azure AI Foundry Agent Service'
3+
description: Learn how to integrate App Service with AI Foundry Agent Service and get started with agentic AI
44
author: seligj95
55
ms.author: jordanselig
6-
ms.date: 04/25/2025
6+
ms.date: 05/28/2025
77
ms.topic: article
88
ms.custom: devx-track-dotnet
99
ms.collection: ce-skilling-ai-copilot
1010
---
1111

12-
# Invoke an OpenAPI App Service web app from Azure AI Agent Service
12+
# Invoke an OpenAPI App Service web app from Azure AI Foundry Agent Service
1313

14-
[Azure AI Agent Service](/azure/ai-services/agents/overview) allows you to create AI agents tailored to your needs through custom instructions and augmented by advanced tools like code interpreter, and custom functions. You can now connect your Azure AI Agent to an external API using an [OpenAPI 3.0](https://www.openapis.org/what-is-openapi) specified tool, allowing for scalable interoperability with various applications.
14+
[Azure AI Foundry Agent Service](/azure/ai-services/agents/overview) allows you to create AI agents tailored to your needs through custom instructions and augmented by advanced tools like code interpreter, and custom functions. You can now connect your Azure AI Agent to an external API using an [OpenAPI 3.0](https://www.openapis.org/what-is-openapi) specified tool, allowing for scalable interoperability with various applications.
1515

16-
Azure App Service is a fully managed platform for building, deploying, and scaling web apps and APIs. If your API is hosted on Azure App Service, you can connect your AI Agent to the API using the OpenAPI specification. The OpenAPI specification defines the API and how to interact with it. You can then use natural language to invoke the API through your AI Agent.
16+
Azure App Service is a fully managed platform for building, deploying, and scaling web apps and APIs. If your API is hosted on Azure App Service, you can connect your AI Agent to the API using the OpenAPI specification. The OpenAPI specification defines the API and how to interact with it. You can then use natural language to invoke the API through your AI Agent. This tool is powerful because it allows you to add AI agent capabilities to your existing apps with minimal code changes. Also, this agent has the ability to directly interact with your app. There's no need for significant code changes or implementation work other thank minor updates to interact with the agent using the available SDKs.
1717

18-
In this tutorial, you're using an Azure AI Agent to invoke an API hosted on Azure App Service. By the end of this tutorial, you have a fashion assistant chat application running in App Service using an AI agent from the Azure AI Agent Service.
18+
In this tutorial, you're using an Azure AI Foundry Agent to invoke an existing API hosted on Azure App Service. By the end of this tutorial, you have a fashion assistant chat application running in App Service using an AI agent from the Azure AI Foundry Agent Service.
1919

2020
:::image type="content" source="media/invoke-openapi-web-app-from-azure-ai-agent-service/browse-app.png" alt-text="A screenshot showing an AI agent running within App Service.":::
2121

@@ -137,10 +137,10 @@ azd down
137137
1. **Chat Not Working**
138138
- Verify that the environment variables (`AzureAIAgent__ConnectionString` and `AzureAIAgent__AgentId`) are correctly set in the App Service environment variables.
139139
- Check that the AI Agent is properly created and configured with the correct OpenAPI tool.
140-
- Ensure the OpenAPI specification URL is accessible from the Azure AI Agent Service.
140+
- Ensure the OpenAPI specification URL is accessible from the Azure AI Foundry Agent Service.
141141
- Ensure the App Service URL is updated in the `swagger.json` provided to the OpenAPI Specified Tool.
142142
1. **Permission Issues**
143-
- If you encounter authentication errors, ensure that your App Service's managed identity has proper permissions to access the Azure AI Agent Service. The managed identity needs at least the `Microsoft.MachineLearningServices/workspaces/agents/action` permission to interact with the Agent. The provided "Azure AI Developer role" has this permission and should be sufficient. If you decide to change this role, be sure it has the necessary permission.
143+
- If you encounter authentication errors, ensure that your App Service's managed identity has proper permissions to access the Azure AI Foundry Agent Service. The managed identity needs at least the `Microsoft.MachineLearningServices/workspaces/agents/action` permission to interact with the Agent. The provided "Azure AI Developer role" has this permission and should be sufficient. If you decide to change this role, be sure it has the necessary permission.
144144
1. **API Issues**
145145
- If the agent is unable to perform actions on the inventory or cart, check the API routes in the OpenAPI specification.
146146
- Verify that the API endpoints are responding correctly by testing them directly in the Swagger UI at `/api/docs`.
@@ -183,7 +183,7 @@ Beyond basic interactions, the AI agent can handle more complex scenarios:
183183
184184
## Security Considerations
185185
186-
- The application uses Azure managed identities for secure authentication to Azure AI Agent Service in production environments.
186+
- The application uses Azure managed identities for secure authentication to Azure AI Foundry Agent Service in production environments.
187187
- You can further secure your app and agent using any of the standard practices and Azure resources. For secure Azure AI Agent infrastructure templates, see the [azureai-samples repo](https://github.com/Azure-Samples/azureai-samples/tree/main/scenarios/Agents/setup).
188188
189189
## Next steps
@@ -197,4 +197,4 @@ Now that you learned how to connect your AI Agent to an API on Azure App Service
197197
> [Tutorial: Run chatbot in App Service with a Phi-4 sidecar extension (ASP.NET Core)](tutorial-ai-slm-dotnet.md)
198198
199199
> [!div class="nextstepaction"]
200-
> [Deploy a .NET Blazor app connected to Azure SQL and Azure OpenAI on Azure App Service](./deploy-intelligent-apps-dotnet-to-azure-sql.md)
200+
> [Deploy a .NET Blazor app connected to Azure SQL and Azure OpenAI on Azure App Service](./deploy-intelligent-apps-dotnet-to-azure-sql.md)

articles/app-service/overview-access-restrictions.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,8 @@ In this scenario, you're accessing your site through a private endpoint and are
130130

131131
Traffic from Azure Front Door to your application originates from a well known set of IP ranges defined in the `AzureFrontDoor.Backend` service tag. Using a service tag restriction rule, you can restrict traffic to only originate from Azure Front Door. To ensure traffic only originates from your specific instance, you need to further filter the incoming requests based on the unique http header that Azure Front Door sends called X-Azure-FDID. You can find the Front Door ID in the portal.
132132

133+
Alternatively, [Azure Private Link](../frontdoor/private-link.md) enables you to access Azure PaaS services and services hosted in Azure over a private endpoint in your virtual network. Traffic between your virtual network and the service goes over the Microsoft backbone network, eliminating exposure to the public Internet. Azure Front Door Premium can connect to your origin using Private Link. Your origin can be hosted in a virtual network or hosted as a PaaS service such as an Azure Web App. Private Link removes the need for your origin to be accessed publicly. To learn how to connect Azure Front Door to your App Service app with private link, see [Connect Azure Front Door Premium to an App Service (Web App or Function App) origin with Private Link](../frontdoor/standard-premium/how-to-enable-private-link-web-app.md).
134+
133135
## Next steps
134136
> [!NOTE]
135137
> Access restriction rules that block public access to your site can also block services such as log streaming. If you require these, you will need to allow your App Service's IP address in your restrictions.

articles/app-service/tutorial-connect-app-access-sql-database-as-user-dotnet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -273,7 +273,7 @@ The most common causes of this error are:
273273
Because App Service authentication is a feature in Azure, it's not possible for the same code to work in your local environment. Unlike the app running in Azure, your local code doesn't benefit from the authentication middleware from App Service. You have a few alternatives:
274274

275275
- Connect to SQL Database from your local environment with [`Active Directory Interactive`](/sql/connect/ado-net/sql/azure-active-directory-authentication#using-active-directory-interactive-authentication). The authentication flow doesn't sign in the user to the app itself, but it does connect to the back-end database with the signed-in user, and allows you to test database authorization locally.
276-
- Manually copy the access token from `https://<app-name>.azurewebsites.net/.auth/me` into your code, in place of the `X-MS-TOKEN-AAD-ACCESS-TOKEN` request header.
276+
- Manually copy the access token into your code, in place of the `X-MS-TOKEN-AAD-ACCESS-TOKEN` request header.
277277
- If you deploy from Visual Studio, use remote debugging of your App Service app.
278278

279279
#### What happens when access tokens expire?

0 commit comments

Comments
 (0)