開發代理程式功能 development-agentic-capabilities

Adobe Experience Manager (AEM) as a Cloud Service的開發代理功能與同事聊天合作,協助傳統AEM Java棧疊開發人員和管理員更有效率地建立、偵錯、部署和最佳化程式碼。

使用案例 use-cases

其中涵蓋一系列使用案例。

管理Cloud Manager管道 aem-cloud-manager-pipeline-management

AEM Cloud Manager Pipeline Management技能可讓您直接透過自然語言管理CI/CD管道,無需在Cloud Manager畫面之間切換以尋找所需的資訊或控制項。 您可以列出和建立管道、開始或取消執行,以及檢查狀態和歷史記錄 — 所有這些都來自單一對話。

當發生錯誤時,該技能會超出狀態檢查的範圍:它可以擷取步驟量度、記錄、成品和執行失敗,因此您可以診斷問題,而不需自行下載和搜尋原始記錄檔。 它也會處理日常的管道設定 — 管理管道變數、使快取的人工因素失效並調整管道設定 — 因此,過去需要透過UI點選多次的例行維護工作只需一個請求即可完成。

若要瞭解執行失敗的原因,請參閱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中確認失敗,識別失敗的步驟,並以簡單的語言說明哪裡出錯,為什麼,以及下一步該做什麼。 如果您的請求符合多個管道,則該技能會要求您選擇一個管道,然後才繼續。

請注意,此功能是作為專家代理程式實作,因此不會在「同事自訂」介面中顯示為列出的技能。

技能會調查以下管道和步驟中的失敗:

  • 完整棧疊部署和計畫碼品質管道中的建置和單元測試步驟和計畫碼掃描步驟。
  • Web層設定管道中的建置和程式碼品質失敗,例如Dispatcher設定驗證錯誤。
  • 設定管道中的部署失敗,例如無效的CDN設定。

對於其他步驟(例如完整棧疊管道的部署步驟)中的失敗,技能會報告失敗的步驟而不診斷它。 在此情況下,請依照存取及下載記錄中的說明檢查記錄,或聯絡Adobe支援。

您也可以開始進行疑難排解,而不需撰寫提示。 在Cloud Manager中失敗的管道執行上,或在Experience Manager首頁的​失敗的管道 Widget中,按一下​「AI疑難排解」,以開啟已參考該執行的同事。 請參閱從Cloud Manager疑難排解失敗的管道,以及從🔗疑難排解失敗的管道Widget。

AI可能會犯錯,所以在採取行動之前請先檢閱診斷。

功能
範例提示
疑難排解失敗的管道
「疑難排解我的失敗管道」

「協助我疑難排解主要程式中最後一個失敗的管道」
疑難排解特定執行
疑難排解管道執行1234567"

“疑難排解方案12345案中開發管道的執行1234567題”
疑難排解Web層級和設定管道
「在管道67890上偵錯我的Web層建置失敗」

「為什麼我的設定管道部署在程式12345中失敗?」

權限 pipeline-troubleshooting-permissions

若要使用AEM Cloud Manager Pipeline疑難排解技能,您必須在Cloud Manager中擁有​ 開發人員 ​或​ 方案管理員 ​角色。 請參閱角色型許可權。

疑難排解Cloud Manager的失敗管道 troubleshoot-from-cloud-manager

從失敗的管道執行開始是進行疑難排解的最快方式,因為Co-worker會以內容形式接收執行,而您不必編寫提示。

  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按鈕

    Co-worker會在頁面右側的面板中開啟,提示中會參考失敗的執行作業。 Co-worker會識別失敗的步驟、說明根本原因,並建議您可以手動套用的修正。

    在失敗的管道執行旁邊 Co-worker面板,顯示根本原因分析

  6. 檢閱診斷。 若要提出後續問題或要求更多詳細資料,請在​ 詢問同事任何事項 ​方塊中輸入。

從失敗的管道Widget進行疑難排解 troubleshoot-from-experience-home-widget

Experience Manager首頁包含​ 失敗的管道 ​介面工具集,列出整個程式的管道失敗,因此您無需先開啟Cloud Manager即可開始疑難排解。 每一列會顯示管道名稱、上次執行的日期和時間、持續時間、失敗的步驟,以及​ 使用AI進行疑難排解 ​按鈕。

NOTE
只有在選取​ Admin & IT ​預設集時,失敗的管道 Widget才會出現。 如果您沒有看到Widget,請從首頁右上角的​ 預設集 ​清單中選取​管理員與IT。

