Experience Modernization Agent入门 getting-started

最近更新： 2026年11月12日

适用对象：
Experience Manager as a Cloud Service

创建对象：

用户
管理员
开发人员

Experience现代化代理会与您一起构建和更改Edge Delivery Services站点。您可以描述Experience现代化控制台中的所需内容，然后代理会导入页面、设置页面样式并写入代码。本指南会将您从访问引导至可以编辑、预览和发布的第一页。

在Edge Delivery Services中，站点的代码（块、样式和脚本）位于Git存储库中，其内容位于可供作者编辑的单独内容源中。该平台将二者结合为快速页面。若要了解详细信息，请参阅平台概述。

在本指南中，内容存储在基于文档的内容存储库中，作者可在其中使用Edge Delivery Services的可视化创作UIExperience Workspace编辑内容。如果您的内容必须保留在Adobe Experience Manager创作实例的JCR中，请按照Experience Manager创作的指南执行不同的步骤。若要在二者之间进行选择，请参阅内容的存储位置以及作者如何编辑内容。

自动模式有自己的注册。有关控制台访问以及您继续使用自己的网站时应用的条款，请参阅访问和AI信用使用情况。

从您自己的页面开始 first-outcome

从下面的“自动”模式开始，迁移一些页面，查看结果，然后通过让它成为您的页面。如果您已有项目或想从头开始引导导入，请改为从存储库开始：从样板创建项目，或连接现有站点。

这两种路由都指向控制台中连接的站点。从那里，您提示代理，然后保存、预览和发布结果。控制台是托管的，因此路由不需要本地开发环境。

在导入之前，请选择您有权迁移的网站的几个页面（包括每个常见布局之一），然后决定是保留源设计还是应用新设计。

从自动模式开始 brand-trial

自动模式迁移网站或其页面列表，而无需逐步提示。在引导式工作流中，代理将在每个步骤之后停止，以供您审阅。在“自动”模式下，它会导入内容、迁移设计、针对源对结果进行批判并不断优化该结果，直到批判找到与源接近的页面。

由于它检查和优化自己的工作，因此自动模式所花的时间要比引导式导入相同页面的时间长得多，因此它适合您以后收集的第一次结果。一旦运行开始，它就不会要求您输入：您只需在开始之前通过选择的范围和选项来控制运行过程。自动模式从网站的URL启动，而不是从存储库启动；如果您的网站已在Edge Delivery Services上，请将其连接。它会生成基于文档的内容；对于存储在JCR中的内容，请使用Experience Manager创作的指南。

打开自动模式。如果您的帐户尚未注册，请选择注册；您可以在有访问权限时收到电子邮件。
提供您的网站URL，或选择选定的页面并列出其URL。在开始之前查看显示的范围、设置和限制。
- 对于受保护的源站点，在“自动”模式提供的身份验证字段中输入凭据，而不是在聊天中输入凭据。
- 如果自动模式提供包括集成，请选择该模式以从源站点继续受支持的集成设置，如分析、标签管理器和同意设置。在新网站上打开它们之前，它们会一直处于关闭状态。
开始运行。运行最多可能需要24小时。您可以离开页面；运行完成后，您将收到一封电子邮件。如果电子邮件未送达，请检查您的垃圾邮件文件夹。
查看已迁移的页面，并检查其内容、链接、图像和样式。该运行还会显示其预览、存储库、报告和错误。指向运行未迁移的页面的链接仍可以指向源站点。
使用 打开站点 打开生成的站点。若要继续处理，请使用将其转到您自己的网站，然后导入更多页面并在控制台中优化结果。

自动模式限制 auto-mode-limits

自动模式根据每次迁移的页数、迁移数以及同时运行的迁移数来限制每个帐户。 “自动模式”页面显示启动前适用于您的限制：

默认情况下，每次迁移最多可包含10页。全站点运行最多可迁移多个页面的预览，而不是整个站点；稍后可在控制台中迁移其余页面。
如果您已使用过帐户允许的所有迁移，或者已尽可能多地运行了迁移，则自动模式会告诉您这一点。等待运行完成，或请求更多内容。
要请求更多页面或迁移，请使用标头中的 请求更高的限制 或获取帮助。生成座席回复的团队通过电子邮件进行回复。

