開発代理店の能力 development-agentic-capabilities

Adobe Experience Manager(AEM)as a Cloud Serviceの開発エージェンティック機能は、Coworker Chatと連携して、従来のAEM Java スタックの開発者および管理者が、より効率的にコードを作成、デバッグ、デプロイ、および最適化できるよう支援します。

ユースケース use-cases

さまざまなユースケースに対応:

Cloud Manager パイプラインの管理 aem-cloud-manager-pipeline-management

AEM Cloud Managerのパイプライン管理スキルを使用すると、Cloud Managerの画面を切り替えずに、必要な情報やコントロールを見つけながら、CI/CD パイプラインを自然言語で直接管理できます。 パイプラインのリスト作成、実行の開始またはキャンセル、ステータスと履歴の確認など、あらゆる作業を1つの会話から実行できます。

何か問題が発生した場合、スキルはステータスチェックにとどまりません。ステップ指標、ログ、アーティファクト、実行エラーなどを取得できるため、生のログファイルを自分でダウンロードして検索することなく、問題を診断できます。 また、日々のパイプライン設定(パイプライン変数の管理、キャッシュされたアーティファクトの無効化、パイプライン設定の調整)も処理できるので、UIを通じて数回クリックする必要があった日常的なメンテナンスタスクは、1回のリクエストで完了できます。

実行が失敗した理由については、AEM Cloud Manager パイプラインのトラブルシューティング ​を参照してください。

AIはミスを起こす可能性があるため、提案されたアクションを適用する前に、特に破壊的な運用に対して、そのアクションをレビューする必要があります。

機能
サンプルプロンプト
パイプラインの一覧表示
「プログラム 12345のパイプラインのリスト」

「メインプログラムにはどのようなパイプラインがありますか?」
パイプラインの作成
「プログラム 12345の新しいフルスタックパイプラインの作成」

「開発環境用のコード品質パイプラインの設定」
パイプラインの実行
「開発パイプラインの実行」

「パイプラインの実行67890開始」
実行中のパイプラインステップのキャンセル
「開発パイプラインの現在のビルドステップをキャンセル」

「実行12345ージの実行中のコードスキャンステップを停止」
実行履歴とステータスの表示
「現在のパイプライン実行のステータスは?」

「開発パイプラインの最後の5回の実行を表示」
ステップ指標の取得
「実行12345のビルドステップ指標を表示する」

「前回の実行でコードスキャンステップにかかる時間はどれくらいですか?」
ログの取得
「パイプライン実行のビルド ログ リンクを取得する12345」

「失敗したコードスキャン手順のログを取得する」
アーティファクトの取得
「実行12345によって生成されたアーティファクトを表示する」

「前回の実行からビルドアーティファクトをどこでダウンロードできますか?」
実行エラーの取得
「開発パイプラインの実行が失敗した理由を教えてください。」

「今週のプログラム 12345の失敗した実行をすべて一覧表示します。」
パイプライン変数の管理
「開発パイプラインの変数を表示する」

「パイプライン 67890のAPI_ENDPOINT変数を更新する」
キャッシュされたアーティファクトの無効化
「開発パイプラインのキャッシュされたアーティファクトを無効にする」

「次の実行前にビルド キャッシュをクリアする」
パイプライン設定の設定
「開発パイプラインのメール通知を有効にする」

「パイプライン 67890ータをリリースするトリガーブランチを変更する」

AEM Cloud Manager パイプラインのトラブルシューティング aem-cloud-manager-pipeline-troubleshooting

AEM Cloud Manager パイプラインのトラブルシューティングスキルを使用すると、生のログファイルを自分でダウンロードして検索することなく、パイプラインの実行が失敗した理由を確認できます。 パイプライン名または実行IDで失敗した実行を参照すると、スキルはCloud Managerでの失敗を確認し、失敗したステップを特定し、何が問題だったのか、なぜ、次に何をすべきかを簡単な言葉で説明します。 リクエストが複数のパイプラインと一致する場合、続行する前に1つを選択するように求められます。

この機能はスペシャリストエージェントとして実装されているため、Coworker Customizations インターフェイスにリストされたスキルとして視覚的に表示されません。

