开发代理功能 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管道故障排除。

人工智能可能会犯错,因此在应用建议操作之前对其进行审查,尤其是针对破坏性操作。

功能
示例提示
列出管道
“列出项目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主页上的​ 失败的管道 ​构件中单击​AI故障排除,打开已引用该执行的协同工作。 请参阅Cloud Manager中的失败管道疑难解答🔗和失败管道小组件🔗中的疑难解答。

人工智能可能会犯错,因此在做出诊断之前先进行检查。

功能
示例提示
管道故障排除
“解决我失败的管道问题”

“帮助我解决主程序中最后一个失败的管道问题”
特定执行疑难解答
管道执行疑难解答1234567“

”项目12345中开发管道的执行1234567疑难解答
Web层和配置管道疑难解答
“在管道67890上调试我的Web层生成失败”

“为什么我的配置管道部署在程序12345中失败?”

权限 pipeline-troubleshooting-permissions

若要使用AEM Cloud Manager Pipeline故障排除技能,您必须在Cloud Manager中具有​ 开发人员 ​或​ 项目经理 ​角色。 请参阅基于角色的权限。

Cloud Manager中失败的管道疑难解答 troubleshoot-from-cloud-manager

从失败的管道执行开始是进行故障排除的最快方式,因为同事会以上下文方式接收执行,而您不必编写提示。

  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标识失败的步骤,说明根本原因,并建议您可以手动应用的修复。

    管道执行失败旁边的 辅助进程面板,显示根本原因分析

  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故障诊断。

    同事将打开引用的失败执行并启动其分析,确定根本原因并提出修复建议。

  3. 查看诊断。 若要询问后续问题或请求更多详细信息,请在​ 询问同事任何内容 ​框中键入。

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

通过AEM Cloud Manager环境管理技能,您可以通过自然语言管理Cloud Manager环境,而无需浏览Cloud Manager的UI屏幕以找到正确的程序、环境或配置面板。 您可以列出环境,提取特定环境的详细信息,并在项目需要更改时创建、克隆或删除环境。

日常环境维护也涵盖在内:管理环境变量、下载日志以进行调试、在需要清理板时重置快速开发环境(RDE),以及配置区域部署 — 所有这些都通过单个对话进行,而不是通过Cloud Manager进行多次访问。 当某些内容需要回滚时,该技能还可以从备份中恢复环境。

人工智能可能会犯错,因此在应用建议操作之前对其进行审查,尤其是针对破坏性操作。

功能
示例提示
列出环境
“列出程序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。

人工智能可能会犯错,因此在应用建议操作之前对其进行审查,尤其是针对破坏性操作。

功能
示例提示
列出所有项目群
“列出我的Cloud Manager程序”

“我有权访问哪些程序?”
获取项目详细信息
获取计划12345的详细信息"

“向我显示有关主计划的信息”
删除项目群
删除项目12345“

”删除旧演示项目
显示项目的管道
“项目12345中有哪些管道?”

“列出主项目的管道”
显示程序的环境
“显示程序12345中的环境”

“主程序具有什么环境?”

AEM Cloud Manager版本管理 aem-cloud-manager-release-management

通过AEM Cloud Manager版本管理技能,您可以控制Adobe何时将自动维护更新应用到您的项目,而无需深入了解Cloud Manager设置以找到正确的屏幕。 您可以检查当前的更新计划,设置每天的免打扰时间窗口(Adobe每天暂停更新的重复时段),并在不希望任何更改登陆到环境时,围绕产品启动或假期冻结等事件安排多天的免更新时段。

如果计划发生更改,您可以像计划一样轻松删除无更新期间。 该技能还可以向您显示Adobe自己的全局代码冻结期(Adobe已针对计划的维护排除而阻止的Windows),这样您就可以在尝试安排自己的日期之前预先知道哪些日期已被禁止。

该技能还可帮助您避免安排错误。 它引导您完成请求时,会标记适用的限制,例如一个浮动365天窗口内最多三个无更新时段、各时段之间强制的一周间隔以及Adobe的计划内维护排除时段。 您不是在配置失败后发现限制,而是在同一对话中达到有效计划。 此方法可保护关键业务窗口免受自动维护更新的影响,并减少来回切换和错误配置。 查看无讯息小时数和更新无讯息时段。

