Troubleshoot CI/CD Pipeline using AEM Development Agent

A unit test failure has been introduced in the BylineImpl.java file as follows. If you’re using your own AEM project, you can introduce a similar unit test failure.

...
@Override
public String getName() {
    if (name != null) {
        return "Author: " + name; // This line is intentionally incorrect to introduce a unit test failure.
    }
    return name;
}
...

Clone the WKND Sites Project to your local machine, navigate to the project directory, and switch to the tutorial/dev-agent/unit-test-failure branch.

git clone https://github.com/adobe/aem-guides-wknd.git
cd aem-guides-wknd
git checkout tutorial/dev-agent/unit-test-failure

Create a new Cloud Manager Git repository for the WKND Sites Project and add it as a remote to your local Git repository:

• Navigate to Adobe Cloud Manager and select your program.

• Click Repositories in the left sidebar.

• Click Add Repository in the top right corner.

• Enter a Repository Name (for example, “wknd-site-tutorial”) and click Save. Wait for the repository to be created.

  

• Click Access Repo Info in the top right corner and copy the repository URL.

  

• Add the newly created Cloud Manager Git repository as a remote to your local Git repository:

  code language-shell
  git remote add adobe https://git.cloudmanager.adobe.com/<your-adobe-organization>/wknd-site-tutorial/

Push your local Git repository to the Cloud Manager Git repository:

git push adobe

When prompted for credentials, provide the Username and Password from Cloud Manager’s Repository Info modal.

In Cloud Manager, navigate to the Pipelines section and select Add > Add Non-Production Pipeline.

In the Add Non-Production Pipeline dialog, configure the following:

• Configuration step:

  • Keep the default values like Pipeline Type as Code Quality Pipeline and Deployment Trigger as Manual.
  • For Non-Production Pipeline Name, enter Code Quality::Fullstack

  

• Source Code step:

  • Select Full Stack Code
  • For Repository, select the newly created Cloud Manager Git repository
  • For Git Branch, select tutorial/dev-agent/unit-test-failure
  • Click Save

  

Run the newly created Code Quality pipeline by clicking Run in the three-dot menu of the pipeline entry.

Click the AI Assistant icon in the top right corner.

Enter the pipeline failure details in natural language aka Prompt. For example:

I have a failed pipeline execution on %PROGRAM-NAME% program, help me to troubleshoot and fix it.

The AEM Development Agent is invoked to troubleshoot and fix the failed pipeline execution.

Once the reasoning is complete, click the Open in full screen icon to view the detailed troubleshooting process.

The results contain valuable insights including error details, the source file, line number, and a How to Fix section with clear steps to resolve the issue.

In this case, the agent correctly suggested either changing the implementation (getName() method) or updating the unit test (getNameTest() method) to fix the issue. It avoided hallucination and used a human-in-the-loop approach while providing actionable code changes for the developer.

Update the BylineImpl.java file with the suggested code changes, then commit and push the changes to the Cloud Manager Git repository.

...
@Override
public String getName() {
    return name;
}
...

Run the pipeline again and observe the successful execution.