Experience現代化主控台 console-reference
位於aemcoder.adobe.io的Experience Modernization Console是Experience Modernization Agent的Web介面：Edge Delivery Services的託管開發環境，您可在此說明聊天中的變更，以及檢查、儲存和發佈結果。 它不需要本機設定。 主控台可在您的專案之託管復本上運作，這些檔案會呼叫主控台工作區。 它與Experience Workspace （檔案型內容的視覺化撰寫UI）無關；請參閱內容的儲存位置以及作者如何編輯內容。 Experience Workspace會取代「檔案製作」，而部分主控台標籤仍使用該名稱。
此頁面說明主控台的檢視、控制項和設定。 如需存取權，請參閱存取權與AI信用使用量。 如需完成程式，請選擇開始、生產移轉、重新設定樣式或區塊開發的方式。 如果您是第一次使用主控台，請在聊天中詢問代理程式以進行導覽。
選單列 menu-bar
每頁頂端的功能表列提供：
主控台也會在頁面頂端顯示通知，例如服務狀態以及最新版本的新增功能。 聊天、首頁和設定可適應手機和平板電腦熒幕。 在電話上，聊天頁面僅顯示聊天。 在平板電腦上，它一次顯示一個面板；在聊天和工作區標題之間切換。 在較寬的熒幕上，兩個面板會並排顯示。
首頁 home-page
首頁頁面是您開始工作的位置。
提示輸入 prompt-input
提示輸入提供與AI互動的控制項。
-
計畫/執行模式 （燈泡和魔術棒圖示）：分別在計畫模式和執行模式之間切換。
- 計畫模式：代理程式會分析您的要求，並提出方法而不變更檔案。 最後是包含步驟檢查清單的計畫。 請將其用於多頁、共用程式碼或其他有風險的變更，這樣您就可以在任何變更之前檢閱和調整方法。 選取 執行計畫 以切換到「執行」模式並執行計畫，或啟動新的計畫。 「計畫」模式可隨時使用，包括在您計畫或編目網站之前。 只有您切換模式；代理程式無法自行切換模式。
- 執行模式：代理程式會執行要求，而且可以進行實際的檔案變更。
- 計畫模式會變更代理程式在對話中的運作方式，而非您的存放庫或網站所接受的專案。 在執行之前，請說明允許的範圍以及是否授權上傳、推送或發佈。 檢視變更控制權。
-
附加檔案 （回形針圖示）：上傳檔案並附加至提示以取得其他內容，例如參考設計、熒幕擷取畫面或規格。 代理程式會看到JPEG、PNG、GIF或WebP格式的附加影像。 您也可以附加文字檔案、Word、PowerPoint和Excel檔案；代理程式會接收它們的文字和內嵌影像。 每個檔案最大可達10 MB；不接受PDF檔案。 請先檢查附件中的密碼、權杖和個人資料。 檢視不公開秘密。
-
提示佇列 （時鐘圖示）：其他提示可以排入佇列，以便在目前提示完成後自動執行，因此您可以排入後續工作，而不需要等候。
-
先前的提示：在空白的提示輸入中，使用向上鍵和向下鍵重新叫用先前的提示。 不會覆寫您已開始的草稿。
-
提示提示：啟用時，主控台會在提示遺失詳細資訊（例如頁面或您預期的結果）時指出，並可建議更清楚的提示。 您可以決定是否使用提示。 除非您重述，否則不會標籤主控台建議的提示。 在設定中的 提示指導 下設定提示。
聊天頁面 chat-page
聊天頁面是與代理程式互動的主要介面。 此頁面分為可調整大小的聊天面板和工作區面板。
聊天面板 chat-panel
聊天面板可讓您檢視並繼續與代理的交談。 聊天面板包含聊天訊息歷程記錄以及用來對主控台提出其他要求的提示輸入。
-
聊天動作
- 清除交談：這會移除所有訊息並開始新的交談。 此動作無法還原，且不是程式碼或內容回覆。 在您選取 重設工作區 之前，代理程式工作階段的記錄會保留在主控台工作區中。 在清除之前，請要求代理程式將每個交談中讀取的重要決定記錄在專案指示檔案中，並下載您想要保留的聊天。
- 下載交談：此作業會將交談記錄下載為Markdown檔案，您可以將此檔案作為詢問內容的記錄。 檢視追蹤代理程式所做的動作。
交談會與您的主控台工作區一起儲存。 當您重新載入頁面或稍後返回時，聊天記錄會重新載入。 只要瀏覽器索引標籤，系統就會提示您使用方向鍵恢復原狀。
可選功能 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移除的標示：內嵌樣式、
span元素、資料屬性，以及該結構外部的其他標示會顯示在主控台預覽中，但在aem.page上消失。 將頁面保留為語意內容，並將樣式放入專案的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 大小呈現的頁面
- Inspect模式 （選取圖示）以將頁面的元素加入至您的提示，讓代理程式限制其對該元素的變更。 檢視進行您的第一次變更。
- 新視窗 （在圖示中開啟）以在新的索引標籤中開啟預覽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基本驗證或持有者驗證時，讀取這類來源網站。 接著，您可以使用與公用頁面相同的方式移轉這些頁面。
來源網站必須可以從網際網路上的代理程式託管環境連線，並設定為接受您提供的驗證方法。 此功能不會透過VPN連線，也不會完成互動式登入流程，例如單一登入(SSO)表單或多重驗證。 防火牆允許代理程式在其管理員允許列出代理程式位址時通過。 如果您的來源只能在私人網路上連線，請向其管理員要求可連線到網際網路的分段或來源主機，該主機接受其中一個支援的方法。
若要設定存取權：
-
在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中使用Token，或要求每次呼叫時都需簽署其他方法。
- 主控台已驗證的主機（例如GitHub和Figma）會繼續使用主控台自己的憑證。
- 使用僅具有任務所需存取許可權的代號，並在您不再需要該條目時將其移除。
這些認證可在主控台中提供代理程式的工作。 您的發佈網站無法使用：即時網站所需的金鑰屬於伺服器端服務。 請參閱連線服務與應用程式。 如需將代理程式連線到聊天工具的範例，請參閱範例： Slack中的更新。
要求支援 request-support
當某些專案無法如您預期般運作，或您有這些頁面無法回答的問題時，請告訴建立代理程式的團隊。 您的請求會直接送交該團隊，由團隊檢視並透過電子郵件跟進。 若要與主題專家或產品團隊會面，請參閱代理程式背後的團隊。
- 在功能表列或[設定]頁面中選取要求支援。 在小熒幕上，按鈕只會顯示其圖示。
- 選擇性地選擇主題： 配置/設計、遺漏內容、代理程式卡住或其他專案。
- 在 發生什麼錯誤？ 中，最多使用2,000個字元描述問題。 為受影響的頁面命名、您預期的內容、發生的事情以及發生時間。 請勿包含密碼或權杖。
- 選擇性地選取最近要附加的提示，讓團隊可以看到您詢問的內容。 除非您選取，否則不會附加任何專案。
- 選取傳送。
此要求會分享您的聯絡詳細資訊以及團隊尋找您工作階段交談與記錄所需的工作階段詳細資訊；如需完整清單，請參閱支援要求。 您可以每分鐘傳送一個要求。
當交談暗示您受困或受挫時，提示教練可能會在需要協助嗎？ 選取 連絡支援 以開啟相同的要求，或是 不謝 繼續進行。
在自動模式頁面上，按鈕是取得說明。 使用它來要求更多頁面或更多同時移轉，或詢問有關「自動」模式的任何內容。 說明您在中需要什麼我們如何協助？ 並選取傳送。 團隊會透過電子郵件回覆。
新功能與發行說明 whats-new
發行新版主控台時，頁面頂端會顯示 最新資訊 通知，列出其重要內容。 展開它以檢視清單，或將其關閉。 它會在下一個版本中重新出現。
如需每個版本的詳細資訊，請參閱Experience Modernization Agent發行說明。