評估及核准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
如需移轉潛在客戶如何協調參與者,請參閱潛在客戶移轉。 有數個人可以在一個專案上工作,每個專案都在自己的主控台工作區中;請參閱以團隊身分工作。
專案剩餘工作 project-work
代理是開發代理:可以使用它在Edge Delivery Services上建置什麼。 移轉會複製來源頁面顯示的內容,而非頁面背後的系統。 代理程式會重新建立網站:其頁面、區塊、樣式以及呼叫服務的程式碼。 核准和發佈工作流程、整合背後的後端系統,以及您的團隊在新網站上的工作方式,仍然是您組織的工作。 這些需求需要先由您的團隊決定,代理程式才能建置這些需求:
如需來源存取、互動式內容及其他匯入界限,請參閱限制。
圖形與設計系統 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存放庫中有程式碼以及作者所編輯的內容,因此您可以在不同網站間移動:將自動模式結果傳輸至您自己的網站,並在主控台中繼續,或是在與代理程式結果工程師互動後自行繼續代理程式。
代理程式背後的團隊 adobe-team
當您選擇代理程式時,您也會選擇組建代理程式的團隊及其採用的方向。 人們在網路上尋找資訊的方式正在改變:更多人會詢問AI助理,詢問哪個助理會從品牌自己的網站上看到什麼回答。 代理商可以一起變更網站的內容、設計和程式碼,因此專案在需要變更時可能需要數小時。 團隊的使命是協助您改用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)驗證。
- 每位使用者在獨立後端環境中工作,並具有自己的工作區儲存空間,每個使用登入的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許可權,代理程式可以推送至您的認證可以寫入的任何分支,包括
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
您的團隊同意範圍、方法和控制後,請依照移轉生產網站操作。 在認可該工作之前,對您自己的頁面使用自動模式進行第一次檢查。