View a markdown version of this page

DevOps 代理程式記憶 - AWS DevOps 代理程式

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DevOps 代理程式記憶

記憶是資訊知識項目, AWS DevOps 代理程式會建置和維護這些項目,以使用代理程式空間特有的合成高訊號內容來補充其功能。與DevOps 代理程式技能編碼程序性知識並擴展代理程式功能的 不同,記憶體編碼資訊性知識,可協助代理程式在調查期間做出更快且更準確的決策。

什麼是記憶體

記憶體是單一 Markdown 檔案,可擷取與客服人員空間相關的合成資訊。範例包括特定警示的重複根本原因、已知的環境查詢,或使用者特定的偏好設定。記憶不會擴展代理程式功能;它們提供代理程式用來做出更好決策的內容。

記憶體存放區是相關記憶體檔案的集合。每個記憶體存放區都有一個名稱和描述,供客服人員用來決定是否瀏覽其內容。記憶體存放區是依主題將記憶體分組的組織容器。

記憶體存放區來自兩個位置。 AWS DevOps 代理程式會在從 代理程式空間中的活動學習時建立和維護受管存放區。您可以自行建立自訂存放區,將對團隊、服務或經常性問題重要的操作知識分組。代理程式會以相同的方式處理:它會讀取每個存放區的名稱和描述,以決定是否開啟它。

記憶與其他知識項目類型有很大的不同:

面向 技能 客服人員指示 記憶體
知識類型 程序性 (說明) 程序性 (一律開啟指示) 資訊性 (合成內容)
內容格式 Markdown 或 ZIP 套件 僅限 Markdown 僅限 Markdown
內容注入 隨需 (客服人員透過描述比對來決定) 一律 (每個工作階段) 隨需 (客服人員透過描述比對來決定)
建立者 使用者 (UI、CLI)、 AWS DevOps 代理程式 使用者 (UI、CLI) 使用者 (UI、CLI、透過聊天)、 AWS DevOps 代理程式 (學習代理程式)

為什麼要使用記憶體

記憶可讓客服人員存取原本會在工作階段之間遺失的歷史模式和環境知識。

主要優點:

  • 更快的調查 - 客服人員會針對特定監視器召回最近的根本原因,避免重複問題再次引發時的備援診斷步驟。

  • 環境意識 - 記憶會擷取環境特有的詳細資訊,例如已知的雜訊警示、基礎設施查詢,或難以重新探索每個工作階段的元件關係。

  • 持續改進 - 當 DevOps 代理程式解決更多事件時,它會自動建立更豐富的模式知識庫,以及專屬於基礎設施的根本原因。

  • 使用者偏好設定 - 記住記錄通訊偏好設定和指令,以便客服人員持續根據您的期望採取行動。

記憶體的運作方式

當客服人員工作階段開始時,客服人員會收到內含其名稱和描述的記憶體存放區清單,而不是其內容。在調查期間,代理程式會將目前的任務與每個存放區的描述配對,以決定存放區是否相關。如果是,代理程式會列出內部的記憶體,而且每個記憶體都有自己的代理程式使用相同方式的描述,只有在該描述看起來相關之後,才會讀取記憶體的完整內容。由於名稱和描述是客服人員在開啟儲存或記憶體之前看到的所有內容,因此描述是客服人員比對的訊號;內容會保持隱藏狀態,直到客服人員決定讀取為止。這種漸進式公開模式可降低內容耗用量,同時讓所有相關知識都能存取。

每個記憶體都會進行版本控制。每次更新都會建立新的不可變版本,因此您可以檢視先前的版本,並保留一段時間內記憶體變更的稽核線索。

將記憶整理到資料夾中

記憶體的名稱是其在存放區中的路徑,因此您可以將相關的記憶體分組到資料夾中,而不是保留單一一般清單。在名稱/中使用 巢狀記憶體,例如 alarms/checkout-latency或 services/checkout/overview。由於記憶體的位置會發出其保留的訊號,因此代理程式會先讀取索引,並只開啟與任務相關的幾個檔案,與上述的漸進式揭露模式相同。

例如,代理程式的環境映射是一組檔案:概觀、每個服務的檔案,以及每個關鍵請求路徑的檔案,以及代理程式首先讀取的索引。運算子應用程式會在此資料夾結構中顯示記憶體,因此您可以瀏覽客服人員導覽儲存體的方式。

受管記憶體存放區