AI可能会出错,因此在应用建议操作之前查看这些操作 — 对更新计划更改尤其如此,因为错误地计划或移除的无更新期可能会允许更新在您想要保护的窗口内着陆。

功能
示例提示
获取当前更新计划设置
“我当前的‘安静时间’窗口是什么?”

“显示计划12345的更新计划”
配置每日免打扰时间窗口
“将计划12345的安静时间从晚上10点设置为上午6点”

“更新我的安静时间窗口以提前一小时开始”
计划无更新时段
安排从12月20日至1月2日的无更新时段“

”在3月3日至10日启动周期间阻止程序12345更新“
删除无更新时段
删除程序12345的无更新时段"

“取消我计划在下周的封锁期”
查看Adobe的全局代码冻结期
“Adobe何时冻结本季度的更新?”

“显示Adobe的规划维护排除期”

AEM工作流检查 aem-workflow-inspection

您可以使用AEM工作流检查技能以纯语言检查工作流活动。 在未打开“工作流”用户界面的情况下,询问同事正在运行哪些工作流、收件箱中正在等待什么内容,或者工作流失败的原因。

您可以查找特定工作流、浏览可用的工作流模型,并在进行故障诊断时询问后续问题。 此技能是只读的:它有助于您查看和了解正在发生的事情,但不会启动、更改或停止工作流。

人工智能可能会犯错,因此在做出结论之前对其进行审核。

用例
示例提示
检查工作流活动
“哪些工作流当前正在运行?”

“是否暂停了任何工作流?”
获取状态摘要
有多少工作流正在运行、已完成、已暂停或已终止?"

“按状态快速细分工作流。”
查找需要注意的工作流
“我看到的任何正在运行或暂停的工作流是否显示记录的错误?”

“总结您检查的工作流中发现的错误。”
调查工作流错误
“对于该工作流的错误,有哪些诊断信息可用?”

“在该列表中的第二个工作流上解释错误。”
重新检查工作流
“再次检查该工作流。 现在返回了什么错误信息?“

”自上次检查以来,其状态或当前步骤是否发生了更改?”
检查特定工作流
“显示该列表中第二个工作流的内容、状态和开始时间。”

“启动该工作流的用户、时间以及有哪些工作项信息可用?”
查看我正在等待什么
“我的工作流收件箱中有什么?”

“只显示工作流步骤,不显示任务。”
发现工作流模型
“有哪些工作流模型可用?”

“有名为‘编辑评论’的模型可用吗?”

AEM Dispatcher Insights aem-dispatcher-insights

AEM Dispatcher Insights技能可帮助您了解Dispatcher和Apache Web层如何在AEM as a Cloud Service中处理请求。 要求同事分析缓存性能、调查流量和投放问题,以及审查安全配置,而无需手动搜索日志文件。 如果有可用数据支持,Co-worker可以以图表和请求时间可视化图表的形式呈现调查结果。

对于特定于环境的分析,请确定要调查的环境和时间段(在七天的日志窗口中)。 目前,该技能无法访问您的源存储库,因此要进行配置和代码审查,请粘贴或上传相关文件。 同事还可以检查可访问的URL以检查响应状态、标头和重定向。

在这些主题中,您可以要求同事提出更改建议、解释其潜在影响并提供验证和回滚指导。 应用并部署更改后,请让同事重新评估可用的日志或实时URL行为。

目前,该技能不会修改存储库、部署更改、发布或取消发布内容或清除缓存。 CDN缓存清除、边缘流量过滤器规则创作以及对Adobe管理的基础架构设置的更改超出了其范围。

AI可能会犯错,因此在对它们采取行动之前,先审查发现并提出更改。

缓存和性能 dispatcher-caching-performance

了解缓存有效性,调查缓慢或陈旧的响应,并确定减少发布请求的机会。

功能
示例提示
了解缓存的运行状况和趋势
“总结一下今天用于生产的Dispatcher缓存性能,并将其与昨天进行比较。”