若要停止运行，请使用取消迁移。无法恢复已取消的运行；请改为启动新的迁移。

打造您的体验 make-it-yours

自动模式运行会在Adobe管理的位置创建其站点。要在您自己的站点中继续处理它，请在完成运行时选择将其设为您的。这会将运行的代码和内容传输到您拥有的网站。它不会再迁移任何内容。

首先准备目标：

其代码位于通过Edge Delivery Services模板创建的GitHub存储库中的站点，且已安装AEM代码同步和AEM代码连接器应用程序。最快捷的方法是从样板创建新站点。另一个Git主机上通过Cloud Manager连接的存储库也可以使用。
存储库中的main分支，以及存储在基于文档的内容存储库中的网站内容。任何内容都不会传输到其内容存储在其他位置（如创作实例上）的目标。
对在控制台中使用的Adobe帐户写入对存储库和站点内容的访问权限。
运行自己的站点以外的站点。

要转移运行，请执行以下操作：

选择目标站点。如果您尚未连接到GitHub，控制台会要求您先连接。
查看目标存储库、预览URL以及将接收代码的新分支。选择是否覆盖现有页面以及是否预览已传输的页面。
选择 开始传输 并跟踪其进度。代码将放置在新分支上，并且内容将复制到目标内容位置。对于基于文档的目标，传输还会打开目标站点的Experience Workspace 。如果该步骤失败，控制台将显示警告；请要求站点管理员启用Experience Workspace。
选择 在EMA中打开 以在控制台中继续在目标站点上操作，或选择 编辑站点 以编辑内容。如果控制台未在目标站点上打开，请将其连接。

传输会复制以下内容：

什么

如何传输

代码

已推送到从目标的main分支创建的新分支。在该分支上，运行的项目将替换目标的代码文件。没有合并到main中。

页面

作为文档复制到Experience Workspace中的目标内容，以及它们引用的图像和其他媒体。

现有页面

已跳过，除非您选择覆盖它们。在覆盖页面之前，传输会将页面的当前状态保存为名为 传输前 的版本，您可以从Experience Workspace中的页面版本历史记录中恢复该版本。

预览

如果选择，将在目标的*.aem.page网站上预览已转移的页面。它们不发布。

传输不会复制电子表格，例如重定向、批量元数据或占位符；访问权限；网站和组织配置；或运行的Git历史记录和GitHub工作流文件。

如果传输因错误而停止，则不会将任何内容合并到main中，但会单独传输代码和内容，因此请检查分支和页面。如果新分支已存在，请选择其他分支名称。

已转移的站点尚未上线。商定其余每个步骤的所有者：

查看传输分支，并根据您的存储库策略将其合并到main中。合并更改了实时站点的代码；请参阅更改如何上线。
设置可以编辑、预览和发布内容的人员。请参阅权限和安全性。
重新创建所需的电子表格，并检查站点的Experience Workspace配置，例如其块库。请参阅配置。
发布您接受的页面。传输不会发布任何内容。
将您的域切换到站点。请参阅释放、恢复和移交。

在控制台中，继续进行提示以开始，然后保存、预览和发布您的更改。

从存储库启动 repo-start

要在控制台中工作，GitHub存储库需要两个名称相似但作业不同的GitHub应用程序：

AEM代码同步允许Edge Delivery Services读取您的代码，以便能够为您的网站提供服务。代码位于GitHub上的每个网站都拥有它。
AEM Code Connector允许控制台在存储库中推送更改并打开拉取请求。在安装之前，控制台无法推送代码或打开拉取请求。

NOTE

对于存储在创作实例的JCR中的内容，请改用Experience Manager创作指南来设置存储库。

从样板创建新站点 prepare-repo

对新站点使用此路径，包括使用从现有网站导入的页面填充的站点。

按照开发人员教程的第一部分，开始使用样板存储库模板，从AEM样板创建站点：
- 选择 使用此模板 在GitHub上创建存储库。
- 仅为此存储库安装AEM代码同步应用程序。
- 可以选择更改站点的管理员和内容源，然后选择完成设置。
您的网站现在在https://main--{repository}--{owner}.aem.page/运行，例如您可以在Experience Workspace中编辑的内容。您不需要教程的本地开发步骤，因为控制台提供了开发环境。