AWS DevOps Agent 會在從 Agent Space 中的活動學習時,自動建立和維護一組受管記憶體存放區。這些包括內建 monitors和 directives存放區,以及 AWS DevOps 代理程式學習的環境每個區域的存放區:您的拓撲、程式碼相依性、管道結構和工具使用模式。 AWS DevOps 代理程式先前將此知識呈現為學習技能;今天它在此處所述的存放區中維持與記憶體相同的知識。如需這些存放區的建置和重新整理方式,請參閱如何建置和重新整理記憶體。

監視器

每個監控週期性根本原因歷史記錄。每個記憶體檔案對應至特定的監視器 (警示或指標),並列出已產生該警示事件的原因類別,以及每個調查證據。客服人員在分類之前讀取符合觸發警示的項目,以快速識別目前事件是否符合已知模式。

當代理程式空間在過去 2 週內有調查時,學習代理程式每天執行一次,以分析最近的調查,然後擷取並儲存此存放區中的記憶。此存放區中的記憶體項目會在 2 週內沒有更新時刪除。如果存放區已滿,則會刪除最舊的記憶體項目以騰出空間。

指令

引導客服人員行為的使用者撰寫指令。使用此存放區記錄客服人員應遵循的常設指示,例如基礎設施慣例或命名偏好設定。

範例:

  • 「不再使用 Lambdas。服務使用 Fargate。」

  • 「儲存服務稱為 Orders Storage Service。」

反射

從先前的調查中取得有關遺漏或忽略內容的教訓。當您提交調查的意見回饋時,會建立記憶體,以分析實際根本原因與調查發現的原因。該警示的未來調查會使用記憶體,以避免造成相同的錯誤。

如需詳細資訊,請參閱提供有關調查的意見回饋。

客服人員空間了解

understanding-agent-space 存放區會保留代理程式空間中資源和關係的映射。它包括含有關鍵網域概念的純語言系統概觀、部署環境 (AWS 帳戶和區域對、Azure 訂閱和區域等)、顯示邏輯服務如何連線的容器層級架構、應用程式的核心請求路徑及其周遊的元件,以及程式碼儲存庫與容器的映射。

存放區會為每個描述其內部元件 (運算、資料、傳訊、網路等) 的邏輯容器保留記憶體,其中包含資源類型和實體識別符,例如 ARNs、資料表名稱和佇列 URLs。每個容器記憶體也會擷取可觀測性涵蓋範圍,即連結至每個元件的警示、儀表板和監控,並將每個元件映射至其相關聯的程式碼儲存庫、套件和infrastructure-as-code定義,提供從原始程式碼到部署資源的完整可追蹤性鏈。

它也會保留每個關鍵請求路徑的記憶體,描述從進入點到每個中繼服務、資料存放區和外部相依性的元件精細程度的完整end-to-end請求流程。每個路徑記憶體都包含元件之間的操作和互動機制序列流程,並編目與路徑相關的可觀測性訊號:每個躍點的日誌群組模式、關鍵指標 (延遲、錯誤率、限流、字符配額) 及其警示名稱和維度,以及可在服務和帳戶之間相互關聯的分散式追蹤範圍。

了解程式碼相依性

understanding-dependencies 存放區會保留完整的service-to-service套件相依性映射。使用它來了解儲存庫的連線方式:哪些服務呼叫哪些 服務、它們之間的事件流向、共用哪些套件,以及基礎設施界限位於何處。此存放區對於評估變更的爆量半徑、識別上游和下游影響,以及了解部署順序至關重要。

了解管道拓撲

understanding-pipeline-topology 存放區從頭到尾映射您的專案管道,包括步驟、環境提升和發佈過程中的部署。這有助於代理程式區分生產與生產前環境,並了解變更在發行程序中的位置。

工具使用最佳實務

存放tool-use-best-practices區會保留有效工具使用模式、常見故障模式,以及代理程式從過去調查中提取的參數指引,因此可避免已知陷阱,並以較少的浪費步驟執行調查。它會保留路由記憶體,列出每個工具及其支援的調查案例,以及每個工具類別的記憶體。工具的指引最多可包含三個區段:

  • 最佳實務 — 從成功工具使用中擷取的調查驅動技術,例如 CloudWatch Logs Insights 查詢範本、環境特定指標命名空間和維度,以及 CloudTrail 事件來源篩選條件。每個項目都根據調查案例進行組織,並包含在過去調查中觀察到的具體參數值和範例。

  • 常見錯誤 — 重複失敗模式及其修正。每個項目描述特定的錯誤條件,例如查詢無法存取的帳戶或建構格式錯誤的彙總查詢,並提供修正動作,讓代理程式可以避免錯誤或從錯誤中復原,而不會浪費調查步驟。

  • 輸出管理 — 容易傳回大型回應的工具呼叫指導。每個項目描述參數變更或處理策略,以減少輸出大小,同時保留診斷值。