Experience Manager首頁上的失敗管道Widget,顯示失敗的管道,並反白顯示「疑難排解AI」按鈕

  1. 登入Adobe Experience Cloud,開啟​Experience Manager,然後捲動至​失敗的管道 Widget。

  2. 在您想要調查的管道列中,按一下​使用AI進行疑難排解。

    Co-worker會開啟所參考的失敗執行,並開始其分析,找出根本原因並提出修正建議。

  3. 檢閱診斷。 若要提出後續問題或要求更多詳細資料,請在​ 詢問同事任何事項 ​方塊中輸入。

AEM Cloud Manager環境管理 aem-cloud-manager-environment-management

AEM Cloud Manager環境管理技能可讓您透過自然語言管理Cloud Manager環境,無需透過Cloud Manager的UI畫面導覽,即可找到正確的程式、環境或設定面板。 您可以列出環境、提取特定環境的詳細資訊,並在專案需要變更時建立、複製或刪除環境。

日常環境維護也涵蓋在內:管理環境變數、下載記錄以進行偵錯、在您需要空白時重設快速開發環境(RDE),以及設定區域部署 — 所有這些都透過單一對話進行,而不是透過Cloud Manager進行多次旅行。 當某些專案需要復原時,該技能也可以從備份中恢復環境。

AI可能會犯錯,因此在套用建議動作之前,請先檢閱這些動作,尤其是針對破壞性作業。

功能
範例提示
列出環境
「列出程式12345的環境」

「在主要程式中顯示所有環境」
取得環境詳細資訊
「取得程式12345中預備環境的詳細資料」

「我的生產環境的狀態如何?」
建立環境
「為程式12345建立新的開發環境」

「設定測試用的中繼環境」
複製環境
「將我的生產環境複製至新的開發環境」

「復製程式12345的階段環境」
刪除環境
刪除程式中的舊開發環境12345"

“移除未使用的測試環境”
管理環境變數
「顯示我的開發環境的變數」

「在我的中繼環境中設定API_BASE_URL變數」
正在下載環境記錄
「取得生產環境的記錄檔」

「下載中繼環境的Dispatcher記錄檔」
重設RDE
「重設我的RDE」

「重設程式12345的快速開發環境」
管理區域部署
「新增方案12345的區域部署」

「顯示我生產環境的區域部署」
從備份還原
「從昨天的備份還原我的生產環境」

「顯示中繼環境的可用備份」

AEM Cloud Manager程式管理 aem-cloud-manager-program-management

AEM Cloud Manager計畫管理技能可讓您透過自然語言查詢和管理Cloud Manager計畫,而不是瀏覽Cloud Manager的計劃清單以找到您要尋找的計畫。 您可以列出所有您有權存取的程式、提取特定程式的詳細資訊,並在不再需要某個程式時將其刪除。

由於計畫是管道和環境生存的傘狀結構,此技能也作為這些相關資源的快速入口點 — 您可以要求它顯示與給定計畫關聯的管道或環境,而無需首先自行追蹤計畫ID。

AI可能會犯錯,因此在套用建議動作之前,請先檢閱這些動作,尤其是針對破壞性作業。

功能
範例提示
列出所有計畫
「列出我的Cloud Manager程式」

「我有權存取哪些程式?」
取得方案詳細資料
取得方案的詳細資料12345"

“顯示有關主要方案的資訊”
刪除程式
「刪除程式12345」

「移除舊的示範程式」
顯示方案的管道
「計畫12345中有哪些管道?」

「列出主要計畫的管道」
顯示計畫的環境
「顯示計畫12345中的環境」

「主要計畫有什麼環境?」

AEM Cloud Manager Release Management aem-cloud-manager-release-management

AEM Cloud Manager版本管理技能可讓您控制Adobe何時將自動維護更新套用至您的程式,而不需深入瞭解Cloud Manager設定以找到正確的畫面。 您可以檢查目前的更新排程,設定每日無訊息時間視窗(Adobe每天暫停更新的循環時間),並排程產品啟動或假期凍結等事件的多日無更新期間(您不希望任何變更登陸到您的環境中)。

如果您的計畫變更,您可以像排程一樣輕鬆地移除「無更新期間」。 這項技能也可以向您顯示Adobe自己的全域「程式碼凍結」期間 — 視窗Adobe已因計畫的維護排除而遭到封鎖 — 因此在您嘗試排程自己的期間之前,預先知道哪些日期已設為禁區。