スキルは、次のパイプラインと手順でエラーを調査します。

  • フルスタックのデプロイメントとコード品質パイプラインのビルドとユニットテストの手順とコードスキャンの手順。
  • Dispatcher設定の検証エラーなど、web階層設定パイプライン ​のビルドおよびコード品質エラー。
  • 無効なCDN設定など、設定パイプライン ​のデプロイメントエラー。

フルスタックパイプラインのデプロイメントステップなど、その他のステップで失敗した場合、スキルは失敗したステップを診断せずに報告します。 その場合は、​ ログへのアクセスとログのダウンロード ​で説明されているようにログを調べるか、Adobe サポートにお問い合わせください。

プロンプトを書かずにトラブルシューティングを開始することもできます。 Cloud Managerで失敗したパイプラインの実行、またはExperience Manager ホームページの​失敗したパイプライン ウィジェットで「AI​でトラブルシューティング」をクリックして、既に参照されている実行でCoworkerを開きます。 失敗したパイプラインのトラブルシューティング Cloud Managerおよび失敗したパイプラインのトラブルシューティング ウィジェット ​を参照してください。

AIは間違いを犯す可能性があるので、診断に反応する前に診断を確認してください。

機能
サンプルプロンプト
失敗したパイプラインのトラブルシューティング
「失敗したパイプラインのトラブルシューティング」

「メインプログラムで失敗した最後のパイプラインのトラブルシューティングを支援」
特定の実行のトラブルシューティング
「パイプライン実行のトラブルシューティング 1234567」

「プログラム 12345ークフローでの開発パイプラインの実行1234567のトラブルシューティング」
Web層と設定パイプラインのトラブルシューティング
「パイプライン 67890でweb層ビルドのエラーをデバッグする」

「プログラム 12345で設定パイプラインのデプロイメントが失敗した理由を教えてください」

権限 pipeline-troubleshooting-permissions

AEM Cloud Manager パイプラインのトラブルシューティングスキルを使用するには、Cloud Managerで​ Developer ​または​ Program Manager ​の役割を持っている必要があります。 役割ベースの権限を参照してください。

Cloud Managerからの失敗したパイプラインのトラブルシューティング troubleshoot-from-cloud-manager

Coworkerは実行をコンテキストとして受け取り、プロンプトを記述する必要がないため、失敗したパイプライン実行から開始することがトラブルシューティングの最速の方法です。

  1. Adobe Experience Cloudにログインし、Experience Manager​を開きます。

    Experience Managerのホームページ。左パネルに「同僚に質問」ボックスと「Cloud Manager」が表示されている

    note tip
    TIP
    Cloud Managerを開かずにトラブルシューティングを行うには、このページの「同僚に質問」ボックスに「失敗したパイプラインのトラブルシューティング」などのプロンプトを入力します。
  2. 左側のパネルで、Cloud Manager​をクリックし、プログラムを選択します。

  3. プログラムの概要 ページの​パイプライン カードで、失敗したパイプラインをクリックします。

    環境とパイプライン カードを表示する Cloud Managerのプログラム概要ページ ​

  4. パイプライン実行ページで、パイプライン名の横にある​失敗 ステータスと、失敗したステップに注意してください。

    失敗したアーティファクト準備ステップを示す、Cloud Managerの ​ パイプライン実行ページ ​

  5. 「AIを使用したトラブルシューティング」をクリックします。 ボタンは、ページの右上隅付近および失敗したステップの​ステップエラー ボックスに表示されます。

    失敗したステップのページヘッダーおよびステップエラーボックスで、AI ボタンを使用してトラブルシューティングする

    ページの右側にあるパネルが開き、プロンプトで失敗した実行が参照されます。 Coworkerは、失敗したステップを特定し、根本原因を説明し、手動で適用できる修正を提案します。

    失敗したパイプライン実行の横にある 同僚パネル。根本原因分析を表示

  6. 診断の見直し。 フォローアップで質問したり、詳細をリクエストしたりするには、「同僚に質問」ボックスに入力します。

失敗したパイプラインウィジェットからのトラブルシューティング troubleshoot-from-experience-home-widget

Experience Manager ホームページには、失敗したパイプライン ウィジェットが含まれており、プログラム全体のパイプラインの失敗が一覧表示されるため、最初にCloud Managerを開かなくてもトラブルシューティングを開始できます。 各行には、パイプライン名、最後の実行の日時、期間、失敗したステップ、および​AIによるトラブルシューティング ボタンが表示されます。

