体验现代化控制台 console-reference
位于aemcoder.adobe.io的Experience Modernization Console是Experience Modernization Agent的Web界面：Edge Delivery Services的托管开发环境，您可以在其中描述聊天中的更改并检查、保存和发布结果。 它无需本地设置。 控制台在项目的托管副本上工作，这些文档称为控制台工作区。 它与基于文档的内容的可视化创作UI Experience Workspace无关；请参阅内容的存储位置以及作者如何编辑内容。 Experience Workspace取代了“文档创作”，并且某些控制台标签仍使用该名称。
本页介绍控制台的视图、控件和设置。 有关访问，请参阅访问和AI信用使用情况。 有关完整的过程，请选择开始的方法、生产迁移、重新设置样式或阻止开发。 如果您是控制台的新用户，请在聊天中询问代理进行浏览。
菜单栏 menu-bar
每页顶部的菜单栏提供：
控制台还在页面顶部显示通知，如服务状态以及最新版本的新增功能。 聊天、主页和设置可适应手机和平板电脑屏幕。 在电话上，聊天页面仅显示聊天。 在平板电脑上，它一次显示一个面板；在聊天和工作区标题之间切换。 在更宽的屏幕上，两个面板并排显示。
主页 home-page
主页页面是您开始工作的位置。
提示输入 prompt-input
提示输入提供了用于与AI交互的控件。
-
计划/执行模式（灯泡和魔棒图标）：分别在计划模式和执行模式之间切换。
- 计划模式：代理程序将分析您的请求并提出方法，而不更改文件。 它以包含步骤清单的计划结束。 将其用于多页面、共享代码或其他风险更改，以便在发生任何更改之前查看和调整方法。 选择 执行计划 以切换到“执行”模式并执行计划，或启动一个新的计划。 “规划”模式可随时使用，包括在规划或编录站点之前。 只有您切换模式；代理不能自己切换模式。
- 执行模式：代理执行请求并可以实际更改文件。
- 计划模式会更改代理在对话中的工作方式，而不是更改您的存储库或站点接受的内容。 在执行之前，请说明允许的范围以及是否授权上传、推送或发布。 查看更改控制。
-
附加文件（回形针图标）：将文件上载并附加到提示以查找其他上下文，例如参考设计、屏幕快照或规范。 代理会看到JPEG、PNG、GIF或WebP格式附加的图像。 您还可以附加文本文件以及Word、PowerPoint和Excel文件；代理接收它们的文本和嵌入的图像。 每个文件最大可达10 MB；不接受PDF文件。 首先检查附件中的密码、令牌和个人数据。 查看禁止聊天。
-
提示队列 （时钟图标）：当前提示完成后，可以排队自动执行其他提示，以便您无需等待即可排列后续任务。
-
上一个提示：在空的提示输入中，使用向上和向下箭头键调用以前的提示。 不会覆盖您启动的草稿。
-
提示提示：启用时，控制台会指出提示缺少详细信息（如页面或您预期的结果），并且可以建议更清晰的提示。 您可以决定是否使用提示。 除非您重述，否则不会标记控制台建议的提示。 在设置中的 提示指导 下配置提示。
聊天页面 chat-page
聊天页面是与代理交互的主界面。 此页面被拆分为可调整大小的聊天面板和工作区面板。
聊天面板 chat-panel
聊天面板允许您查看并继续与座席的对话。 聊天面板包括聊天消息历史记录和用于向控制台发出其他请求的提示输入。
对话将随控制台工作区一起保存。 当您重新加载页面或稍后返回时，将重新加载聊天历史记录。 使用箭头键回溯的提示只会在浏览器选项卡出现时出现。
可选功能 optional-capabilities
功能引用列出了内置工作流和可选加载项。 默认情况下，每个加载项都处于关闭状态，并且每个项目都处于打开状态，这可以让代理对于不需要它的项目保持更轻快。
- 当您的请求需要加载项时，代理会提供以将其打开，并首先要求您确认。 该加载项可从您的下一个消息中获取。
- 您还可以直接请求加载项，例如“启用表单迁移功能”，或描述您的任务并接受代理的优惠。
- 要查看哪些加载项已启用，请询问代理，例如“该项目启用了哪些加载项？” 要关闭一个，用同样的方法询问。 “设置”页面还没有加载项控件。
打开整个项目的加载项 persist-add-ons
代理将您在.agents/settings.json文件中打开的加载项保存在存储库的根目录中。 文件将按其ID列出每个加载项：
{
"enabledPlugins": {
"excat-figma@excat-extended": true,
"forms-excat@excat-extended": true
}
}
使用您的代码推送此文件。 每个签出存储库的工作区（包括团队成员的工作区和新对话）都从相同的加载项开始，无需再次询问。 您还可以要求代理更改文件，或在Git存储库中编辑该文件，并将更改拉入控制台。 要关闭加载项，请将其值设置为false或删除其行。 更改将从您的下一条消息中生效。
Workspace面板 workspace-panel
工作区面板显示所连接项目的工作内容和代码，不一定是站点上的每个远程页面。 其视图选取器可确定可用的操作。
了解您正在查看的结果 preview-states
*.aem.page)*.aem.live)预览的工作原理 how-preview-works
控制台预览不是Experience Manager环境。 它在您的工作区中运行AEM CLI (aem up)：与开发人员在其自己的计算机上运行的本地开发服务器相同。 它将与工作区中的内容页面一起提供工作区的代码。 页面请求的任何其他内容，如不在工作区中的片段或电子表格，均来自工作区当前分支https://{branch}--{site}--{organization}.aem.page的预览站点。
上传后，结果可能与预览网站不同，因为Edge Delivery Services会处理控制台预览所显示的内容。 在预览页面时，它会摄取内容并仅保留节、块和默认内容的结构。 删除了额外的元素，如span标记、数据属性和内联样式。 查看自带标记。 控制台预览会重现其中的几个步骤，例如将独立图像或链接包装在段落中并添加标题ID，因此接近标题，但不会删除任何内容。
请注意以下差异：
- Edge Delivery Services删除的 标记显示在控制台预览中，但在
aem.page上消失： 内联样式、span元素、数据属性以及结构外部的其他标记。 将页面保留为语义内容，并将样式放入项目的CSS中。 项目的JavaScript仍可以在浏览器中重构页面，这在这两个位置都是相同的。 - 预览网站中的内容：片段、电子表格和其他不在工作区中的文件将显示上次在分支的预览网站上预览的版本。
- 图像：图像可以在控制台预览中显示，如果未正确上传，则在
aem.page上仍会损坏。 再次上传页面。 - Experience Manager创作项目：上载操作会将每个页面转换为必须符合项目组件模型的JCR内容。 预览会显示该转换之前的页面。 在上传之前，请检查 JCR XML视图 中的转换结构，之后检查通用编辑器中的页面。
要检查交付的页面，请上传该页面，预览该页面，然后在分支的aem.page URL上将其打开。 查看控制台预览与站点不同。
内容查看 content-view
内容视图以不同的形式显示选定的页面，以便您可以检查结果的各个方面。 可折叠的文件浏览器会列出您网站的页面：
-
工作区中的页面显示为文件。
-
仅存在于内容目标中的页面会显示一个云图标。 在基于文档的项目中，这些是Experience Workspace中的页面。 在其他项目（包括Experience Manager创作项目）中，它们是已预览或发布的页面。 打开云页面会将其下载到您的工作区。
-
预览（带有放大镜图标的文档）从工作区的当前代码和内容中呈现所选页面。 使用它可检查访客看到的页面。 它不会更新创作环境或您的Git存储库。 查看预览的工作方式。
-
文档视图 （文档图标）显示基于文档的基础内容结构。 使用它可以检查如何将内容组织到分区、块和默认内容中。
-
HTML视图（代码图标）显示原始HTML。 使用它调试渲染并阻止修饰。
-
Markdown视图（段落图标，Experience Manager创作）显示基础Markdown内容结构。 使用它可在转换之前检查内容。
-
JCR XML视图（数据图标，Experience Manager创作）显示生成的JCR XML内容结构。 使用它可检查要导入到创作实例中的内容。
以下操作在内容视图中可用：
- 刷新图标以重新加载预览面板对控制台工作区副本的渲染。 它不会从Experience Workspace获取内容。 若要使用保存的文档替换控制台的副本，请使用同步 > 提取 > 内容。 要替换单个页面，请删除其本地副本，然后再次打开该页面。
- 视区菜单，用于查看以 Responsive 宽度（默认值，用于填充面板）或以固定的Desktop、Tablet或 Mobile 大小渲染的页面
- 检查模式 （选择图标）以将页面的某个元素添加到提示中，以便代理限制对该元素所做的更改。 查看进行您的第一次更改。
- 新窗口 （在图标中打开）以在新选项卡中打开预览URL（用于完整桌面预览）
- 在Experience Workspace中编辑（基于文档的项目）会在新选项卡中打开Experience Workspace可视编辑器中的选定页面，该页面使用控制台工作区的当前分支预览。 如果页面具有尚未上载到Experience Workspace的本地更改，则控制台将首先提供上载和编辑，这样您就不会编辑旧版本。 Experience Manager创作项目改用通用编辑器。
- 删除从控制台工作区中删除所选页面，一次删除一个页面；它无法删除文件夹。 无法撤消此操作，并且不会删除已上传、预览或发布的内容。 如果内容目标中存在页面，则该页面会再次显示并带有云图标，打开它将会下载保存的版本。 您无法删除云页面。 请参阅删除页面。
- 错误按钮（Experience Manager创作）将打开一个模式窗口以查看选定页面上的错误。
- 上载内容将打开特定于目标的上载或包对话框。 在继续之前，请检查目标路径和覆盖含义。
上传到Experience Workspace后，“结果”对话框会显示已上传的文件，并允许您预览或预览和发布预览网站和实时网站上已上传的页面。 此作为跟踪作业运行：如果您离开对话框，它将继续，并且通知中的 查看详细信息 将重新打开其结果。 从结果重试失败的页面。 如果未成功预览任何页面，则不会发布任何内容。
在上传代理所做的内容更改或要求代理将它们写入具有代理权限的Experience Workspace之前，代理所做的内容更改将保留在控制台工作区中。
“同步”菜单 sync-menu
同步将您的独立控制台工作区连接到项目的Git存储库和内容目标。 推送代码和推送内容是单独的操作，您可以选择要发送哪些更改的文件或页面。 您在控制台工作区中保留的更改不会影响项目。
工作区标题中的 同步 按钮会显示一个包含挂起更改数量的标记。 打开它以在控制台工作区与其远程位置之间移动内容和代码：Experience Workspace或创作实例的内容，以及您的Git存储库的代码。
演示站点中已禁用同步。 推送和拉取功能会告知您Experience Workspace会话何时过期。
代码视图 code-view
代码视图提供了用于浏览项目文件和管理代码更改的工具。 该视图包括一个文件浏览器，用于概览代码文件或作为差异的更改，以及一个预览区域，用于查看选定的一个或多个更改。
- 文件浏览当前工作区中的代码文件
- 更改以查看您项目工作所创建的文件更改的差异
文件操作 file-actions
- 添加到聊天将所选文件（或来自文件的所选行）添加到上下文的聊天面板。
- 下载将所选文件下载到您的计算机。
更改操作 changes-actions
- 添加 （+图标）以暂存更改的文件
- 放弃 （箭头图标）以放弃更改的文件
- 删除（垃圾桶图标）以删除未暂存的文件
- 刷新 （刷新图标）以刷新更改列表
- 切换分支：在同一存储库中切换分支
若要推送代码，请在同步菜单中使用同步 > 推送 > 代码。 阶段更改对话框允许您选择文件，推送更改对话框会要求您提交消息以及是要创建新的拉取请求还是推送到当前分支；请参阅推送代码更改以了解每个选项的用途。 若要提取最新的代码，请使用同步 > 提取 > 代码。 当GitHub未连接或安装AEM代码连接器之前，代码操作在演示站点中不可用；控制台将告诉您哪种操作适用。 有关推送的代码到达预览网站和实时网站的时间，请参阅更改如何上线。
推送代码不会上传内容，放弃本地代码也不会撤消已上传的内容。
若要连接、重新连接或切换GitHub存储库，请使用设置页面。
项目查看 project-view
项目视图可帮助您计划现有站点的迁移。
- 计划审核和优化站点目录标识的模板、页面和块，以便在导入其余模板之前，您可以迁移和检查每个模板的一个示例页面
有关详细信息，请参阅规划视图。
“设置”页面 settings-page
设置页面允许您管理控制台的基本设置，该页面分为以下部分。 请在此处输入凭据，切勿在聊天中输入。 查看禁止聊天。
如果您更改了任何分区中的任何值，请选择 保存 以将这些更改保存到单个分区。 对于代理权限、站点身份验证和凭据，在更改生效之前，按钮显示正在应用……。 选择“上一步”图标以返回到上一个视图。
-
项目允许您查看和编辑项目设置，如管理GitHub连接和自定义库URL。
- 连接/重新连接：启动GitHub身份验证
- 切换站点：在控制台工作区中打开其他站点和存储库。 当前网站的文件和聊天会在您切换回时保留。
- 注销：断开与GitHub的连接，并撤销代理对您的GitHub凭据的访问权限
- 库URL — 此URL指向一个
library.json文件，该文件定义了可供作者使用的块、其变体和示例内容。 - 站点基本URL — 正在迁移的网站的源URL
-
代理权限 — 控制代理代表您访问的内容。 在打开并保存权限之前，每个权限都处于关闭状态。 代理使用权限而不接收凭据本身。 请参阅安全和数据处理。
- 允许LLM将我的Adobe凭据用于admin.hlx.page、Document Authoring以及托管在GitHub外部的存储库 — 在 Adobe IMS权限（admin.hlx.page和Document Authoring） 分区。 启用后，代理可以使用您的Adobe凭据读取站点配置和元数据、读取Experience Workspace内容，以及推送到GitHub外部托管的存储库或从这些存储库进行拉取。
admin.hlx.page是Edge Delivery Services的管理员API；hlx来自Helix，开发其架构时所用的项目名称。 这不批准发布：除非您要求，否则控制台将停止代理上传、预览或发布。 查看更改控制。 - 自定义IMS令牌（可选） — 为代理提供一个令牌，以代替您的会话令牌。 IMS是Adobe的标识服务，该服务将为您的Adobe ID会话颁发令牌。 在可能的情况下，将服务帐户的令牌（也称为技术帐户）优先于个人令牌，以便代理的访问不取决于您自己的帐户。 将该字段留空以使用您的会话令牌；部分显示正在使用哪个令牌。
- 允许LLM使用我的Git凭据 — 在可用时，允许代理代表您推送和拉取您的GitHub存储库。 如果未看到此设置，则表示您尚无法使用此设置；请使用同步 > 推送 > 代码推送代理的更改。 启用后，代理可以推送到GitHub凭据可以写入的任何存储库和分支，包括
main。 存储库中的分支保护仍然适用。 这将授予提升的访问权限，因此请为代理提供其自己的令牌。 - 自定义Git令牌（可选，推荐） — 供代理使用的个人访问令牌而不是工作区的Git凭据。 创建一个细粒度令牌，仅限定在代理所需的存储库范围内。 将该字段留空以使用工作区的现有凭据。
- 允许LLM将我的Adobe凭据用于admin.hlx.page、Document Authoring以及托管在GitHub外部的存储库 — 在 Adobe IMS权限（admin.hlx.page和Document Authoring） 分区。 启用后，代理可以使用您的Adobe凭据读取站点配置和元数据、读取Experience Workspace内容，以及推送到GitHub外部托管的存储库或从这些存储库进行拉取。
-
凭据允许您为Figma指定个人访问令牌，以便代理可以读取您的Figma设计。 它与代理从设计中读取的设计令牌（例如颜色和间距）无关。 有关令牌可读取的内容，请参阅图形和设计系统。
-
令牌需要以下只读范围：
file_content:readfile_metadata:readlibrary_assets:readlibrary_content:readteam_library_content:readfile_dev_resources:readprojects:read
-
-
受保护的站点身份验证 — 配置自定义请求标头、HTTP基本身份验证或持有者身份验证，以便代理可以读取需要登录或机密标头的源页面，或调用需要密钥的其他服务，如API。 有关安装说明，请参阅受保护的站点身份验证，有关其他服务的凭据。
-
提示指导 — 在可用的情况下，控制提示缺少详细信息时显示的提示提示，例如页面或预期的结果。
- 显示提示提示打开或关闭提示。
- 其他选项可以检查设备上的提示，设备会将模型下载到浏览器。 关闭此选项将删除下载的模型。
-
支持汇总了支持请求与构建代理的团队共享的信息。
- 请求支持 — 选择它以打开支持请求，而不离开控制台。
-
危险区域包含可以还原控制台工作区的设置。
- 重置工作区 — 结束会话，断开GitHub连接，并永久删除打开项目的聊天历史记录、其代理会话的转录及其代码，包括您尚未提交或推送的更改。 无法撤消此操作。 您推送的代码和上传的内容会保留在远程位置；重置不会恢复远程内容。
受保护的站点身份验证 protected-site-authentication
许多网站只向登录访客显示某些页面，在密码后保留暂存副本，或者具有仅允许通过携带机密标头请求的CDN。 使用 受保护的站点身份验证 让代理在接受自定义请求标头、HTTP基本身份验证或持有者身份验证时读取此类源站点。 然后，您可以使用与公共页面相同的方式迁移这些页面。
源站点必须可以从代理在Internet上的托管环境访问，并且必须配置为接受您提供的身份验证方法。 此功能不会通过VPN连接，并且不会完成交互式登录流程，例如单点登录(SSO)表单或多重身份验证。 防火墙允许代理在其管理员允许列表代理的地址时通过。 如果源只能在专用网络上访问，请向其管理员请求可访问Internet的暂存或源主机，该主机接受一种受支持的方法。
要配置访问权限，请执行以下操作：
-
在Experience Modernization Console中打开设置，查找受保护的站点身份验证。
-
选择添加站点。
-
输入站点主机名，如
staging.example.com。 仅输入主机名，不输入https://或URL路径。 -
选择 身份验证类型 并输入相应的值。
table 0-row-2 1-row-2 2-row-2 3-row-2 身份验证类型 要输入的值 自定义标题 标头名称和标头值，这是您的源网站所必需的。 例如，标头名称可以是 X-API-Key。基本（用户名和密码） HTTP基本身份验证的 用户名 和密码。 持有者令牌 您的源网站接受的持有者令牌。 -
在 受保护的站点身份验证 分区中选择保存。 此部分显示正在应用……，直到更改生效，这最多可能需要两分钟。
-
要求代理正常使用其URL擦除或迁移源网站。
保存后，凭据将仅添加到对匹配主机名的出站请求中，而不会与AI模型共享。
使用范围界定、权限最低的凭据，最好是使用对源内容具有只读访问权限的专用帐户。 每个主机名只能配置一次。 如果源网站从其他主机（如资产域）加载受保护的内容，请单独配置其他主机名。
在启动目录或批处理运行之前检查一个受保护的页面：其捕获必须显示页面内容，而不是登录页面。
要删除访问权限，请为该条目选择删除站点，然后选择保存。 迁移完成后删除该条目。
其他服务的凭据 other-services
相同的设置适用于代理程序在工作时调用的任何服务，而不仅适用于源站点。 为服务的主机名添加一个条目，例如api.example.com，该条目具有服务所需的标头或令牌。 您可以根据需要添加任意数量的条目，每个主机名各一个。 控制台将凭据添加到代理对该主机名发出的每个请求中，包括来自其运行的脚本和命令的请求。 AI模型不会收到凭据，但代理会看到服务的响应。
- 告知代理为主机名和服务内容设置了凭据。 未通知代理有关 设置 中的条目，因此代理在其他情况下不会知道这些条目。
- 主机名必须完全匹配。 将
www.example.com和api.example.com添加为单独的条目。 无法使用IP地址和localhost。 - 控制台向每个请求添加一个固定标头。 如果服务需要在URL中使用令牌，或者为每次调用签名请求，则需要其他方法。
- 控制台已验证的主机（如GitHub和Figma）继续使用控制台自己的凭据。
- 使用仅具有任务所需访问权限的令牌，并在您不再需要它时删除该条目。
这些凭据用于在控制台中处理代理的工作。 您的发布站点不能使用它们：实时站点所需的密钥属于服务器端服务。 请参阅连接服务和应用程序。 有关将代理连接到聊天工具的示例，请参阅示例： Slack中的更新。
请求支持 request-support
当某些组件无法按预期工作，或者您遇到这些页面无法回答的问题时，请告知构建代理的团队。 您的请求将直接发送给该团队，该团队会检查您的请求并通过电子邮件进行跟进。 要会见主题专家或产品团队，请参阅代理背后的团队。
- 在菜单栏或“设置”页面中选择请求支持。 在小屏幕上，按钮仅显示其图标。
- 可选选择主题：布局/设计、缺少内容、代理卡住或其他内容。
- 在 中出现了什么问题？ 中，请用最多2,000个字符描述问题。 命名受影响的页面、您预期的内容、发生的情况以及时间。 不包括密码或令牌。
- （可选）选择要附加的最近提示，以便团队可以查看您询问的内容。 除非您选择它，否则不附加任何内容。
- 选择发送。
该请求共享您的联系详情以及团队需要查找您的会话的对话和日志的会话详细信息；请参阅支持请求以获取完整列表。 您每分钟可以发送一个请求。
当对话表明您被困住或沮丧时，提示教练可能会在 需要帮助？ 下提供帮助 选择 联系支持人员 打开同一请求，或选择 不谢 继续。
在自动模式页面上，按钮为获取帮助。 使用它可要求更多页面或更多并发迁移，或询问有关“自动”模式的任何信息。 描述您在中需要什么我们如何提供帮助？ 并选择发送。 团队通过电子邮件回复。
新增功能和发行说明 whats-new
发布控制台的新版本后，页面顶部的 新增功能 通知列出了其亮点。 展开该列表以查看列表，或将其关闭。 它会在下一个版本中重新显示。
有关每个版本的详细信息，请参阅Experience Modernization Agent发行说明。