Skip to content

Commit 32e9f0d

Browse files
committed
validation
1 parent 86a8bf6 commit 32e9f0d

7 files changed

+21
-17
lines changed
87 KB
Loading
92.7 KB
Loading

articles/app-service/tutorial-ai-agent-web-app-semantic-kernel-java.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Agentic app with Semantic Kernel or Azure AI Foundry (.NET)
2+
title: Agentic app with Semantic Kernel (Java)
33
description: Learn how to quickly deploy a production-ready, agentic web application using Java with Azure App Service and Microsoft Semantic Kernel.
44
ms.service: azure-app-service
55
author: cephalin
@@ -8,7 +8,7 @@ ms.devlang: csharp
88
ms.topic: tutorial
99
ms.date: 07/16/2025
1010
ms.custom:
11-
- devx-track-dotnet
11+
- devx-track-java
1212
ms.collection: ce-skilling-ai-copilot
1313
---
1414

@@ -18,7 +18,7 @@ This tutorial demonstrates how to add agentic capability to an existing data-dri
1818

1919
If your web application already has useful features, like shopping, hotel booking, or data management, it's relatively straightforward to add agent functionality to your web application by wrapping those functionalities in a plugin (for Semantic Kernel). In this tutorial, you start with a simple to-do list app. By the end, you'll be able to create, update, and manage tasks with an agent in an App Service app.
2020

21-
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-kernel-foundry-dotnet/semantic-kernel-agent.png" alt-text="Screenshot of a chat completion session with a semantic kernel agent.":::
21+
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-kernel-java/semantic-kernel-agent.png" alt-text="Screenshot of a chat completion session with a semantic kernel agent.":::
2222

2323
> [!NOTE]
2424
> Azure AI Foundry Agent Service currently doesn't have a Java SDK, so isn't included in the scope of this article.
@@ -32,7 +32,7 @@ In this tutorial, you learn how to:
3232

3333
## Prerequisites
3434