对于商业店面，请从商业样板创建网站并改为遵循其设置。它包含商业块和下拉组件，这些组件以后很难添加到从AEM样板启动的网站。查看Commerce页面。
在存储库中安装AEM Code Connector应用程序。
- 如果仅为所选存储库安装应用程序，请包括此存储库。如果您的组织需要审批GitHub应用程序，则组织所有者必须审批它。
打开控制台并连接站点。

引入现有站点 existing-site

如果您的网站已在Edge Delivery Services上运行，则无需重新创建或再次迁移它。将其连接，代理将按原样处理其代码和内容。

在GitHub上，检查存储库中是否安装了AEM代码同步应用程序。如果此存储库已为该站点提供服务，则它为。
像新站点一样，在存储库中安装AEM Code Connector应用程序。
打开控制台并连接站点。
在更改任何内容之前，请要求代理商对项目进行说明。然后，使用检查模式进行第一次视觉更改。查看开始使用的提示。

从当前样板创建的项目包括AGENTS.md（您保留项目对代理的说明）和单行CLAUDE.md（使代理在每个对话中加载AGENTS.md）。旧项目可能没有这些模板；请让代理从当前模板添加这些模板。请参阅项目说明。

若要重新设置网站或构建块的样式，请参阅重新设置现有网站的样式和阻止开发。无需迁移。

使用其他Git主机 other-git

Edge Delivery Services还支持GitHub Enterprise（自托管）、Adobe托管的存储库、GitLab、Bitbucket和Azure DevOps。在Adobe Cloud Manager中载入存储库，这是Experience Manager as a Cloud Service用于管理项目、环境和代码存储库的工具。然后，配置您的站点以使用它。查看自带Git。

IMPORTANT

控制台会将更改推送到存储库。对于通过Cloud Manager连接的存储库，它会推送一个分支，但不会打开拉取请求；如果您需要审核，请在Git主机中打开一个拉取请求。您在Cloud Manager中创建的访问令牌必须授予对存储库代码的写入权限，以及在“添加外部存储库”🔗的步骤8中列出的权限。

如果您已载入没有写入权限的令牌，请在Cloud Manager中的 存储库>管理访问令牌 下编辑该令牌，并粘贴包含写入权限的值；无需再次载入存储库。请参阅管理访问令牌。

打开“体验现代化”控制台 open-console

导航到aemcoder.adobe.io。短地址aem.new打开同一控制台。
使用您的Adobe ID登录。
- 使用属于贵公司Adobe组织的帐户。不能使用不属于组织的个人Adobe ID；该控制台对此进行了说明，并允许您使用其他帐户。如果您没有公司帐户，请让您的Adobe帐户团队将您添加到组织。

控制台会保留项目的托管工作副本，在这些文档中称为控制台工作区；它与创作UI Experience Workspace无关。代理会导入内容并在其中更改代码，直到您上传或推送为止。该控制台会在您首次登录时设置您的工作区，这最多可能需要10分钟。您登录的每个Adobe组织都有自己的工作区，其中包含自己的项目和聊天；要使用其他组织的配置文件进行切换、注销和登录。经过一段时间不活动后，工作区会暂停。返回时，控制台显示您的工作区已暂停；选择唤醒，并在恢复过程中等待几分钟。

演示模式 demo-mode

如果控制台在演示模式下打开，则标题中会显示 演示站点 按钮。您可以浏览示例项目并尝试导入页面，但在演示站点中工作未保存，并且演示站点无法将代码推送到GitHub或无法将内容上传到Experience Workspace。

演示模式

连接您的站点 connect-repo

连接您从样板创建的站点、使用 转移的站点、使其成为您的站点 或已有的站点。

