kagent

kagent 是一個強大的 CNCF 沙盒項目，專為 DevOps 和平台工程師設計，旨在將代理式 AI 直接集成到 Kubernetes 集群中。此技能為操作 kagent 生命週期的用戶提供全面支持，包括 CLI 管理、基於 YAML 的 Agent 宣告以及基於自定義 ADK 的 Agent 開發。無論您是在協調 OpenAI、Anthropic 或 Ollama 等 LLM 提供商，還是通過模型上下文協議 (MCP) 連接複雜的工具集，本指南都能幫助您構建可擴展、可觀察且高可用的 AI Agent 架構。

• 全面支持 kagent CLI，包括安裝、kagent get、kagent invoke 和 kagent dashboard 等觀測指令。

• 提供關於將 Agent 定義為 Kubernetes 自定義資源 (CRD)、配置 ModelConfig 以及管理 RemoteMCPServer 或 MCPServer 實例的詳細指導。

• 關於使用控制器的 /mcp HTTP 端點將 Agent 集成到 IDE（如 Cursor、Claude Code、Windsurf）的配置說明，以實現無縫的 Agent-to-IDE 通信。

• 用於集群內 Agent 發現、任務編排和代理間通信的 A2A (Agent-to-Agent) 協議實現。

• 關於系統提示詞設計、工具權限管理以及利用 OpenTelemetry 進行追踪和調試 Agent 執行流的最佳實踐。

• 此技能僅專注於用戶體驗（CLI 命令、Helm Chart 和 Kubernetes 清單），不涵蓋項目內部編譯或開發構建（如 make、go build）。

• 由於 kagent 發展迅速，請始終根據當前安裝的版本驗證具體的 CRD 字段名稱和 flag 語法；部署前請使用 kubectl explain 或 kagent <command> --help 確認細節。

• 優先使用標準 Kubernetes 原語（kubectl、YAML 清單）來管理 Agent，以確保持久性和 GitOps 兼容性。

• 部署自定義模型時，請始終將所需的環境變量（API 密鑰和提供商）安全地設置在集群或環境中。

• 調試時，請利用 kagent bug-report 和控制器日誌（kubectl logs -n kagent）來診斷 Pod 故障或 MCP 握手問題。