評估及核准Experience現代化代理程式 evaluate

此頁面適用於核准在Edge Delivery Services上建立或移轉Adobe Experience Manager網站的團隊之Experience現代化代理程式的人員:可能從未親自使用代理程式的架構師、技術主管或平台擁有者。 本檔案說明您團隊的哪些變更、執行移轉的三種方式、Adobe團隊如何與您的團隊合作、代理程式接觸哪些系統和資料、如何控制及追蹤變更,以及專案剩餘工作。

如需Edge Delivery Services是什麼以及專案如何組合,請參閱如何建置和更新您的網站。 在您自己的網頁上得到的結果比任何描述都多,因此請團隊成員在您閱讀時以自動模式開始,或逐步匯入頁面。

您的團隊有何變更 team-impact

若沒有代理程式,移轉至Edge Delivery Services的程式必須先經過數週的開發人員工作,才可供任何人判斷結果:列出來源頁面、依版面配置分組、將內容對應至區塊、撰寫區塊程式碼和樣式,以及撰寫匯入指令碼。 代理程式會在沒有可安裝專案的託管環境中,與您的團隊重複工作。

  • 您的團隊決定並稽核;代理程式產生。 人們設定範圍、內容模型、目標設計和整合,並接受結果。 代理程式會寫入程式碼、匯入內容,並將結果與來源進行比較。
  • 更多人員直接參與。 瞭解部分HTML和Git基本知識的設計師、內容專家和行銷人員會透過以淺白語言描述來進行變更。 開發人員會以提取請求的形式檢閱這些變更,以控管生產環境。 檢視更廣的貢獻,相同的生產控制。
  • 工作量會隨著版面配置而增加,而不是隨著頁面增加。 更正會變更可重複使用的區塊或匯入指令碼,而不是一個頁面,因此會套用至相同版面的每個頁面。 一個有5,000頁、共用12個版面的網站,大部分都是12個範本的作品。 檢視代理程式如何依比例移轉,以及從第一個範本調整工作大小,在您認可之前先預估。
  • 結果為標準專案。 程式碼是您Git存放庫中的純HTML、CSS和JavaScript,遵循AEM範本的慣例。 網站在執行階段並不依賴代理程式,開發人員可以在自己的編輯器中或使用其他AI工具繼續進行。
  • 專案知識保留在存放庫中。 您的團隊同意的慣例在AGENTS.md和相關檔案中上線,代理人和新團隊成員都遵循這些慣例。 請參閱專案指示與記憶體。

Agent的功用與團隊的功用 responsibilities

區域
代理程式的作用
您的團隊會做什麼
詳細目錄和範圍
從網站地圖和連結中探索頁面、將其分組為範本,以及報告區塊和區域設定。 檢視網站目錄。
協調結果與您自己的詳細目錄,並決定要移轉、重新導向或淘汰的專案。
內容模型
將每個範本的內容對應至區段、預設內容和區塊。
檢查作者是否可以輕鬆編輯結果,並同意慣例。 檢視David的模型。
設計
將顏色、字型和間距擷取到CSS自訂屬性和樣式區塊,以符合來源或新設計,包括Figma中的設計。
核准目標設計,並檢查回應式行為和協助工具。
內容匯入
為每個範本撰寫匯入指令碼、大量匯入頁面,並與其來源頁面進行比較。
驗證範例頁面,檢閱作為程式碼的匯入指令碼,因為它們決定每個匯入頁面的結構,並接受匯入頁面。
影像和檔案
上傳頁面搭配頁面使用的影像。 在Dynamic Media上保留Dynamic Media影像。
檢查替代文字、影像品質和連結的檔案,例如PDF。 檢視影像和檔案。
URL和搜尋中繼資料
延續頁面標題、說明和社交影像。 從每個頁面的來源URL衍生每個頁面的路徑。
決定URL原則,並建立並檢查重新導向、網站地圖和語言替代專案。 請參閱URL、重新導向及搜尋中繼資料。
整合
針對任何具有紀錄API的系統,寫入呼叫API和服務的區塊和程式碼,如同一般用途編碼代理程式一般。 選用的附加元件可移轉表單和商務頁面。
決定每個整合的運作方式、提供API存取權和檔案,並接受結果。 請參閱連線服務與應用程式。
檢閱和發行
準備程式碼變更做為列出預覽URL的提取請求。
開發人員檢閱和合併,以及作者預覽和發佈。 專案負責人同意在移轉開始前簽署結果的條件,然後簽署並執行轉換。 檢視檢查並登出。
上線後
重新設定網站樣式、新增並重新調整專案的區塊、除錯和檔案。
擁有網站、其程式碼、其內容及其作業。

