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 握手问题。