“在我们的最新部署后,缓存性能有所下降。 将日志证据与最近的部署以及我共享的配置差异进行比较。”
确定高速缓存未命中和不可高速缓存的请求
“哪些路径缺失或绕过缓存,以及在何处可以改进缓存能力?”

“请查看为什么没有缓存这些GraphQL持久查询响应。”
正在评估查询参数缓存
“添加促销活动跟踪参数后,我们的缓存命中率下降了。 查看这些缓存规则。"

“我可以安全地忽略哪些参数而不中断搜索或分页?”
审查缓存标头和过期策略
“查看这些响应标头,并解释浏览器、CDN和Dispatcher缓存如何交互。”

“建议使用我共享的配置,为版本控制的客户端库和DAM资源设置缓存策略。”
调查内容新鲜度和缓存失效
“为什么此页面在发布后仍显示旧内容? 查看我共享的日志和配置。“

”更改statfileslevel或gracePeriod会如何影响失效,以及何时应刷新页面的缓存?
调查响应缓慢的问题
“今天哪些路径的响应最慢?”

“对于代表性页面请求,显示观察到的Dispatcher和发布处理阶段以及所用时间。”
了解部署后缓存预热情况
“我们的网站在部署后运行缓慢。 我们应检查有关缓存预热的哪些内容?"

“检查此页面是否包含在我们的站点地图中,并解释站点地图覆盖范围对预热有何影响。”

流量和请求处理 dispatcher-traffic-request-handling

了解到达Dispatcher的流量,并调查如何过滤、路由和提供请求。

功能
示例提示
分析流量模式和机器人
“哪些用户代理和路径驱动了今天的流量增长?”

“缓存是吸收了自动流量,还是增加了发布请求?”
调查HTTP错误
“调查当天10:00 UTC到11:00 UTC之间生产中间歇性的502和503响应。”

“哪条路径导致了今天的403和404响应,什么证据有助于解释这些响应?”
了解请求过滤和端点路由
“与我共享的Sling Servlet一起查看这些过滤器规则。 预期的请求是否会到达该节点?"

“说明规则排序如何影响对我们的GraphQL端点的请求。”
审查多站点路由和主机名路由
“审查这些主机和场。 每个主机名是否都映射到预期站点?"

"发送到新域的请求所服务的站点错误。 检查我共享的主机别名和场映射。”
重定向、重写和虚URL疑难解答
“检查此URL的重定向链,并使用我共享的重写规则帮助解释该循环。”

“此虚URL在发布时有效,但通过Dispatcher返回404。 我该检查什么?”
查看标头转发和处理
“此配置将哪些请求标头转发到发布?”

“说明哪些标头属于clientheaders.any以及哪些标头在vhost或缓存配置中处理。”
检查环境和日志记录设置
“列出用于暂存的Cloud Manager环境变量并解释Dispatcher相关的设置。”

“如何在不更改生产日志记录的情况下启用Dispatcher或重写暂存中的调试日志记录?”

安全性 dispatcher-security

请让同事进行总体安全审查,或重点关注客户控制的Dispatcher配置和相关AEM代码中的特定问题。

功能
示例提示
检查敏感路径泄露和最低权限过滤器
“检查这些规则是否可能公开管理路径或存储库路径。”

“能否在保留所需请求的同时缩小此端点的允许规则?”
审查安全标头
“查看这些响应标头设置,了解安全保护是否缺失或无效。”

“说明您推荐的内容安全策略更改的安全好处和潜在的应用程序影响。”
审查权限敏感型缓存
查看此auth_checker配置和权限检查servlet。"

“在缓存经过身份验证的内容时,我们应该验证哪些内容以防止未经授权的访问?”
审查相关AEM代码中的安全性
“查看这些Sling Servlet和筛选器以了解权限检查问题。”

“除了我共享的Dispatcher规则之外,还查看这些OSGi CSRF和CORS配置。”
执行总体安全审查
“请查看Dispatcher配置和我共享的相关的AEM代码是否存在安全漏洞。”

“按严重程度优先处理调查结果,并在AEM as a Cloud Service中提出改进建议。”
recommendation-more-help
experience-manager-cloud-service-help-main-toc