適用於 AKS 的 Agentic CLI 常見問題集

AKS 的代理式 CLI 是一款由 AI 驅動的命令列工具，旨在幫助 AKS 使用者有效排查叢集問題。 它分析遙測訊號 （日誌、指標、事件），在基礎結構和工作負載之間相互關聯，並提供可操作的見解。 代理程式會採用自然語言查詢作為輸入，並傳回診斷摘要、根本原因分析和補救建議。 代理型 CLI 不包含 AI 模型，因此你需要提供自己的大型語言模型（LLM）API 金鑰讓代理運作。

AKS 的代理式 CLI 作為本地助理，解讀自然語言查詢、執行診斷指令並回傳可操作的洞察。 它能無縫整合 AKS 原生工具及遙測來源，如 Kubernetes 事件、日誌、Inspektor Gadget、Azure 及 AKS API。 其中每一項都已在 az aks agent 中原生啟用為工具集。

代理程式會遵守 Azure 角色基礎存取控制（RBAC）和身份控制，因為它繼承了 Azure CLI 的使用者權限。 預設為唯讀模式。 你可以設定你的 AI 供應商（例如 OpenAI、Azure OpenAI 和 Anthropic）以及模型。 你可以設定代理，使其能輸出工具組的結果。

的 az aks agent 輸出包括：

• AI 合成的用户提問摘要回覆。
• 根本原因分析及支持證據。
• 針對 AKS 最佳實務量身打造的修復建議。
• 診斷追蹤與工具輸出。

AKS 的代理程式 CLI 具有下列預期用途：

• 與您的 AKS 叢集進行人機協同互動，幫助您有效偵測、診斷並解決問題。
• 與 Kubernetes 和 AKS API 的唯讀互動。 你可以取得資源資訊，了解 AKS 叢集資源的健康狀況，並遵循 Kubernetes 和 AKS 的最佳實務。

適用於 AKS 的代理式 CLI 並非設計用於超出 AKS 互動範圍之外的通用編碼或 AI 代理程式。 它無法上網回答一般性問題。

AKS 的代理式 CLI 針對 AKS 特定情境進行優化。 它能整合 kubectl、Azure CLI、Inspektor Gadget 和 Azure Monitor 等工具，但可能會出錯。 代理程式有時可能會錯過細微的訊號、誤解嘈雜的遙測，或提出需要人工驗證的緩解措施。 例如，當根本原因是上游 DNS 伺服器配置錯誤時，它可能會錯誤將網域名稱系統（DNS）故障歸因於網路政策。 這種情況尤其可能發生，特別是在遙測不完整或權限受限時。

為了避免自動化偏差，你應該將代理人的輸出視為有用的起點，而非最終結論。 它擅長揭示可能原因並引導調查，但人工監督是必不可少的。 在複雜或高風險環境中，人工審查是必要的。

至於 AI 模型，我們建議你使用 Azure OpenAI 部署的模型，例如 GPT4o 或 GPTo3。 你也可以直接從 OpenAI API 平台使用一個。 你可以使用任何由 Open API 規範支援的 LLM 模型提供者，例如 Anthropic 和 Gemini。

AKS 的代理性 CLI 正透過內部測試與程式化評估來評估，旨在確保其診斷能力準確、相關且有意義。

在程式化評估中，我們測量了標準負責任的 AI 指標，如接地性、UPIA 與 XPIA 越獄、有害內容，以及對話品質（如連貫性與流暢度）。

這些測試幫助我們識別推理、工具整合和提示執行方面的差距。 成功的關鍵指標之一是醫師診斷的準確性及其建議的相關性。 客服人員是否正確辨識了根本原因，並提出可行且具情境感的緩解措施？

我們會進行內部 Bug Bash 與紅隊演練，以針對各種情況嚴格測試代理程式的行為。 我們會檢查節點健康狀況下降、DNS 故障、升級中斷以及 Pod 排程問題。

我們認識到代理與人工智慧互動的動態特性，並歡迎您作為預覽的一部分提供回饋。 你可以直接在 aksagentcli@service.microsoft.com 與我們分享意見反饋。 你也可以 在 GitHub 上開啟一個議題。

AKS 的代理式 CLI 功能強大，專為診斷與解決 AKS 叢集中的問題而設計。 它有幾個重要的限制，你應該注意，以確保有效且負責任地使用：

• 客服人員存取和分析資料的能力，直接取決於你的權限以及遙測資料的可用性。 若您缺乏足夠的存取權限，或日誌、指標或事件等遙測來源缺失或不完整，代理人員可能無法產生準確或完整的診斷結果。
• 在處理大型資料集（如時間序列指標）時，系統會受到代幣限制。 這些限制可能限制複雜故障排除情境中分析的深度與廣度。
• 在目前的 MVP 狀態下，代理型 CLI 對託管 Azure 體驗的支援有限。 某些工作流程，例如 Azure Monitor 警示的整合，可能無法獲得完全支援。

為了減少這些限制的影響，你可以採取幾項積極的措施：