35-
- An Azure account with an active subscription - [Create an account for free](https://azure.microsoft.com/free/dotnet).
35+
- An Azure account with an active subscription - [Create an account for free](https://azure.microsoft.com/free/java).
3636
- GitHub account to use GitHub Codespaces - [Learn more about GitHub Codespaces](https://docs.github.com/codespaces/overview).
3737

3838
## Open the sample with Codespaces
@@ -48,7 +48,7 @@ The easiest way to get started is by using GitHub Codespaces, which provides a c
4848
4. Run the application locally:
4949

5050
```bash
51-
dotnet run
51+
mvn spring-boot:run
5252
```
5353

5454
5. When you see **Your application running on port 8080 is available**, select **Open in Browser** and add a few tasks.
@@ -64,11 +64,11 @@ You can find the initialization code in the `SemanticKernelAgentService` contruc
6464
- Creates a [chat completion agent](/semantic-kernel/frameworks/agent/agent-types/chat-completion-agent?pivots=programming-language-java), and configures it to let the AI model automatically invoke functions (`FunctionChoiceBehavior.auto(true)`).
6565
- Creates an agent thread that automatically manages the chat history.
6666

67-
:::code language="csharp" source="~/app-service-agentic-semantic-kernel-java/src/main/java/com/example/crudtaskswithagent/service/SemanticKernelAgentService.java" range="41-93" highlight="11-48,58" :::
67+
:::code language="csharp" source="~/app-service-agentic-semantic-kernel-java/src/main/java/com/example/crudtaskswithagent/service/SemanticKernelAgentService.java" range="38-90" highlight="11-48,58" :::
6868

6969
Each time the prompt is received, the server code uses ChatCompletionAgent.invokeAsync() invoke the agent with the user prompt.
7070

71-
:::code language="csharp" source="~/app-service-agentic-semantic-kernel-java/src/main/java/com/example/crudtaskswithagent/service/SemanticKernelAgentService.java" range="112-161" highlight="8" :::
71+
:::code language="csharp" source="~/app-service-agentic-semantic-kernel-java/src/main/java/com/example/crudtaskswithagent/service/SemanticKernelAgentService.java" range="109-158" highlight="8" :::
7272

7373
## Deploy the sample application
7474

@@ -111,13 +111,17 @@ Each time the prompt is received, the server code uses ChatCompletionAgent.invok
111111

112112
## Create and configure the Azure AI Foundry resource
113113

114-
1. In the [Azure AI Foundry portal](https://ai.azure.com), deploy a model of your choice (see [Quickstart: Get started with Azure AI Foundry](/azure/ai-foundry/quickstarts/get-started-code?tabs=azure-ai-foundry&pivots=fdp-project)). A project and a default agent are created for you in the process.
114+
1. In the [Azure AI Foundry portal](https://ai.azure.com), deploy a model of your choice (see [Quickstart: Get started with Azure AI Foundry](/azure/ai-foundry/quickstarts/get-started-code?tabs=azure-ai-foundry&pivots=fdp-project)). A project and a model deployment is created for you in the process.
115115

116116
1. From the left menu, select **Overview**.
117117

118118
1. Select **Azure OpenAI** and copy the URL in **Azure OpenAI endpoint** for later.
119119

120-
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-kernel-foundry-dotnet/foundry-project-endpoints.png" alt-text="Screenshot showing how to copy the OpenAI endpoint and the foundry project endpoint in the foundry portal.":::
120+
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-kernel-java/foundry-openai-endpoint.png" alt-text="Screenshot showing how to copy the OpenAI endpoint in the foundry portal.":::
121+
122+
1. Select **Models + endpoints** and copy the name of the model deployment for later.
123+
124+
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-kernel-java/foundry-model-deployment.png" alt-text="Screenshot showing how to copy the model deployment name in the foundry portal.":::
121125

122126
## Assign required permissions
123127

@@ -140,7 +144,7 @@ Each time the prompt is received, the server code uses ChatCompletionAgent.invok
140144
| Variable | Description |
141145
|-------------------------------|----------------------------------------------------------|
142146
| `azure.openai.endpoint` | Azure OpenAI endpoint (copied from the Overview page). This is needed by the Semantic Kernel agent. |
143-
| `azure.openai.deployment` | Model name in the deployment (copied from the Agents setup pane). This is needed by the Semantic Kernel agent. |
147+
| `azure.openai.deployment` | Model name in the deployment (copied from the Models + endpoints page). This is needed by the Semantic Kernel agent. |
144148

145149
> [!NOTE]
146150
> To keep the tutorial simple, you'll use these variables in *src/main/resources/application.properties* instead of overwriting them with app settings in App Service.
@@ -171,7 +175,7 @@ Each time the prompt is received, the server code uses ChatCompletionAgent.invok
171175

172176
1. Navigate to the deployed application again and test the chat agents.
173177

174-
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-java/semantic-kernel-agent.png" alt-text="Screenshot of a chat completion session with a semantic kernel agent.":::
178+
:::image type="content" source="media/tutorial-ai-agent-web-app-semantic-kernel-java/semantic-kernel-agent.png" alt-text="Screenshot of a chat completion session with a semantic kernel agent.":::
175179

176180
## Clean up resources
177181

articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Integrate web app with OpenAPI in Azure AI Foundry Agent Service (.NET)
3-
description: Empower your existing web apps by integrating their capabilities into Azure AI Foundry Agent Service with OpenAPI, enabling AI agents to perform real-world tasks.
3+
description: Empower your existing .NET web apps by integrating their capabilities into Azure AI Foundry Agent Service with OpenAPI, enabling AI agents to perform real-world tasks.
44
author: cephalin
55
ms.author: cephalin
66
ms.date: 06/16/2025

articles/app-service/tutorial-ai-integrate-azure-ai-agent-java.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Integrate web app with OpenAPI in Azure AI Foundry Agent Service (Java)
3-
description: Empower your existing web apps by integrating their capabilities into Azure AI Foundry Agent Service with OpenAPI, enabling AI agents to perform real-world tasks.
3+
description: Empower your existing Java web apps by integrating their capabilities into Azure AI Foundry Agent Service with OpenAPI, enabling AI agents to perform real-world tasks.
44
author: cephalin
55
ms.author: cephalin
66
ms.date: 07/16/2025
77
ms.topic: tutorial
88
ms.custom:
9-
- devx-track-dotnet
9+
- devx-track-java
1010
ms.collection: ce-skilling-ai-copilot
1111
---
1212

articles/app-service/tutorial-ai-model-context-protocol-server-dotnet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Web app as MCP server in GitHub Copilot Chat agent mode (.NET)
3-
description: Empower GitHub Copilot Chat with your existing web apps by integrating their capabilities as Model Context Protocol servers, enabling Copilot Chat to perform real-world tasks.
3+
description: Empower GitHub Copilot Chat with your existing .NET web apps by integrating their capabilities as Model Context Protocol servers, enabling Copilot Chat to perform real-world tasks.
44
author: cephalin
55
ms.author: cephalin
66
ms.date: 06/17/2025

articles/app-service/tutorial-ai-model-context-protocol-server-java.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Web app as MCP server in GitHub Copilot Chat agent mode (Java)
3-
description: Empower GitHub Copilot Chat with your existing web apps by integrating their capabilities as Model Context Protocol servers, enabling Copilot Chat to perform real-world tasks.
3+
description: Empower GitHub Copilot Chat with your existing Java web apps by integrating their capabilities as Model Context Protocol servers, enabling Copilot Chat to perform real-world tasks.
44
author: cephalin
55
ms.author: cephalin
66
ms.date: 07/16/2025
77
ms.topic: tutorial
88
ms.custom:
9-
- devx-track-dotnet
9+
- devx-track-java
1010
ms.collection: ce-skilling-ai-copilot
1111
---
1212

0 commit comments

Comments
 (0)