如需移轉潛在客戶如何協調參與者,請參閱潛在客戶移轉。 有數個人可以在一個專案上工作,每個專案都在自己的主控台工作區中;請參閱以團隊身分工作。

專案剩餘工作 project-work

代理是開發代理:可以使用它在Edge Delivery Services上建置什麼。 移轉會複製來源頁面顯示的內容,而非頁面背後的系統。 代理程式會重新建立網站:其頁面、區塊、樣式以及呼叫服務的程式碼。 核准和發佈工作流程、整合背後的後端系統,以及您的團隊在新網站上的工作方式,仍然是您組織的工作。 這些需求需要先由您的團隊決定,代理程式才能建置這些需求:

需要
匯入為您提供的內容
要決定的專案,然後使用代理程式建置
共用內容,例如許多頁面上的橫幅或免責宣告
每頁一份
要保留一次並作為片段包含的內容,以及包含該內容的區塊。
數種語言或市場
來源路徑的頁面,及其地區設定資料夾
URL結構、網站地圖中的語言替代項,以及市場之間的翻譯和繼承如何為作者運作。 請參閱翻譯與本地化。
Personalization、搜尋和帳戶功能
匯入時每個頁面的輸出
提供邏輯的服務,以及呼叫邏輯的區塊。
Forms
表單欄位,以及授權Experience Manager Forms的組織的表單附加元件
接收提交內容的系統,例如行銷自動化平台或客戶關係管理(CRM)系統,以及之後的工作流程。 請參閱表單提交。
Commerce
產品詳細資料和從目錄載入產品資料的清單頁面,以及Adobe Commerce上商店的商務頁面附加元件
店面設定及其Adobe Commerce授權,或針對其他商務平台呼叫其API的區塊。 請參閱Commerce頁面。
Analytics、標籤管理和同意
使用自動模式的​包含整合,支援的設定會關閉,直到您開啟為止
載入哪些標籤以及何時載入,讓頁面保持快速。
重新導向、網站地圖和標準URL
頁面標題、說明和社交影像
URL原則及其設定。 請參閱URL、重新導向及搜尋中繼資料。

如需來源存取、互動式內容及其他匯入界限,請參閱限制。

圖形與設計系統 figma

圖形可以是新設計的來源。 使用Figma匯入附加元件時,代理程式會透過Figma的API,使用模型內容通訊協定(MCP)伺服器讀取選取的元件或框架,就像開發人員讀取設計移交一樣。 它會將設計的變數和樣式(例如顏色、印刷樣式和間距)寫入專案的全域樣式中,作為CSS自訂屬性。 這些屬性是網站的設計權杖。 註解會儲存在程式碼中,而非個別的Token匯出,因此設計師和開發人員會像檢閱任何其他變更一樣檢閱註解。 如需設計師如何從Figma使用代理程式,請參閱從Figma設計工作。