NOTE
失敗したパイプライン ウィジェットは、管理者とIT プリセットが選択されている場合にのみ表示されます。 ウィジェットが表示されない場合は、ホームページの右上隅にある「プリセット」リストから「管理者とIT」を選択します。

失敗したパイプラインウィジェットがExperience Manager ホームページに表示され、「AIを使用したトラブルシューティング」ボタンがハイライト表示されている

  1. Adobe Experience Cloudにログインし、Experience Manager​を開き、失敗したパイプライン ウィジェットにスクロールします。

  2. 調査するパイプラインの行で、AIを使用したトラブルシューティング​をクリックします。

    Coworkerは失敗した実行を参照して開き、分析を開始し、根本原因を特定して修正を提案します。

  3. 診断の見直し。 フォローアップで質問したり、詳細をリクエストしたりするには、「同僚に質問」ボックスに入力します。

AEM Cloud Manager Environment Management aem-cloud-manager-environment-management

AEM Cloud Managerの環境管理スキルを使用すると、Cloud ManagerのUI画面を移動して適切なプログラム、環境、設定パネルを見つけることなく、Cloud Manager環境を自然言語で管理できます。 環境のリストを作成し、特定の環境の詳細を表示し、プロジェクトのニーズの変化に応じて環境を作成、複製、削除できます。

環境の管理、デバッグ用のログのダウンロード、クリーンスレートが必要な場合の迅速な開発環境(RDE)のリセット、リージョンのデプロイメントの設定など、日々の環境の維持についても説明します。これらはすべて、Cloud Managerを経由した複数回の旅行ではなく、1回の会話で行います。 何かをロールバックする必要がある場合、スキルはバックアップから環境を復元することもできます。

AIはミスを起こす可能性があるため、提案されたアクションを適用する前に、特に破壊的な運用に対して、そのアクションをレビューする必要があります。

機能
サンプルプロンプト
リスト環境
「プログラム 12345の環境を一覧表示」

「メインプログラムのすべての環境を表示」
環境の詳細を取得しています
「プログラム 12345のステージ環境の詳細を確認」

「実稼動環境のステータスを教えてください」
環境の作成
「プログラム 12345の新しい開発環境を作成する」

「テスト用のステージ環境を設定する」
環境の複製
「実稼動環境を新しい開発環境に複製する」

「プログラムの12345用にステージング環境を複製する」
環境の削除
“プログラム 12345の古い開発環境を削除”

“未使用のテスト環境を削除”
環境変数の管理
「開発環境の変数を表示する」

「ステージング環境でAPI_BASE_URL変数を設定する」
環境ログのダウンロード
「実稼動環境のログを取得する」

「自分のステージング環境のDispatcher ログをダウンロードする」
RDEのリセット
「RDEをリセット」

「プログラム 12345の迅速な開発環境をリセット」
地域のデプロイメントの管理
「プログラム 12345の新しいリージョンのデプロイメントを追加」

「実稼動環境のリージョンのデプロイメントを表示」
バックアップから復元
「昨夜のバックアップから本番環境を復元」

「ステージング環境で利用可能なバックアップを表示」

AEM Cloud Manager Program Management aem-cloud-manager-program-management

AEM Cloud Manager プログラム管理スキルを使用すると、Cloud Managerのプログラムリストを移動して目的のプログラムを見つけるのではなく、自然言語を使用してCloud Manager プログラムを検索および管理できます。 アクセスできるすべてのプログラムを一覧表示し、特定のプログラムの詳細を表示し、不要になったプログラムを削除できます。

プログラムはパイプラインと環境が存在する傘なので、このスキルは関連リソースへのクイックエントリポイントとしても機能します。プログラム IDを自分で追跡することなく、特定のプログラムに関連付けられたパイプラインまたは環境を表示するように依頼できます。

AIはミスを起こす可能性があるため、提案されたアクションを適用する前に、特に破壊的な運用に対して、そのアクションをレビューする必要があります。

機能
サンプルプロンプト
すべてのプログラムのリスト
「自分のCloud Manager プログラムを一覧表示」

「どのプログラムにアクセスできますか?」
プログラムの詳細の取得
「プログラム 12345の詳細を表示」