在标题中选择演示站点，然后选择切换站点，或在设置中使用切换站点。
这将提示您使用GitHub凭据授权AEM代码连接器应用程序。选择授权AEM代码连接器。
- 对于GitHub Enterprise，或当OAuth登录不可用时，请打开更多连接方式，然后选择使用令牌登录。输入 GitHub主机 和个人访问令牌。建议使用仅限于您需要的存储库的细粒度令牌。令牌必须能够读取您的用户帐户并将其推送到存储库；对于令牌，控制台将仅列出您可以推送到的存储库。
返回控制台，指定站点的预览URL。预览URL遵循模式https://{branch}--{site}--{organization}.aem.page，其中{site}是GitHub存储库名称，{organization}是拥有它的GitHub组织或用户。您可以通过预览站点的任何页面来复制一个页面，或从这些名称构建页面。控制台会自动查找关联的GitHub存储库。或者，您可以在授权的GitHub项目中搜索以查找站点。
在验证站点后，选择签出到工作区。这会将项目复制到控制台工作区中。
当提示 替换现有工作区 时，验证当前工作是否保存在其他位置，然后选择替换工作区。

您的站点及其GitHub存储库现已连接到控制台。

在请求更改之前，确认连接的存储库、分支和内容目标。连接需要存储库的写入权限。如果您的组织或存储库未列出，或控制台无法验证预览URL，请参阅Git连接问题。

站点连接

控制台主页 console-home

在开始对话之前，控制台会在其主页页面上打开。键入请求，或选择一个按任务分组的建议提示。您键入的请求会同时运行。大多数建议的提示在计划模式下运行：代理建议其步骤而不更改任何文件，并且您选择 执行计划 来执行它们。

控制台主页

开始提示 start-prompting

站点连接后，请用简单的语言描述您想要的内容。说出您预期的结果以及在哪个页面上，而不是如何编写代码。代理知道Edge Delivery Services，因此您还可以询问网站某个部分的工作方式或平台术语的含义。要了解如何从分区、块和默认内容构建页面，请参阅标记、分区、块和自动阻止。

CAUTION

切勿在聊天中键入、粘贴或附加密码、API密钥、令牌或其他密钥。聊天中的所有内容都可访问AI模型，并且代理可以将其复制到项目的文件中。在控制台的设置中输入凭据。查看禁止聊天。

在新站点上，从开始逐步导入页面。在已具有页面的网站上，例如现有网站或通过传输的网站，请要求代理解释该项目，然后使用检查模式进行可视更改或导入更多页面。查看开始使用的提示。

分步导入页面 guided-import

从现有网站导入页面是最常见的启动方式。在引导式工作流中，代理会在每个步骤之后停止，以便您检查：首先检查页面的内容，然后检查页面设计。选中每个结果后立即保存：在内容步骤后上传内容，并在设计步骤后推送代码。

（可选）先设定源站点的范围。询问“范围站点https://www.example.com”。代理查找网站的页面，并将共享布局的页面分组到模板中，这些模板已在规划视图中审核。请从涵盖多个页面的模板中选择您的第一个页面，因为它创建的块可以在所有页面上重复使用。查看站点目录。
从一个授权的源页面开始。在此提示符下替换示例URL和目标：
- “在此项目中仅将https://www.example.com/about迁移到/about。定位基于文档的内容。保留其文本、图像和链接。重用现有块和默认内容。请勿上传、推送或发布。”
- 对于Experience Manager创作，假定内容存储在JCR中，并按照检查检查该设置。
查看导入的页面、其目标路径以及报告的任何间隔。
导入页面后，Workspace面板会显示该页面。选择页面以在控制台右侧的预览面板中渲染它。此预览在控制台工作区中显示工作副本，而不是aem.page上的预览站点。
检查页面结构及其文本。预览面板的 文档视图 显示如何将内容拆分为部分、块和默认内容；请参阅内容视图。页面的大部分内容应为默认内容：标题、文本、图像和链接。块仅属于作者必须标记构成组件的内容的位置，例如一组卡片；CSS和JavaScript可以根据设计需求布局默认内容。作者将编辑此结构，因此请让代理立即简化它，然后再让更多页面重复使用它。请参阅塑造内容结构。
上传内容，以便保存它并且作者可以对其进行编辑。在上传之前，导入的页面仅存在于控制台工作区中，并且推送代码不会保存它。
- 有关基于文档的内容，请参阅上传内容。然后，您可以打开页面并进行编辑。
- 对于Experience Manager创作，请参阅有关该设置的指南中的上传内容。
现在您有了内容、请求忠实源样式或明确选择新目标设计。样式仅更改项目的CSS和JavaScript；您上传的内容将保持不变。
- “从https://www.example.com/about导入常规样式，然后为/about上使用的块设置样式。保留导入的内容。”
代理完成后，在预览面板中选择 刷新预览 以查看样式页面。
在桌面和移动设备宽度上查看样式化页面。将其文本、链接、图像和结构与源页面进行比较，并请求代理修复不同之处。描述仍然存在的视觉差异；复杂的设计可能需要几个轮次。查看设计的接近度。
推送代码，以便将新块和样式保存在存储库中并显示在网站的预览中。请参阅推送代码更改。