此技能也可協助您避免排程錯誤。 它會引導您完成請求,標示適用的限制,例如浮動365天視窗中最多三個無更新期間、期間之間的強制一週間隔,以及Adobe計畫的維護排除視窗。 您不是在設定失敗後發現限制,而是在相同交談中達成有效的排程。 此方法可保護關鍵業務視窗免於自動維護更新,並減少來回和錯誤設定。 檢視無訊息時數與更新可用期間。

AI可能會犯錯,因此在套用建議動作之前先檢視這些動作 — 這尤其適用於更新排程變更,因為未正確排程或移除的「無更新期間」可能會允許更新在您想要保護的視窗中降落。

功能
範例提示
取得目前的更新排程設定
「我目前的[無訊息時間]視窗是什麼?」

「顯示方案12345的更新排程」
設定每日無訊息時間視窗
「將計畫12345動的無訊息時間從晚上10點設定為上午6點」

「更新我的無訊息時間視窗以提早一小時開始」
排程無更新期間
排程從12月20日至1月2日的無更新期間「

」在3月3日至10日的啟動週期間封鎖方案12345的更新「
移除無更新期間
「移除程式12345的無更新期間」

「取消我排定在下週的中斷時段」
檢視Adobe的全域程式碼凍結期間
「Adobe何時會凍結本季的更新?」

「顯示Adobe計畫的維護排除期」

AEM工作流程檢查 aem-workflow-inspection

AEM工作流程檢查技能可讓您以淺顯語言檢查工作流程活動。 在未開啟「工作流程」使用者介面的情況下,詢問同事正在執行哪些工作流程、您的收件匣中正在等候什麼,或工作流程失敗的原因。

您可以查詢特定工作流程、瀏覽可用的工作流程模型,以及在進行疑難排解時詢問後續問題。 此技能為唯讀:可協助您檢視並瞭解正在發生的事情,但不會開始、變更或停止工作流程。

AI可能會犯錯,所以在採取行動之前請先檢閱發現。

使用案例
範例提示
檢查工作流程活動
「哪些工作流程目前正在執行?」

「是否有任何工作流程暫停?」
取得狀態摘要
「有多少工作流程正在執行、完成、暫停或終止?」

「依狀態提供工作流程的快速劃分。」
尋找需要注意的工作流程
「我是否看見任何執行中或暫停的工作流程,顯示記錄的錯誤?」

「摘要您檢查的工作流程中發現的錯誤。」
調查工作流程錯誤
「該工作流程錯誤的診斷資訊有哪些?」

「說明該清單中第二個工作流程上的錯誤。」
重新檢查工作流程
「再次檢查該工作流程。 現在傳回哪些錯誤資訊?"

“自從上次檢查後,其狀態或目前步驟是否有所變更?”
檢查特定工作流程
“顯示該清單中第二個工作流程的內容、狀態和開始時間。”

“誰開始、何時開始,以及有哪些工作專案資訊可用?”
檢視我正在等候什麼
「我的工作流程收件匣中有什麼?」

「只顯示工作流程步驟,不顯示任務。」
探索工作流程模型
「有哪些工作流程模型可用?」

「有名為「編輯檢閱」的模型可用嗎?」

AEM Dispatcher Insights aem-dispatcher-insights

AEM Dispatcher Insights技能可協助您瞭解Dispatcher和Apache網頁層級如何處理AEM as a Cloud Service中的請求。 要求同事分析快取效能、調查流量和傳遞問題,以及檢閱安全性設定,而不需手動搜尋記錄檔。 若有可用資料支援,Co-worker可以圖表和請求時間視覺效果的形式呈現發現。

針對特定環境的分析,請確定您要調查的環境和時段(在七天的記錄視窗內)。 目前,該技能不會存取您的來源存放庫,因此對於設定和程式碼檢閱、貼上或上傳相關檔案。 同事也可以檢查可連線的URL,以檢查回應狀態、標題和重新導向。

在這些主題中,您可以要求同事提出變更建議、說明其潛在影響,並提供驗證和復原指導。 在您套用和部署變更後,請要求同事重新評估可用的記錄或即時URL行為。

目前,該技能不會修改您的存放庫、部署變更、發佈或取消發佈內容,或清除快取。 CDN快取清除、邊緣流量篩選規則製作,以及Adobe管理之基礎架構設定的變更都超出其範圍。

AI可能會犯錯,所以在採取行動之前,請先檢閱發現和提出的變更。

快取與效能 dispatcher-caching-performance

瞭解快取有效性、調查緩慢或過時的回應,並找出減少發佈請求的機會。

功能
範例提示
瞭解快取運作狀況和趨勢
「摘要目前生產環境適用的Dispatcher快取效能,並將其與昨天進行比較。」