「メインプログラムに関する情報を表示」
プログラムの削除
“プログラム 12345を削除”

“古いデモ プログラムを削除”
プログラムのパイプラインの表示
「プログラム 12345ームのパイプラインは何ですか?」

「メイン プログラムのパイプラインのリスト」
プログラムの環境の表示
「プログラム 12345の環境を表示する」

「メインプログラムにはどのような環境がありますか?」

AEM Cloud Manager リリース管理 aem-cloud-manager-release-management

AEM Cloud Manager リリース管理スキルを使用すると、Adobeで自動保守アップデートをプログラムに適用するタイミングを制御できます。Cloud Managerの設定を掘り下げて適切な画面を見つける必要はありません。 現在の更新スケジュールを確認し、Adobeが更新を一時停止する毎日繰り返し時間ウィンドウを設定し、環境に変更が加えられたくない場合は、製品の発表や休暇期間などのイベントに関する複数日の更新無料期間をスケジュールできます。

プランが変更された場合は、スケジュールと同じくらい簡単に更新不要の期間を削除できます。 また、このスキルでは、Adobe独自のグローバルなコード凍結期間(Windows Adobeでは計画的なメンテナンス除外が既にブロックされています)を表示できるので、自分でスケジュールを設定する前に、どの日付がすでに制限外になっているかを事前に把握できます。

また、このスキルはスケジュール設定のエラーを回避するのにも役立ちます。 リクエストを進める際に、フローティングの365日ウィンドウ内の最大3回の更新不要の期間、期間の間の必須1週間の間隔、Adobeの計画的なメンテナンス除外ウィンドウなど、適用される制限がフラグされます。 設定が失敗した後に制約を検出する代わりに、同じ会話で有効なスケジュールに到達します。 このアプローチにより、重要なビジネスウィンドウを自動メンテナンス更新から保護し、行き違いや設定ミスを減らすことができます。 休眠時間と無料期間の更新を参照してください。

AIは間違いを犯す可能性があるため、提案されたアクションを適用する前にレビューすることができます。これは、更新スケジュールの変更に特に当てはまります。誤ってスケジュールまたは削除された更新不要の期間では、保護する予定の期間に更新が実行される可能性があるからです。

機能
サンプルプロンプト
現在の更新スケジュール設定の取得
「現在のサイレント時間枠は?」

「プログラムの更新スケジュールを表示12345る」
毎日の静止時間数ウィンドウの設定
「プログラム 12345ームのサイレントアワーを午後10時から午前6時に設定」

「サイレントアワーのウィンドウを更新して1時間早く開始する」
更新不要の期間のスケジュール
「12月20日から1月2日までの更新無料期間のスケジュール」

「3月3~10日のローンチ週にプログラム 12345ークフローの更新をブロック」
更新不要の期間の削除
「プログラム 12345の更新不要の期間を削除する」

「来週にスケジュールしたブラックアウトウィンドウをキャンセルする」
Adobeのグローバルなコード凍結期間の表示
「今四半期のAdobeの更新プログラムのフリーズはいつですか?」

「Adobeの計画保守除外期間を表示する」

AEM Workflow Inspection aem-workflow-inspection

AEM Workflow Inspection スキルを使用すると、平易な言葉でワークフローアクティビティを確認できます。 ワークフローのユーザーインターフェイスを開かずに、実行しているワークフロー、受信トレイで待機しているワークフロー、ワークフローが失敗した理由を同僚に尋ねます。

特定のワークフローを検索し、利用可能なワークフローモデルを閲覧して、トラブルシューティングを行いながらフォローアップの質問をすることができます。 このスキルは読み取り専用です。何が起こっているのかを確認し、理解するのに役立ちますが、ワークフローの開始、変更、停止はありません。

AIはミスを犯す可能性があるため、対応前に調査結果を確認する必要があります。

ユースケース
サンプルプロンプト
ワークフローアクティビティの確認
「現在実行中のワークフローはどれですか?」

「ワークフローは中断されていますか?」
ステータスの概要を取得
「実行中、完了、中断、終了しているワークフローの数を確認してください」

「ステータス別のワークフローの簡単な分類を教えてください」
注意が必要なワークフローの発見
「実行中のワークフローまたは中断されたワークフローで、記録されたエラーが表示されていますか?」