當即時基礎設施存取可用時, AWS DevOps 代理程式會先針對您的環境驗證這些模式,再加以包含。確認的模式會以可信度表示,未確認的模式使用謹慎的語言,並排除拒絕的模式。

如何建置和重新整理記憶體

AWS DevOps 代理程式會在運作時自動建置和更新其受管記憶體,您不會手動維護。背景學習代理程式會分析您的代理程式空間和您最近的調查,然後寫入和重新整理受管存放區中的記憶體。

  • Agent Space Understanding 存放區會先在 Agent Space 完成其初始資源探索時產生,並在連線的程式碼儲存庫、部署管道或可觀測性整合變更時重新產生。連線、 AWS Azure 或 Dynatrace 帳戶的變更會反映在下一次排定的重新整理上,而不是立即。對於作用中的客服人員空間,存放區也會定期重新整理,最多每 3 天重新整理一次。如果客服人員空間在過去 6 天內至少完成一次調查,則會處於作用中狀態;如果 6 天內沒有任何調查,排程的重新整理會自動暫停,並在新調查完成後繼續。

  • 工具使用最佳實務存放區會在自上次重新整理後累積至少 10 個新完成的調查後重新整理,且每 3 天不超過一次。

  • 當客服人員空間在過去兩週內進行調查時,監視器存放區每天重新整理一次。

若要手動重新產生此記憶體,請在運算子應用程式的拓撲頁面上選擇重新產生,或選擇聊天中的 ask AWS DevOps 代理程式進行更新。

摘要報告是從 Agent Space Understanding 記憶體建置的。這是一個版本控制的唯讀檢視,顯示代理程式了解您的環境,可在 AWS DevOps AWS DevOps 代理程式管理主控台的代理程式空間詳細資訊頁面的摘要報告索引標籤,以及 Web 應用程式的成品區段中取得。拓撲頁面會將您的環境視覺化為邏輯容器和元件;其從中繪製的拓撲圖表也會提供 Agent Space Understanding 記憶體。如需詳細資訊,請參閱什麼是 DevOps 代理程式拓撲?。

建立您自己的記憶體存放區

您可以建立自己的記憶體存放區,以保留團隊、服務或經常性問題的操作知識,例如,您的團隊為例行任務遵循的標準程序,或您按排程產生之操作報告背後的常設內容。為存放區命名並清楚說明。代理程式使用描述來決定商店的相關性,因此特定、準確的描述是您提供最重要的內容。

您可以從主控台或與 AWS DevOps 代理程式聊天來建立記憶體存放區。

若要建立記憶體存放區 (主控台):

  1. 導覽至 Agent Space Operator Web 應用程式中的知識頁面。

  2. 選擇記憶索引標籤。

  3. 選擇建立記憶體存放區。

  4. 輸入名稱和描述,然後選擇建立。

若要建立記憶體存放區 (聊天):

Ask AWS DevOps 代理程式。例如:

  • 「建立名為 payments-runbook 的記憶體存放區,其中包含調查付款服務的常設指引。」 - 建立存放區。

  • 「在付款執行手冊存放區中,請記住,結帳延遲警示預期會在夜間批次工作期間激增。」 - 將記憶體新增至存放區。

  • 「建立名為操作程序的記憶體存放區,其中包含我們例行維護任務的標準 Runbook。」 - 建立標準操作程序的存放區。

  • 「使用每週操作報告應遵循的區段、來源和格式建立名為weekly-report-context的記憶體存放區。」 - 建立週期性操作報告的存放區。

代理程式使用自訂存放區的方式與其使用受管存放區的方式相同:它會在任務期間讀取存放區的描述,如果存放區相關,則會開啟所需的記憶。自訂存放區會計入與受管存放區相同的限制。請參閱記憶體限制。

撰寫有效的描述

商店的描述是您撰寫的最重要內容,因為它是客服人員在讀取任何內容之前,決定該商店是否相關的方式。當代理程式處理任務時,它會看到每個存放區的名稱和描述,而不是其記憶體,並只在描述發出其內容套用的訊號時開啟存放區。相同的 會保留一個層級:每個記憶體都有自己的描述,而且代理程式只會在該描述看起來相關之後讀取記憶體的完整內容。精確的描述會在正確的時間開啟存放區;模糊的標籤,例如 notes或 misc 為客服人員提供不匹配的項目,因此即使答案在內部,也會略過存放區。

撰寫說明,說明兩個項目:存放區保留的內容,以及客服人員應該何時使用它。可靠的模式是以套用的情況為結尾,例如「調查結帳或帳單延遲時閱讀」。保持具體具體和具體,並用素表達有關商店主題的純陳述式來表達,而不是向某人說明。例如:

  • 太模糊:「付款備註」。

  • 有效:「保留付款服務的 Runbook、已知問題和呈報聯絡人。調查結帳、帳單或退款事件時閱讀。」