页面导入不会构建共享导航和页脚；请单独请求它们。接下来，预览和发布页面。对于更多页面，请重复这些步骤，并要求代理重新使用它创建的块。第一页看起来正确后，请要求它记录其块和样式，以供以后对话使用；请参阅让代理维护文件。

使用检查模式进行可视更改 inspect-mode

在已有页面的网站上，例如现有网站或使用转移的网站，视觉更改是最快查看结果的方式。指向要更改的内容，而不是描述其位置：在“预览”面板中打开检查模式，选择元素并描述更改，例如“使此按钮使用主按钮样式”。进行您的第一次更改提供了相关步骤，包括如何检查每个屏幕宽度和撤消更改。然后推送代码以保留它。

提示开始使用 first-prompts

将示例URL和路径替换为您自己的URL和路径。

样板中的新站点：

“解释主页上的各个部分和块，以及每个部分的样式都是哪些文件。”
“从此图形框架{Figma link}创建新页面/offers。” 请参阅从Figma创建新页面。

完成您的更改后：

“将/about与https://www.example.com/about进行比较，并修复布局和图像之间的差异。”
“将https://www.example.com/contact迁移到/contact。重复使用现有块。”

您的现有站点：

“让我浏览一下这个项目：列出各个块，每个块都做什么，哪些页面使用它们。”
“添加具有深色背景的卡片块的变体，并在/products上显示。”
“检查此项目是否具有当前AEM样板的AGENTS.md和CLAUDE.md文件，如果缺少它们，请添加它们。”

提示提示 prompting-tips

一次请求一个更改，然后在请求下一个更改之前对其进行检查。如果较长的任务在完成前停止，请要求座席继续。
说探员不能做的事。这些指南中的示例提示以“不上传、推送或发布”结尾。这样可以将代理的工作保留在控制台工作区中，以便您检查它，然后自行上传或推送它。如果您希望代理为您执行这些步骤，并且已打开代理所需的代理权限，请将其忽略。
对于跨多个页面或共享样式的更改，请切换到计划模式以在进行任何更改之前查看步骤。

代理只知道当前对话中的内容以及项目文件中的内容。向其提供它无法了解的上下文，例如要求、品牌规则、屏幕截图和指向其他系统文档的链接；请参阅提供代理上下文。若要使其在每次对话中遵循项目惯例，请要求它在AGENTS.md和AGENTS.md列出的文件中写入它们；请参阅项目说明和内存。有关每个任务的提示，请参阅提示指南。

保存、预览和发布 save-work

代理的工作将保留在控制台工作区中，直到您将它保存到其他位置。接下来的每个步骤都会将工作转移到不同的位置：

上传将内容从控制台工作区复制到其创作目标：对于基于文档的项目，复制Experience Workspace；对于Experience Manager创作，复制Author实例。在同步菜单中，这是推送 > 内容。
推送将代码提交到您的Git存储库、当前分支上或作为拉取请求。
预览和发布将保存的内容放在预览站点*.aem.page上，然后放在实时站点*.aem.live上。

单独上传和推送。 Edge Delivery Services在存储代码以外的内容，因此推送代码不会保存您的页面，并且上传不会保存您的代码。当您能够在Experience Workspace中重新打开页面、编辑该页面并在预览站点上查看请求的更改时（而不仅仅是在存在预览链接时），您的第一个结果即已完成。

上传内容 upload-content

将页面上传到基于文档的内容存储库，作者可在其中在Experience Workspace中编辑页面。有些控制台标签和屏幕仍显示为“文档创作”。上传之前，请确认目标位置，以及是否可以替换该位置的任何现有页面。上载使用您自己的内容权限；请参阅内容推送权限。对于Experience Manager创作，请按照该设置的指南中的上传内容进行操作。