要核准的專案:

  • 存取:​每個搭配代理程式使用Figma的人,都會建立具有唯讀範圍的Figma個人存取權杖,並將其儲存在主控台的設定中。 Figma會提出問題並控管此存取權杖,這與設計權杖無關。 沒有組織範圍的Figma連線,而且個人存取權杖不能僅限於特定檔案:它會讀取其擁有者可以開啟的每個檔案。
  • 座位和速率限制: Figma會根據權杖擁有者的座位和擁有檔案的計畫,限制權杖讀取檔案的頻率。 有了View或Collab席位,代號一個月只能透過Figma的API讀取檔案幾次,因此使用Figma搭配代理程式的人需要開發人員或完整席位。 檢視Figma的速率限制。
  • 資料:​對於選取的框架或元件,代理程式會將其結構、熒幕擷圖、變數和文字傳送至AI模型。 檢視AI模型處理什麼。

選擇移轉的執行方式 approaches

相同的代理程式可以用三種方式執行移轉。 他們因驅動代理程式及回應結果的人而異。 這三者都會產生標準Edge Delivery Services專案,在Git存放庫中有程式碼以及作者所編輯的內容,因此您可以在不同網站間移動:將自動模式結果傳輸至您自己的網站,並在主控台中繼續,或是在與代理程式結果工程師互動後自行繼續代理程式。

方法
選擇時機
您的團隊會做什麼
自動模式
您想在自己的幾個頁面上拿到第一個結果,幾乎不費力,例如要判斷方法或向利害關係人展示。
為自動模式提供網站的URL或頁面清單,並在電子郵件到達時稽核結果。 自動模式會套用預設選項,在執行期間不會要求輸入。 為了將結果帶入生產環境,開發人員會將其傳輸到您擁有的網站,並提供​讓結果成為您的網站。
主控台,由您的開發人員驅動
您的開發人員想要自行設定實作選擇:區塊設計、內容模型和整合。
會逐步提示代理程式,檢查預覽中的每個頁面,並在合併代理程式程式程式碼變更之前對其進行稽核。 請參閱移轉生產網站,如需強制檢閱的內容,請控制變更。
代理結果工程師
您希望Adobe工程師根據事先協定的範圍、結果和時間表,與您的團隊一起操作代理。 此速度並不比其他兩種方法快;它新增的是對Adobe與您分享的結果負責。
同意與您的Adobe客戶團隊互動、在同意的查核點審查交付專案,並在交接時接管網站。

代理程式背後的團隊 adobe-team

當您選擇代理程式時,您也會選擇組建代理程式的團隊及其採用的方向。 人們在網路上尋找資訊的方式正在改變:更多人會詢問AI助理,詢問哪個助理會從品牌自己的網站上看到什麼回答。 代理商可以一起變更網站的內容、設計和程式碼,因此專案在需要變更時可能需要數小時。 團隊的使命是協助您改用Edge Delivery Services、充分利用Experience Manager,以及使用代理開發工具來建立網站,以便在這些轉換持續進行時保持相關性。 它在移轉時並未結束與您之間的工作,且代理程式不斷變更;發行說明會列出每項變更。

當變更很便宜時,困難的部分是決定要變更什麼、維持其控管,並為代理商提供正確的品牌、設計和業務環境。 這些知識存在於您的團隊和系統中。 Adobe的團隊會協助您將它連結至平台:

  • 可與您一起執行移轉的工程師。 對於複雜的移轉,Adobe的代理程式結果工程師可以與您的團隊一起操作代理程式,並將網站交給它。 請參閱選擇移轉的執行方式。
  • 產品變更時為​目前。 主控台的​ 新增功能 ​通知列出每個版本的重點內容。 若要將變更套用至您自己的網站、檢閱您的架構,或討論代理程式尚未滿足的需求,請洽詢您的Adobe客戶成功經理或客戶團隊,與主題專家及產品團隊開會。
  • 您的體驗塑造產品。 產品團隊與客戶和合作夥伴交換專業知識,並與其中一些人合作開發新功能。 您報告的內容會摘要說明團隊接下來要修正和建置的內容。