「検査したワークフローで見つかったエラーを要約してください」
ワークフローエラーの調査
「そのワークフローのエラーに使用できる診断情報は何ですか?」

「そのリストの2番目のワークフローのエラーを説明してください」
ワークフローを確認
「もう一度ワークフローを確認してください。 現在、どのエラー情報が返されますか?」

「前回のチェック以降、ステータスまたは現在の手順が変更されますか?」
特定のワークフローの調査
「そのリストの2番目のワークフローのコンテンツ、ステータス、開始時間を表示します。」

「誰が開始したか、いつ、どの作業項目の情報を利用できますか?」
待機している機能を確認する
「ワークフローの受信トレイに何があるの?」

「タスクではなく、ワークフローの手順のみを表示する」
ワークフローモデルの詳細
「使用可能なワークフローモデルはどれですか?」

「エディトリアルレビューという名前のモデルは使用可能ですか?」

AEM Dispatcherのインサイト aem-dispatcher-insights

AEM Dispatcher インサイト スキルは、DispatcherとApacheのweb層がAEM as a Cloud Serviceでのリクエストをどのように処理するかを理解するのに役立ちます。 共同作業者に、ログファイルを手動で検索せずに、キャッシュのパフォーマンスを分析し、トラフィックと配信の問題を調査し、セキュリティ設定を確認するように依頼します。 利用可能なデータでサポートされている場合、Coworkerは調査結果をチャートやリクエストタイミングのビジュアライゼーションとして表示できます。

環境固有の分析の場合は、調査する環境と期間(7日間のログウィンドウ内)を特定します。 現在、スキルはソースリポジトリにアクセスしないため、設定とコードのレビューのために、関連するファイルを貼り付けたりアップロードしたりできます。 チームメンバーは、到達可能なURLを検証して、応答のステータス、ヘッダー、リダイレクトを確認することもできます。

これらのトピック全体で、変更を提案し、その潜在的な影響を説明し、検証とロールバックのガイダンスを提供するように同僚に依頼できます。 変更を適用してデプロイしたら、Coworkerに対して、使用可能なログまたはライブ URLの動作を再評価するように依頼します。

現在、スキルはリポジトリの変更、変更のデプロイ、コンテンツの公開または非公開、キャッシュのクリアを行いません。 CDN キャッシュのパージ、エッジトラフィックフィルターのルールのオーサリング、Adobeで管理されるインフラストラクチャ設定の変更は、その範囲外です。

AIはミスを犯す可能性があるため、分析結果や提案された変更を事前に確認してから、対応します。

キャッシュとパフォーマンス dispatcher-caching-performance

キャッシュの効果を把握し、応答の速度が遅い、または古い場合を調査し、公開するリクエストを減らす機会を特定します。

機能
サンプルプロンプト
キャッシュの正常性と傾向について
「本日実稼動用のDispatcher キャッシュのパフォーマンスを集計し、昨日と比較します。」

「最新のデプロイメント後にキャッシュのパフォーマンスが低下しました。 ログのエビデンスを、最近のデプロイメントと、共有した設定の違いと比較します。」
キャッシュミスとキャッシュ不可リクエストの識別
「どのパスが見つからないか、キャッシュをバイパスしています。また、どこでキャッシュ性を向上させることができますか?」

「これらのGraphQL永続クエリ応答がキャッシュされない理由を確認してください。」
クエリパラメーターキャッシュの評価
「キャンペーンのトラッキングパラメーターを追加した後、キャッシュヒット率が低下しました。 これらのキャッシュルールを確認します。"

“検索やページ分割を解除せずに安全に無視できるパラメーターはどれですか?”
キャッシュヘッダーと有効期限ポリシーの確認
「これらの応答ヘッダーを確認し、ブラウザー、CDN、Dispatcher キャッシュの相互作用を説明します。」

「私が共有した設定を使用して、バージョン管理されたクライアントライブラリとDAM アセットのキャッシュポリシーを推奨します。」
コンテンツの鮮度とキャッシュの無効化の調査
「なぜ、このページは公開後も古いコンテンツを表示するのか? 共有したログと設定を確認します。"

“statfileslevelまたはgracePeriodの変更は無効化にどのように影響しますか。ページのキャッシュを更新するタイミングは?”
応答が遅い場合の調査
「現在の応答が最も遅いパスはどれですか?」