在工作区默认视图内容中，选择右上方的上传内容。或者，使用工作区标头中的Sync > Push > Content上传所有待处理页面。
上传内容对话框打开，目标组织和站点从您站点的配置中填充。如果字段为空，请在Experience Workspace中输入内容的组织和站点。
选择要上载的文件，然后选择上载。
完成后，该对话框会显示已上传的文件数。然后，您可以预览或预览并发布上传的页面。如果关闭对话框，上传操作将继续；重试任何失败的页面。
在AEM中查看

要查找上传的内容，请在上传完成时选择通知中的在AEM中查看，这会在Experience Workspace中打开网站的内容，或者转到https://da.live/#/{organization}/{repository}。

文档创作中的内容

打开已上传的页面，对其进行编辑，保存并重新打开该页面，以检查作者是否可以编辑该页面以及更改是否仍然有效。为站点启用了Experience Workspace的情况下，控制台中的 在Experience Workspace中编辑 将在其可视编辑器中打开所选页面。

推送代码更改 push-code-changes

查看代码差异，并在推送之前运行项目的检查。对需要审阅的工作使用拉取请求；有关强制审阅的内容，请参阅控制更改。

（可选）切换到更改视图（视图选取器中的分支图标）以查看差异。
在工作区标题中打开同步，然后选择推送 > 代码。
在 暂存更改 对话框中，暂存要推送的文件并选择继续。
在 推送更改 对话框中，输入提交消息。选择创建新的PR（默认）或推送到当前分支，然后选择确认进行推送。
- 创建新PR将推送名为aem-的新分支，后跟日期和时间，并将拉取请求打开到当前分支。拉取请求会列出新分支上页面的预览URL，以便查看者可以检查结果。您的控制台工作区停留在新分支上；要继续原始分支，请在更改视图中使用 切换分支 切换回原始分支。
- 推送到当前分支将提交添加到当前分支，并更新其拉取请求（如果有）。仅在项目策略允许并且您打算更改该分支时才使用它。在main，更改将立即生效。
完成后，控制台底部会显示通知。

如果已创建拉取请求，请在完成通知中选择查看PR。否则（例如对于通过Cloud Manager🔗连接的存储库），请验证目标分支上的提交。如果分支受到保护而不受到直接推送，则使用 创建新PR 推送。

GitHub中的

您的代码现在位于GitHub中。它立即在该分支的预览和实时URL上显示。

提交标识 commit-identity

控制台提交时，在控制台工作区中配置了Git标识user.name和user.email，并且为缺少的标识使用默认值。无论是在连接您的Git帐户还是在您自己的计算机上连接Git设置，都不会设置此标识。

如果其他人更改了分支 push-conflicts

分支是一系列保存的更改，称为提交。您的控制台工作区将保留您上次提取分支时的状态，因此，如果从那以后有其他人推送到该分支，则存储库具有您的工作区没有的提交。 推送到当前分支，然后在提交后添加您的提交并再次推送。如果您更改了不同的文件或行，则此操作将成功，并且您无需执行其他操作。

如果双方都更改了相同的行，则Git无法确定要保留的版本。这是一个冲突。控制台显示推送失败：远程存在冲突更改，无法自动合并，保留您的更改，并将对话框切换到创建新PR。

选择确认。控制台会将您的更改推送到新分支，并在您正在处理的分支中打开拉取请求。
在通知中选择查看PR。
解决冲突。如果只有几行冲突，请选择“解决GitHub中的冲突”并保留每个部件的正确版本；请参阅“解决GitHub上的合并冲突”🔗。如果冲突涉及多个文件，请要求开发人员在存储库的本地副本中解决这些冲突。
审核拉取请求后，将其合并。

控制台不会合并分支或自行解决冲突。同步 > 提取 > 代码的工作方式相同：如果提交与远程更改冲突，它会取消提取，保留原来的工作，并建议推送到新分支或请求代理提供帮助。为避免冲突，请在开始任务之前进行提取，经常推送少量更改，并同意更改哪些文件的团队。查看作为团队工作。