若要從主控台連絡團隊,請使用​要求支援,或在[自動]模式頁面上​取得說明。 您的訊息會直接傳送給建立代理程式的團隊,該團隊會檢視該訊息並以電子郵件跟進。 請參閱要求支援,以及要求共用的內容:支援要求。

Adobe的團隊與實作合作夥伴的運作方式相同,因此與您的合作夥伴一起,網站在移轉後也能持續改善。

系統和資料流程 systems

代理程式可在託管環境中運作,且僅透過使用者設定的連線及其授予的許可權觸及您的系統。

系統
角色
代理程式到達它的方式
控制存取的專案
Experience現代化主控台
在aemcoder.adobe.io的託管環境,使用者可在其中使用代理程式。
每位使用者都使用您公司Adobe組織所屬的Adobe ID登入,並在不同的環境中工作。
Adobe可讓您透過帳戶團隊進行存取。 登入不會建立您組織的權益。 檢視存取和AI信用使用量。
AI模型
解譯請求、原始頁面和設計,並寫入程式碼和內容。 目前為Claude模型。
主控台會傳送請求需要的內容給它。 檢視AI模型處理什麼。
Adobe。 客戶資料不會用於訓練模型。
Git 存放庫
網站程式碼的記錄系統,位於GitHub或透過Cloud Manager連線的其他Git主機上。
每位使用者都會連線到自己的Git帳戶,該帳戶需要儲存庫的寫入許可權。 在GitHub上,AEM程式碼聯結器應用程式可讓主控台推送。
您的Git提供者的許可權和分支保護。
內容目的地
儲存頁面和影像:Experience Workspace或具有Experience Manager編寫功能的編寫執行個體。 決定移轉前的專案;請參閱內容的儲存位置以及作者編輯內容的方式。
人員會上傳內容,或是在該人員開啟許可權並詢問該許可權時,代理程式會上傳內容。
內容的寫入存取權及網站的發佈角色。
Source網站
要移轉的內容和設計。
代理程式會以訪客的身分在瀏覽器中載入頁面,並在設定的情況下載入受保護頁面的憑證。
網站擁有者,負責授權移轉並控制對網站的存取。
圖形(選填)
目標設計或新頁面的設計。
每位使用者都會在主控台中儲存自己的Figma個人存取權杖。
圖形的檔案許可權和權杖所有者的存取權。 請參閱Figma和設計系統。
Edge Delivery Services
傳遞網站:aem.page上的預覽網站和aem.live上的即時網站。
從存放庫擷取程式碼,並從內容目的地擷取內容。
網站的設定,以及其作者與發佈角色。

安全性與資料處理 security

主控台可讓代理程式在您的網站上運作,而不需提供您設定的認證,以及您決定變更何時抵達您的Git存放庫和內容目的地。

存取與隔離 security-access

  • 您使用Adobe ID登入主控台。 每個請求都透過Adobe Identity Management Services (IMS)驗證。
  • 每位使用者在獨立後端環境中工作,並具有自己的工作區儲存空間,每個使用登入的Adobe組織都有一個工作區。 主控台會在使用者首次登入時建立環境,並在閒置時暫停環境。
  • 主控台沒有專案角色。 擁有存取許可權的任何人都可以要求代理程式變更他們自己的工作區。 Experience Manager和您的Git提供者會繼續針對任何離開工作區的程式碼或內容強制執行其許可權。