「代表的なページリクエストの場合は、観察されたDispatcherとパブリッシュの処理ステージと、どこに時間が費やされているかを表示します。」
デプロイメント後のキャッシュウォームアップについて
「デプロイメント後、サイトの動作が遅くなります。 キャッシュウォームアップについて確認する必要がありますか?」

「このページがサイトマップに含まれているかどうかを確認し、サイトマップのカバレッジがウォームアップにどのように影響するかを説明します。」

トラフィックとリクエストの処理 dispatcher-traffic-request-handling

Dispatcherに到達するトラフィックを把握し、リクエストがどのようにフィルタリング、ルーティング、配信されるかを調査します。

機能
サンプルプロンプト
トラフィックパターンとボットの分析
「今日のトラフィック増加に貢献したユーザーエージェントとパスはどれですか?」

「自動トラフィックはキャッシュに吸収されますか、公開リクエストが増加しますか?」
HTTP エラーの調査
「今日のUTC 10:00から11:00の間の本番環境における502と503の断続的な応答を調査します。」

「今日の403と404の応答を考慮するパスと、それらを説明するのに役立つ証拠は何ですか?」
リクエストフィルタリングとエンドポイントルーティングについて
「共有したSling サーブレットと一緒にこれらのフィルタールールを確認します。 意図されたリクエストはリクエストに到達しますか?」

「ルールの順序付けがGraphQL エンドポイントへのリクエストにどのような影響を与えるかを説明します。」
マルチサイトおよびホスト名ルーティングの確認
"これらのホストと農場を見直してください。 各ホスト名は目的のサイトにマッピングされますか?」

「新しいドメインへのリクエストは、間違ったサイトにサービスを提供しています。 共有したホストエイリアスとファームマッピングを確認します。」
リダイレクト、書き換え、バニティ URLのトラブルシューティング
「このURLのリダイレクトチェーンを調べ、共有した書き換えルールを使用してループを説明するのに役立ちます。」

「このバニティ URLはパブリッシュで動作しますが、Dispatcherを通じて404を返します。 何を調べればいいですか?」
ヘッダーの転送と処理の確認
「この設定が公開するリクエストヘッダーはどれですか?」

「clientheaders.anyに属するヘッダーと、vhostまたはキャッシュ設定で処理されるヘッダーを説明します。」
環境の検査と設定のログ記録
「ステージのCloud Manager環境変数を一覧表示し、Dispatcher関連の設定を説明します。」

「実稼動ログを変更せずに、Dispatcherを有効にしたり、ステージでデバッグログを書き換えたりするにはどうすればよいですか?」

セキュリティ dispatcher-security

Coworkerに全体的なセキュリティレビューを依頼するか、お客様が管理するDispatcher設定と関連するAEM コードの特定の懸念事項に焦点を当てます。

機能
サンプルプロンプト
機密性の高いパスの露出と最小権限のフィルターの確認
「これらのルールが管理パスまたはリポジトリパスを公開できるかどうかを確認します。」

「このエンドポイントの許可ルールは、必要なリクエストを保持しながら絞り込むことができますか?」
セキュリティヘッダーの確認
「これらの応答ヘッダー設定を確認して、セキュリティ保護が見つからないか無効であることを確認してください。」

「お勧めのコンテンツ セキュリティ ポリシー変更によるセキュリティ上のメリットとアプリケーションへの潜在的な影響について説明してください。」
権限に応じたキャッシュの確認
「このauth_checker設定とpermission-check サーブレットを確認します。」

「認証済みコンテンツをキャッシュする際に、不正アクセスを防ぐにはどうすればよいですか?」
関連するAEM コードのセキュリティの確認
「これらのSling サーブレットとフィルターを確認して、権限チェックの問題を確認してください。」

「これらのOSGi CSRFおよびCORS設定を、私が共有したDispatcher ルールと一緒に確認してください。」
全体的なセキュリティレビューの実行
「セキュリティ上の弱点について、Dispatcherの設定と関連するAEM コードを確認してください。」

「重大度ごとに調査結果を優先し、AEM as a Cloud Serviceの制御における改善点を推奨します。」
recommendation-more-help
experience-manager-cloud-service-help-main-toc