Optimize chat results for migrating Java apps to Azure

This quickstart shows you how to optimize chat results by using the AppModernization custom agent to migrate Java applications to Azure. The AppModernization custom agent is optimized for application modernization tasks and enables you to use simple, natural language prompts to perform complex migration scenarios.

Prerequisites

• A GitHub account with an active GitHub Copilot subscription under any plan.
• One of the following IDEs:
  • The latest version of Visual Studio Code. Must be version 1.106 or later.
    • GitHub Copilot in Visual Studio Code. For setup instructions, see Set up GitHub Copilot in Visual Studio Code. Be sure to sign in to your GitHub account within Visual Studio Code.
    • GitHub Copilot app modernization. Restart Visual Studio Code after installation.
  • The latest version of IntelliJ IDEA. Must be version 2023.3 or later.
    • GitHub Copilot. Must be version 1.5.59 or later. For more instructions, see Set up GitHub Copilot in IntelliJ IDEA. Be sure to sign in to your GitHub account within IntelliJ IDEA.
    • GitHub Copilot app modernization. Restart IntelliJ IDEA after installation. If you don't have GitHub Copilot installed, you can install GitHub Copilot app modernization directly.
• Java 21 or later.
• Maven or Gradle to build Java projects.

Note

If you're using Gradle, only the Gradle wrapper version 5+ is supported. The Kotlin Domain Specific Language (DSL) isn't supported.

The function My Tasks isn't supported yet for IntelliJ IDEA.

Select the AppModernization custom agent

The AppModernization custom agent provides the best experience for Java application migration and modernization tasks. Use the following steps to select it:

1. Open Visual Studio Code and ensure you have the GitHub Copilot app modernization extension installed.

2. Open the Copilot chat window by selecting the chat icon in the Activity Bar.

3. In the chat window, locate the agent selector dropdown menu at the top of the chat input box and select AppModernization from the list. This custom agent is designed for Java application modernization and migration scenarios.

   

Note

Although you can select different language models in the chat window, Claude Sonnet 4.5 is the tested and recommended model for best results with Java application modernization tasks.

Important

The AppModernization custom agent is currently available only for Visual Studio Code.

Use simple prompts for migration

With the AppModernization agent selected, use simple, natural language prompts to perform migration tasks. The agent understands migration context and can handle complex scenarios with minimal input.

Example: Migrate from RabbitMQ to Azure Service Bus

1. Make sure you have a Java project open in Visual Studio Code that uses RabbitMQ.

2. In the Copilot chat window with the AppModernization agent selected, enter the following prompt:

   migrate from rabbitmq to Azure service bus
   

3. The agent analyzes your code, creates a migration plan, makes code changes, runs validations, and generates a summary. Select Continue to proceed through each step and Keep to accept the changes.

Other migration scenarios

The AppModernization agent supports various migration scenarios with simple prompts. Here are more examples:

• Database migration:

  migrate from Oracle to Azure PostgreSQL
  

• Authentication migration:

  migrate to Managed Identity for Azure SQL Database
  

• Storage migration:

  migrate from AWS S3 to Azure Storage Blob
  

• Messaging migration:

  migrate from ActiveMQ to Azure Service Bus
  

• Secret management:

  migrate secrets to Azure Key Vault
  

Next steps

• Quickstart: assess and migrate a Java project
• Quickstart: create and apply your own tasks
• Predefined tasks for GitHub Copilot app modernization