描述最多可達 1,024 個字元。您可以稍後加以精簡,當代理程式沒有在您預期使用的存放區上繪製時,這是一般的修正。

要放入記憶體存放區的內容

記憶體存放區擁有持久、合成的知識 - 有關您的環境、經常性根本原因、常設慣例和指令,以及您從過去工作中提取的調查結果和摘要。儲存值得稍後取回的結論,而不是原始資料。

記憶體存放區不是單一調查的速記板,也不是工具輸出的鍵值快取。您無法在存放區中存放工具呼叫的原始結果,並在稍後的相同調查中取回它 - 在調查期間,代理程式已將工具輸出保留在其工作內容中。相反地,請記錄事實或找到已建立的結果 (例如「結帳服務同步呼叫付款 API」),客服人員可以在未來的工作階段中重複使用。

若要獲得最佳結果:

  • 讓每個記憶體專注於單一事實或教訓,而不是大型傾印,以便代理程式可以完全擷取所需的內容。

  • 儲存調查中保持真實的內容,並讓一次性工作資料留在產生它的調查中。

檢視記憶體

您可以從 Agent Space Operator Web 應用程式的知識頁面檢視所有記憶體存放區及其內容。

若要檢視記憶體存放區:

  1. 導覽至 Agent Space Operator Web 應用程式中的知識頁面。

  2. 選擇記憶索引標籤。

  3. 瀏覽記憶體存放區的清單,每個都顯示其名稱、描述和客服人員類型範圍。

若要檢視存放區中的記憶體:

  1. 在記憶體索引標籤上,選擇您要探索的記憶體存放區旁的檢視。

  2. 存放區詳細資訊頁面會列出所有記憶體的名稱、描述、版本編號和上次修改日期,並依名稱字母順序排序。

若要檢視特定記憶體:

  1. 在存放區詳細資訊頁面中,選擇您要讀取之記憶體旁的檢視。

  2. 記憶體詳細資訊頁面會顯示轉譯的 Markdown 內容,以及建立日期、上次修改日期和版本選擇器。

若要檢視先前的版本:

  1. 在記憶體詳細資訊頁面上,使用版本選取器下拉式清單選擇較舊的版本。

  2. 內容會更新以顯示選取的版本。

啟用和停用記憶體

您可以切換個別記憶體存放區或個別記憶體處於作用中或非作用中狀態,而不將其刪除。

若要切換記憶體存放區:

  1. 在記憶體索引標籤上,使用記憶體存放區旁的切換開關。

  2. 非作用中時,客服人員不會存取該存放區中的任何記憶體。

若要切換個別記憶體:

  1. 導覽至記憶體存放區以查看其記憶體清單。

  2. 使用您要啟用或停用之記憶體旁的切換開關。

  3. 非作用中時,客服人員會在調查期間略過該特定記憶體。

使用聊天功能編輯記憶體

您可以透過與聊天介面中的 DevOps 代理程式聊天來建立、更新或刪除記憶體。聊天代理程式可以直接寫入記憶體存放區。

Chat 命令的範例:

  • 「記住儲存服務稱為 Orders Storage Service」 - 在指令存放區中建立或更新記憶體。

  • 「更新 Canary 警示的記憶體,以注意到其在部署期間發生漏洞」 - 更新監視器存放區中的特定記憶體。

  • 「刪除有關舊資料庫連線字串的記憶體」 - 移除不再相關的記憶體。

  • 「建立名為 network-quirks 的記憶體存放區,並新增 eu-west-1 NAT 閘道在 350 秒後捨棄閒置連線的備註」 - 建立存放區及其第一個記憶體。

Chat 代理程式會代表您直接寫入記憶體存放區。

刪除記憶體存放區

您可以刪除不再需要的自訂記憶體存放區。無法刪除受管存放區 (例如 directives、 monitors和學到的技能存放區)。

  • 在聊天中,客服人員不會刪除仍包含記憶體的存放區,它會要求您先刪除記憶體。刪除記憶體,然後刪除存放區。

  • 在 主控台中,刪除存放區也會刪除其包含的記憶體。這無法復原,因此請確定它是您要移除的存放區。

若要刪除聊天中的商店,請詢問客服人員。例如:

Delete the network-quirks memory store.

記憶體限制

下列限制適用於記憶體:

資源 限制
每個代理程式空間的記憶體存放區 50
每個記憶體存放區的記憶體 200
個別記憶體內容大小 100 KB