AEM Development Agent を使用した CI/CD Pipeline のトラブルシューティング

BylineImpl.java ファイルに次のような単体テストの失敗が導入されました。 独自のAEM プロジェクトを使用している場合、同様の単体テストのエラーが発生する可能性があります。

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

WKND Sites プロジェクト ​ をローカルマシンに複製し、プロジェクトディレクトリに移動して、tutorial/dev-agent/unit-test-failure ブランチに切り替えます。

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

WKND サイトプロジェクト用の新しいCloud Manager Git リポジトリを作成し、リモートとしてローカル Git リポジトリに追加します。

• Adobe Cloud Manager に移動し、プログラムを選択します。

• 左側のサイドバーで リポジトリ をクリックします。

• 右上隅の リポジトリを追加 をクリックします。

• リポジトリ名 を入力し（「wknd-site-tutorial」など）、「保存」をクリックします。 リポジトリが作成されるのを待ちます。

  

• 右上隅の リポジトリ情報にアクセス をクリックし、リポジトリ URL をコピーします。

  

• 新しく作成したCloud Manager Git リポジトリを、リモートとしてローカル Git リポジトリに追加します。

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

ローカル Git リポジトリをCloud Manager Git リポジトリにプッシュします。

git push adobe

資格情報の入力を求められたら、ユーザー名​および​ パスワード ​を Cloud Manager の​ リポジトリ情報 ​モーダルから指定します。

Cloud Managerで、「パイプライン」セクションに移動して、追加/実稼動以外のパイプラインを追加 を選択します。

実稼動以外のパイプラインを追加 ダイアログで、以下を設定します。

• 設定 手順：

  • 「パイプラインタイプ」などのデフォルト値は Code Quality Pipeline として、「デプロイメントトリガー を Manual として維持します。
  • 「実稼動以外のパイプライン名」に Code Quality::Fullstack と入力します。

  

• Source コード 手順：

  • 「フルスタックコード」を選択します。
  • リポジトリ については、新しく作成したCloud Manager Git リポジトリを選択します。
  • Git ブランチ の場合は、「tutorial/dev-agent/unit-test-failure」を選択します
  • 「保存」をクリックします。

  

パイプラインエントリの 3 ドットメニューにある「実行 をクリックして、新しく作成したコード品質パイプラインを実行します。

右上隅にある AI アシスタント アイコンをクリックします。

パイプライン失敗の詳細を、自然言語 プロンプト で入力します。 例：

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

AEM開発エージェント が呼び出され、失敗したパイプラインの実行のトラブルシューティングと修正が行われます。

推論が完了したら、「フルスクリーンで開く アイコンをクリックして、詳細なトラブルシューティングプロセスを表示します。

結果には、エラーの詳細、ソースファイル、行番号、問題を解決する明確な手順を示す 修正方法 セクションなど、貴重なインサイトが含まれています。

この場合、エージェントは、問題を修正するために、実装を変更する（getName() の方法）か、単体テストを更新する（getNameTest() の方法）かを正しく提案しました。 幻覚を避け、開発者に実用的なコード変更を提供しながら、Human-in-the-Loop アプローチを使用しました。

BylineImpl.java ファイルを推奨されるコード変更で更新し、変更内容をコミットしてCloud Manager Git リポジトリにプッシュします。

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

パイプラインを再度実行し、正常に実行されたことを確認します。