Skip to content

Commit 657909c

Browse files
authored
update agent service name and add more context on why this tool is important
1 parent 196eb9d commit 657909c

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

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)

0 commit comments

Comments
 (0)