• 請確定必要的診斷工具 （例如 Azure 監視器） 已正確設定，以協助代理程式存取更豐富的遙測，並執行更全面的診斷。
• 透過 Azure Model Context Protocol（MCP）或 AKS MCP 伺服器，擴充代理 CLI 的功能。 如需詳細資訊，請參閱 將 AKS MCP 伺服器與 AKS 的代理程式 CLI 整合。
• 使用最新世代的推理或通用模型，如 GPT4o 和 GPTo3，以確保最佳結果。 AKS 的代理式 CLI 並不包含 AI 模型。

若要有效且負責任地使用適用於 AKS 的代理程式 CLI，數個作業設定會扮演重要角色。 代理程式預設設計為以唯讀模式運作，可確保安全診斷，而無需對叢集進行變更。 當需要寫入操作時，例如部署除錯 Pod 或執行修復步驟，則需明確取得使用者批准，以維持使用者控制並減少意外影響。

代理程式在你的電腦上本地執行，並支援自備的 AI 服務提供商。 因此，你可以自行設定 LLM API 金鑰。 這樣的配置確保你能攜帶組織核准的 AI 供應商和端點。 所有資料處理皆在本地進行，以維護資料隱私並符合企業安全標準。

代理程式還提供可設定的冗長度設定，你可以根據需求在簡潔摘要與詳細診斷輸出間切換。 這種彈性有利於收集快速深入解析，並能針對代理程式的推理與工具執行過程提供完全的透明化。

與 Azure 身份和 RBAC 整合，進一步確保代理只存取你被授權查看的資源。 此限制簡化了設定並強制執行安全的存取邊界。 這些設定共同建立安全、注重隱私權且使用者控制的環境，以透過 AI 協助針對 AKS 叢集進行疑難排解。

您可以透過數個管道提供意見反應或取得適用於 AKS 的代理程式 CLI 的協助：

• 代理式 CLI 存放庫上的 GitHub 問題與接收要求。
• 預覽階段的內部頻道。
• 透過 Azure 支援服務工單或直接與 AKS 產品團隊互動。

在 AKS 代理 CLI 的脈絡中，外掛是模組化擴充，透過整合外部工具、資料來源及領域特定邏輯，強化代理的診斷能力，進行故障排除工作流程。 這些插件允許代理超越靜態命令執行，並結合動態、場景感知推理。 代理程式支援以下類型的外掛：

• 工具集整合：您可以使用連線到 Prometheus、Datadog 和 Azure Monitor 等可觀測性平台的工具集來擴充代理程式的功能。 這些工具集會公開客服專員可以即時查詢和分析的指標、日誌和警示。 例如，Prometheus 工具組可能允許代理取得故障艙的 CPU 與記憶體使用趨勢。 Azure Monitor 整合可能會顯示與節點健康問題相關的近期警示或活動記錄。
• MCP 伺服器：模型情境協定伺服器作為中介，向 AI 代理揭露診斷工具與提示範本。 在 AKS 的 CLI 代理中，MCP 伺服器提供對 Kubernetes 和 Azure 資源的結構化存取。 代理程式隨後可以執行 kubectl describe 與 az aks show 等命令，甚至可以部署偵錯 Pod。 這些伺服器也有助於標準化工具的調用方式及資料回傳方式，使代理能力在不同環境中的擴展更容易。

所有插件都是拉取式的。 這些工具允許 AKS 的代理式 CLI 從多個來源擷取資料，或利用嵌入於 LLM 提示中的自訂執行簿來提升診斷能力。 唯一的輸出資料流程是流向您連線到「用於 AKS 的代理式 CLI」的 AI 模型。

當你使用 AKS 的代理 CLI 搭配外掛時，可能會出現多種問題，影響故障排除的可靠性或準確性。

一個常見的挑戰是因為提示詞設定錯誤，導致工具被錯誤調用。 外掛通常依賴提示範本來引導 AI 的推理與工具選擇。 即使是提示邏輯或結構上的小錯誤，也可能導致觸發錯誤的工具，或在錯誤的情境中使用正確的工具。 結果可能是誤導性的診斷或不完整的調查。

另一個風險是產生捏造或不正確的輸出，特別是當插件傳回不完整、過時或模棱兩可的資料時。 在這種情況下，人工智慧可能會嘗試用聽起來似是而非但不正確的解釋來「填補空白」。 當遙測資料遺失或外掛在不支援的叢集配置中使用時，也可能發生錯誤。 例如，私有叢集可能無法存取某些 API 或工具。

為了降低這些風險，AKS 的代理程式 CLI 包含數個保護措施。 詳細記錄與錯誤回報能幫助你精確追蹤被調用了哪些工具、回傳了哪些資料，以及 AI 如何解讀這些資料。 這些報告讓發現和修正問題變得更容易。 如果您懷疑特定插件導致問題或返回不可靠的數據，您還可以手動覆蓋或禁用它們。

最後，清晰的文件和社群支援對於插件的開發和維護至關重要。 包含範例、版本相容性說明和已知限制的詳細記錄的外掛程式可協助您了解如何負責任地使用它們並在需要時提供改進。 使用來自領先人工智慧供應商的最新一代 LLM/推理模型還可以降低資訊錯誤的風險。

相關內容

• 關於 AKS 代理 CLI 的概述，請參見 關於 AKS 代理 CLI。
• 為了幫助你解決使用 AKS 代理式 CLI 時的常見問題，請參閱 Agentic CLI for AKS 故障排除指南。