「在我們最新部署後,快取效能下降。 比較記錄證據與最近的部署和我共用的設定差異。」
識別快取遺漏和不可快取的要求
「哪些路徑遺失或略過快取,以及我們可以在何處改善快取能力?」

「檢閱為什麼沒有快取這些GraphQL持續查詢回應。」
正在評估查詢引數快取
「新增行銷活動追蹤引數後,我們的快取命中率下降。 檢閱這些快取規則。"

“我可以安全地忽略哪些引數而不中斷搜尋或分頁?”
檢閱快取標頭和到期原則
「檢閱這些回應標頭,並解釋瀏覽器、CDN和Dispatcher快取如何互動。」

「建議使用我已共用的設定,為我們已建立版本的使用者端程式庫和DAM資產制定快取原則。」
調查內容新鮮度和快取失效
「為什麼此頁面在發佈後仍顯示舊內容? 檢閱我共用的記錄檔和設定。"

“變更statfileslevel或gracePeriod將會如何影響失效,以及何時應該重新整理頁面的快取?”
調查緩慢回應
「今天哪些路徑的回應最慢?」

「若是代表性頁面請求,會顯示觀察到的Dispatcher和發佈處理階段,以及花費時間的位置。」
瞭解部署後快取熱身
「我們的網站部署後速度很慢。 我們應該檢查快取熱身的相關資訊?"

“檢查此頁面是否包含在我們的網站地圖中,並說明Sitemap涵蓋範圍對熱身的影響。”

流量和請求處理 dispatcher-traffic-request-handling

瞭解傳達Dispatcher的流量,並調查如何篩選、路由及提供請求。

功能
範例提示
分析流量模式和機器人
「哪些使用者代理程式和路徑帶動今天的流量增加?」

「快取是否會吸收自動化流量,或增加發佈請求?」
正在調查HTTP錯誤
「調查今日10:00到11:00 UTC之間生產環境中間歇性的502和503回應。」

「哪些路徑可解釋今天的403和404回應,以及哪些證據可協助解釋?」
瞭解請求篩選和端點路由
「和我共用的Sling servlet一起檢閱這些篩選規則。 預期的請求會到達嗎?"

“說明規則排序如何影響對GraphQL端點的請求。”
檢閱多地點與主機名稱路由
「檢閱這些主機和陣列。 每個主機名稱都會對應到預期的網站嗎?"

"對我們新網域的請求正在提供錯誤的網站。 檢查我已共用的主機別名和伺服器陣列對應。」
疑難排解重新導向、重新寫入和虛名URL
“檢查此URL的重新導向鏈結,並使用我共用的重新寫入規則來協助說明回圈。”

"此虛名URL適用於發佈,但透過Dispatcher傳回404。 我應該檢查哪些專案?」
檢閱標題轉送與處理
「此設定會轉送哪些要求標頭發佈?」

「說明哪些標頭屬於clientheaders.any,哪些在vhost或快取設定中處理。」
檢查環境和記錄設定
「列出Stage的Cloud Manager環境變數,並說明Dispatcher相關的設定。」

「如何啟用Dispatcher或重寫Stage中的除錯記錄,而不變更生產記錄?」

安全性 dispatcher-security

請要求同事進行整體安全性審查,或專注於客戶控制的Dispatcher設定和相關的AEM程式碼中的特定問題。

功能
範例提示
正在檢查敏感路徑公開和最低許可權篩選器
「檢查這些規則是否可能公開管理或存放庫路徑。」

「這個端點的允許規則可以縮小,同時保留必要的請求嗎?」
檢閱安全性標頭
「檢閱這些回應標頭設定,瞭解是否有遺漏或無效的安全性保護。」

「說明您建議的內容安全性原則變更的安全性優點與潛在的應用程式影響。」
檢閱許可權敏感型快取
「檢閱此auth_checker設定和許可權檢查servlet。」

「在快取已驗證的內容時,我們應該進行哪些驗證以防止未經授權的存取?」
檢閱相關AEM程式碼的安全性
“檢閱這些Sling servlet和篩選器以瞭解許可權檢查問題。”

“檢閱這些OSGi CSRF和CORS設定以及我共用的Dispatcher規則。”
執行整體安全性審查
「請檢閱Dispatcher設定和我共用的AEM相關程式碼中的安全性弱點。」

「依嚴重性排定發現專案的優先順序,並在AEM as a Cloud Service中建議可控制的改善專案。」
recommendation-more-help
experience-manager-cloud-service-help-main-toc