评估和批准Experience现代化代理 evaluate
本页适用于为在Edge Delivery Services上构建或迁移Adobe Experience Manager站点的团队批准Experience现代化代理的人员：可能从未亲自使用代理的架构师、技术主管或平台所有者。 它解释了您团队的更改，运行迁移的三种方法，Adobe团队如何与您的团队协作，代理接触了哪些系统和数据，如何控制和跟踪更改，以及还有什么保留的项目工作。
有关Edge Delivery Services的含义以及项目如何组合，请参阅如何构建和更新您的网站。 您自己页面上的结果所显示的说明比任何说明都多，因此请团队成员在阅读时从自动模式开始或逐步导入页面。
您的团队有何变化 team-impact
如果没有代理，迁移到Edge Delivery Services需要经过数周开发人员的工作才能开始进行，然后才能判断结果：列出源页面、按布局对其进行分组、将其内容映射到块、编写块代码和样式以及编写导入脚本。 代理在没有任何可安装的托管环境中与您的团队重复执行该操作。
- 您的团队决定和审核；代理生成。 人们设定范围、内容模型、目标设计和集成，并接受结果。 代理编写代码，导入内容，并将结果与源进行比较。
- 更多人直接投稿。 了解一些HTML和Git基础知识的设计师、内容专家和营销人员会通过用简单的语言描述它们来进行更改。 开发人员通过将这些更改作为拉取请求进行审核来保留对生产过程的控制。 查看更广泛的贡献，相同的生产控制。
- 工作量随布局而增长，而不是随页面增长。 更正会更改可重复使用的块或导入脚本，而不是更改一个页面，因此它会应用于同一布局的每个页面。 一个有5000页、共12种布局的网站，大部分都是由12个模板组成的。 查看代理如何按比例迁移，并根据第一个模板调整工作大小，提交前预估。
- 结果是一个标准项目。 该代码是您的Git存储库中的纯HTML、CSS和JavaScript，遵循AEM样板的约定。 站点在运行时不依赖于代理，开发人员可以在自己的编辑器中或使用其他AI工具继续操作。
- 项目知识保留在存储库中。 您的团队同意的惯例在
AGENTS.md和相关文件中有效，代理和新团队成员都遵循这些惯例。 请参阅项目说明和内存。
座席的工作和您所在团队的工作 responsibilities
有关迁移潜在客户如何协调参与者，请参阅迁移潜在客户。 多个人员可以在各自的控制台工作区中处理一个项目；请参阅作为团队工作。
剩余项目工作 project-work
代理是开发代理：可以使用它在Edge Delivery Services上构建什么。 但是，迁移会复制源页面显示的内容，而不是源页面背后的系统。 代理将重新构建站点：其页面、块、样式和调用您的服务的代码。 批准和发布工作流程、集成背后的后端系统，以及您的团队在新站点上的工作方式仍然是您组织的工作方式。 这些需求需要先由您的团队做出决定，然后座席才能生成这些需求：
有关导入的源访问、交互式内容和其他边界，请参阅限制。
图形和设计系统 figma
图形可以成为新设计的源头。 使用Figma导入加载项，代理通过Figma的API使用模型上下文协议(MCP)服务器读取选定的组件或帧，就像开发人员读取设计移交一样。 它会将设计的变量和样式（如颜色、排版规则和间距）写入项目的全局样式中，作为CSS自定义属性。 这些属性是网站的设计令牌。 它们驻留在代码中，而不是单独的令牌导出中，因此设计人员和开发人员会像审阅任何其他更改一样审阅它们。 有关设计人员如何从Figma与代理一起工作，请参阅从Figma设计工作。
批准内容：
- 访问：每个将Figma与代理一起使用的人都会创建具有只读范围的Figma个人访问令牌并将其存储在控制台的设置中。 Figma会生成和管理此访问令牌，这与设计令牌无关。 没有组织范围的Figma连接，并且个人访问令牌不能仅限于特定文件：它会读取其所有者可以打开的所有文件。
- 名额和速率限制： Figma根据令牌所有者的名额和拥有文件的计划，限制令牌读取文件的频率。 使用View或Collab座席，令牌一个月只能通过Figma的API读取文件几次，因此将Figma与代理结合使用的人需要Dev或Full座席。 查看Figma的速率限制。
- 数据：对于选定的框架或组件，代理会将其结构、屏幕快照、变量及其文本发送到AI模型。 查看AI模型处理什么。
选择迁移的运行方式 approaches
同一代理可以通过三种方式运行迁移。 在驱动代理和应答结果方面，它们各有不同。 这三者都会生成一个标准的Edge Delivery Services项目，其中包含Git存储库中的代码以及作者编辑的内容，因此您可以从一个项目移动到下一个项目：将自动模式结果传输到您自己的站点并继续在控制台中运行，或者在与代理结果工程师接触后自己继续运行代理。
代理背后的团队 adobe-team
在选择座席时，您还可以选择构建座席的团队及其采用的方向。 人们在网络上查找信息的方式正在发生变化：更多的人会问人工智能助手，后者会根据它在品牌自己的网站上所读到的内容做出回答。 代理可以一起更改网站的内容、设计和代码，因此在需要项目时可能需要几个小时的更改。 该团队的任务是帮助您迁移至Edge Delivery Services，充分利用Experience Manager，并使用代理开发工具来构建在这些迁移持续进行时保持相关性的站点。 它在迁移时不会结束，代理会不断更改；发行说明列出了每个更改。
当变化很便宜时，困难的部分是决定要改变什么，保持其可控性，并为代理商提供正确的品牌、设计和商业环境。 这些知识存在于您的团队和系统中。 Adobe的团队可帮助您将其连接到平台：
- 可以与您一起运行迁移的工程师。 对于复杂的迁移，Adobe的代理结果工程师可以与您的团队一起操作代理，并将站点移交给代理。 请参阅选择迁移的运行方式。
- 产品更改时当前状态。 控制台的 新增功能 通知列出了每个版本的要点。 要应用对您自己的站点的更改、审查您的架构或讨论工程师尚未满足的需求，请让您的Adobe客户成功经理或客户团队与主题专家和产品团队开会。
- 您的体验塑造产品。 产品团队与客户和合作伙伴交换专业知识，并与部分客户合作开发新功能。 您报告的内容会馈送到团队下一步的修复和构建内容。
若要从控制台联系团队，请使用请求支持，或在“自动模式”页面上获取帮助。 您的消息将直接发送给构建代理的团队，该团队会查看该消息并通过电子邮件进行跟进。 请参阅请求支持，以及请求共享的内容支持请求。
Adobe团队与实施合作伙伴的工作方式相同，因此与您的合作伙伴一起，网站在迁移后会持续改进。
系统和数据流 systems
代理在托管环境中工作，并且仅通过用户设置的连接及其授予的权限访问您的系统。
aemcoder.adobe.io的托管环境，用户在该环境中处理代理。aem.page上的预览站点和aem.live上的实时站点。安全性和数据处理 security
通过控制台，代理可以在您的网站上工作，而无需向其提供您配置的凭据，并且您可以决定更改何时到达您的Git存储库和内容目标。
访问和隔离 security-access
- 您可以使用Adobe ID登录到控制台。 每个请求都通过Adobe Identity Management Services (IMS)进行身份验证。
- 每个用户在单独的后端环境中工作，并具有自己的Workspace存储空间，即在其登录的每个Adobe组织中的一个存储空间。 控制台在用户首次登录时创建环境，并在空闲时暂停环境。
- 控制台没有项目角色。 任何有权访问的人都可以向座席询问对自己的工作区所做的任何更改。 Experience Manager和您的Git提供商将继续对离开工作区的任何代码或内容强制实施各自的权限。
凭据 security-credentials
- AI代理不会收到您在控制台中配置的凭据。 GitHub、Cloud Manager Git存储库、Experience Workspace、Figma和受保护的源站点的令牌在代理的环境之外持有。 单独的组件仅将每个凭据添加到其所属服务的请求中。 这同样适用于用于调用AI模型的凭据。
- 凭据属于配置凭据的用户，而不属于项目。 每个团队成员都会连接自己的Git帐户并存储自己的Figma令牌。
- 代理权限在打开之前处于关闭状态。 打开一个选项可以让代理使用该访问权限进行操作，例如，推送到您的存储库，而无需看到凭据。 默认情况下，权限使用用户自己的登录。 要缩小代理可以访问的范围，请为其输入令牌：范围限定为其需要的存储库的细粒度个人访问令牌或Adobe服务帐户的令牌。
- 代理在工作时调用的其他服务（如测试API）以相同的方式从服务主机名的 受保护站点身份验证 中的条目获取其凭据。 查看其他服务的凭据。
- 将凭据仅存储在控制台的设置中，不在提示、聊天、源内容或项目文件中：代理会读取这些凭据并将它们发送到AI模型。 将此作为载入的一部分，因为对编码代理陌生的人可以在聊天中粘贴密码或密钥以完成任务。 要求使用该控制台的每个人首先阅读禁止聊天，并告诉他们您组织的策略允许他们与AI工具共享的内容。
AI模型处理什么 security-model-data
要执行请求，代理可以将以下内容发送到它使用的大型语言模型(LLM)，当前为Claude模型：
- 您的提示和说明。
- Source页面URL、标记和内容，或导出的CMS内容。
- 存储库代码和配置，例如块、样式和站点配置。
- 设计和品牌参考，例如Figma设计和屏幕截图。
- 生成的内容和代码正在审核中。
Adobe不使用您的对话或其他客户数据来训练或微调AI模型。
控制更改 security-control
代理在控制台工作区中工作，您可以在控制台工作区中查看其更改和预览。 工作通过单独的步骤访问您的网站，每个步骤都有自己的控制权：
- 该控制台自己的检查是保护措施，而不是批准门。 可选计划模式允许您在代理启动之前批准计划。 控制台还会阻止代理上传、预览或发布，除非您当前的消息询问此问题或您同意代理询问，但控制台无法检测到发出此类请求的所有方式。 这两项检查都不会阻止拥有访问权限的用户推送或发布。
- 拥有Git权限，代理可以推送至您的凭据可以写入的任何分支，包括
main。 推送到main会更改实时网站的代码。 - 要要求审查，请在更改生效的地方强制执行。 使用分支保护保护
main，该保护需要审阅的拉取请求，使用推送创建新PR，并限制可以使用站点的发布角色发布的人员。 拉取请求会列出更改的文件以及受影响页面的预览URL，以便开发人员在合并之前检查结果。 在更多人贡献之前设置这些控制，仅在任务需要代理权限时才打开代理权限。 查看更广泛的贡献，相同的生产控制。 - 将源页面和设计文件视为不受信任的输入。 它们可以包含尝试引导代理的文本。 在推送、预览或发布更改之前对其进行审核。
内容推送权限 content-push-permissions
当您使用Adobe登录上传内容时，目标将强制实施您帐户的权限。 对于在Experience Workspace中编辑的基于文档的内容，您需要对目标内容的写入访问权限。 对于Experience Manager创作，您需要权限才能在创作实例上的选定路径下编写页面和资源。 登录到控制台不会授予这些权限。
打开代理的Adobe凭据权限时，其内容推送到基于文档的内容存储库将使用您帐户的访问权限。 要求代理上传不会绕过目标的权限。 对于Experience Manager创作，请自行通过控制台上传内容；不支持直接代理上传。
如果基于文档的上传由于您的登录不可用或身份验证失败而使用配置的回退帐户，则目标将强制实施该帐户的权限。 当您为代理明确配置服务帐户时，同样适用。 在依赖个人权限限制更改之前，请确认使用了哪个帐户。
跟踪代理人的行为 audit-trail
控制台不保留单独的审核日志，但代理的工作不会取消记录。 代理生成的内容仅通过您的Git存储库或Experience Manager访问您的网站，并且两者都会保留历史记录：
- 代码是主要记录。 Git历史记录会记录对块、样式和导入脚本的每次更改，并且导入脚本会定义每个导入页面的结构。
- 内容更改随内容一起记录。 Experience Workspace保留每个文档的版本历史记录，而创作实例则保留其自己的页面版本。
- 对话显示询问的内容。 下载聊天将对话保存为Markdown文件。 在选择 清除聊天 之前下载它，这将删除消息且无法撤消。 查看聊天面板。
当对代理的每个请求都以自己的提交结束时，记录最容易遵循，即推送到工作分支而不是main，如果页面发生更改，记录会上载自己的内容，由代理提供并由人员批准。 在项目的AGENTS.md中询问此请求；请参阅为每个请求留下记录。 随后，查看者在他们已使用的工具中按请求阅读代理更改了哪些内容。
工作存储位置 security-storage
- 您推送的代码存储在Git存储库中，您上传的内容存储在Experience Workspace中或您的创作实例上。 他们自己的保留和版本历史记录策略适用。
- 您尚未推送或上传的工作仅存在于您的控制台工作区中，以及聊天历史记录和座席会话记录。 清除聊天从聊天面板中删除消息，但保留成绩单。 要删除控制台工作区中打开的项目工作（包括成绩单），请使用重置工作区。
有关处理位置、数据保留和合规性信息，请与您的Adobe客户团队联系或查看Adobe信任中心。
运行状况数据和HIPAA security-hipaa
Experience Modernization Agent是用于迁移和构建站点的开发人员工具。 您网站的访客永远不会访问它： Edge Delivery Services为发布的网站提供服务，访客的请求不会通过控制台或代理。 您可以迁移医疗保健站点的页面、设计和资产，而无需使用患者数据。 切勿向代理提供真实的最终用户数据，如患者记录或您的用户的凭据，也不要迁移包含这些数据的页面或资产。 使用虚构的数据来开发和测试特定于患者的布局。 无论您给代理什么，都可以访问AI模型；请参阅AI模型处理什么。
暂存站点、允许列表或源登录不会更改此限制。 在导入受保护的源之前，请检查范围内的页面和资产，并将源帐户限制为不包含受保护的运行状况信息(PHI)的内容。 通过源身份验证配置该帐户，而不是在聊天中配置。
对于将按照健康保险流通与责任法案(HIPAA)处理PHI的网站，请确认与您的Adobe客户团队一起进行创作和交付设置，包括所需的许可证、商业伙伴协议(BAA)和配置。 Adobe Experience Manager as a Cloud Service的HIPAA就绪性将Edge Delivery Services列为HIPAA就绪性，但通用编辑器列为HIPAA就绪性；仅当未引入PHI时，才能将其添加到扩展安全程序中。 支持HIPAA的投放服务不会将其PHI覆盖范围扩展到代理或未支持HIPAA的编辑器。
支持请求 security-support
支持请求将发送给构建代理的Adobe团队。 使用发送者编写的主题和描述，它会共享：
- 发件人姓名、电子邮件地址以及Adobe用户和组织ID。
- 会话ID、项目名称和预览URL，以及GitHub Enterprise的Git主机。
- 发件人选择附加的任何最近提示。 默认情况下不附加任何内容。
这些详细信息可让团队查找会话的对话和日志。 在设置发件人的控制台工作区之前，请求仅共享姓名、电子邮件地址和组织。 在“自动”模式页面上，获取帮助仅共享发件人的姓名和电子邮件地址及其消息。 要求用户不要在描述中包含密码、令牌或个人数据。 请参阅请求支持。
后续步骤 next-steps
您的团队同意范围、方法和控制后，请按照迁移生产站点操作。 在提交该工作之前，对您自己的页面使用自动模式进行首次检查。