憑證 security-credentials

  • AI代理程式不會收到您在主控台中設定的認證。 GitHub、Cloud Manager Git存放庫、Experience Workspace、Figma和受保護的來源網站的Token會儲存在代理程式的環境之外。 獨立的元件僅會將每個認證新增至其所屬服務的請求。 這同樣適用於呼叫AI模型所使用的認證。
  • 認證屬於設定認證的使用者,而非專案。 每個團隊成員都會連線自己的Git帳戶並儲存自己的Figma權杖。
  • 代理程式許可權在您開啟之前為關閉。 開啟其中一個按鈕可讓代理程式使用該存取權執行動作,例如推送至您的存放庫,而不需要看到認證。 依預設,許可權會使用使用者自己的登入。 若要縮小代理程式可觸及的範圍,請改為輸入代號:範圍依其所需存放庫的精細個人存取代號,或Adobe服務帳戶的代號。
  • 代理程式在工作時呼叫的其他服務(例如測試API)會以相同的方式從服務主機名稱的​ 受保護網站驗證 ​中的專案取得認證。 檢視其他服務的認證。
  • 僅將認證儲存在主控台的設定中,不在提示、聊天、來源內容或專案檔案中:代理程式會讀取這些內容,並可將其傳送到AI模型。 將此作為入門的一部分,因為不熟悉編碼代理程式的人可能會將密碼或金鑰貼入聊天中,以完成任務。 要求使用主控台的所有人先讀取秘密保密,並告訴他們您組織的原則允許他們與AI工具共用。

AI模型處理內容 security-model-data

若要執行您的要求,代理程式可以將以下內容傳送至它使用的大型語言模型(LLM),目前為Claude模型:

  • 您的提示和指示。
  • Source頁面URL、標籤和內容,或匯出的CMS內容。
  • 存放庫程式碼和設定,例如區塊、樣式和網站設定。
  • 設計和品牌參考,例如Figma設計和熒幕擷圖。
  • 產生的內容和程式碼正在稽核中。

Adobe不會使用您的對話或其他客戶資料來訓練或微調AI模型。

控制變更 security-control

代理程式可在您的主控台工作區中運作,您可在此檢閱其變更和預覽。 工作會以不同步驟進入您的網站,每個步驟都有自己的控制項:

步驟
誰能做到
控制它的因素
將程式碼推送至您的Git存放庫
您使用​同步 > 推播 > 代碼。 只有當您開啟​允許LLM針對GitHub使用我的Git認證,或針對透過Cloud Manager連線的存放庫使用Adobe認證許可權時,代理程式才會生效。
存放庫的許可權和分支保護。 主控台本身不會檢查分支規則。
上傳內容
您使用​ 上傳內容 ​或​同步 > 推播 > 內容。 對於Experience Workspace,也是代理程式,具有Adobe憑證許可權並需您要求。
在Experience Workspace或作者例項上寫入網站內容的存取權。
預覽和發佈
您可從上傳結果對話方塊、Experience Workspace或AEM Sidekick。 代理程式,具有Adobe憑證許可權並需您要求。
網站在Edge Delivery Services上的作者和發佈角色,其中已設定作者的驗證。
  • 主控台自己的檢查是防護措施,而不是核准閘道。 選擇性計畫模式可讓您在代理程式啟動之前核准計畫。 主控台也會停止代理程式上傳、預覽或發佈,除非您目前的訊息詢問或您同意代理程式詢問,但主控台無法偵測到提出這類要求的所有方式。 兩項檢查都不會阻止擁有存取許可權的人員推送或發佈。
  • 擁有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。
  • GitHub Enterprise的工作階段ID、專案名稱和預覽URL以及Git主機。
  • 傳送者選擇附加的任何最近提示。 預設不會附加任何專案。

這些詳細資料可讓團隊尋找工作階段的交談和記錄。 在設定寄件者的主控台工作區之前,請求只會共用名稱、電子郵件地址和組織。 在[自動]模式頁面上,取得說明​只會與寄件者的郵件共用寄件者名稱和電子郵件地址。 要求使用者不要在說明中包含密碼、權杖或個人資料。 請參閱要求支援。

後續步驟 next-steps

您的團隊同意範圍、方法和控制後,請依照移轉生產網站操作。 在認可該工作之前,對您自己的頁面使用自動模式進行第一次檢查。

recommendation-more-help
experience-manager-cloud-service-help-main-toc