kagent-dev/kagent

项目介绍

kagent 是一个 Kubernetes 原生框架，把 AI Agent 建模为 Kubernetes 自定义资源。Agent 的提示词、工具、模型配置和运行时都写在 YAML 里，用 kubectl 和 GitOps 流程管理，目标是让平台团队和 DevOps 团队把 Agent 和现有工作负载放在同一套体系里运行，而不是单独维护一个孤岛。

框架把几件事拆开：Agent 承载行为与运行时配置，AgentTemplate 在多个 Agent 之间共享提示词和工具集，Harness 决定运行时（Go 或 Python ADK、Codex、Claude 或自定义），ModelConfig 负责选择 LLM 供应商。Agent 可以连接 MCP 工具，内置的 MCP server 覆盖 Kubernetes、Istio、Helm、Argo、Prometheus、Grafana、Cilium 等。Session 保存对话历史，并支持挂起、恢复以及从 checkpoint 分叉新对话；OpenTelemetry 追踪覆盖 Agent、模型和工具的执行。

快速使用

官方给出的入口是两步流程：先按安装指南在集群上部署 kagent，再跟着创建第一个 Agent完成端到端体验。README 没有直接内嵌安装命令，因此集群版本、前置依赖和具体 CLI 步骤应以安装页为准。项目同时提供 Web UI 和 CLI 用来创建 Agent 并与之对话，控制器还暴露 gRPC、A2A 和 MCP API 供程序化调用。

架构与运行方式

控制器监听 kagent 自定义资源，准备 Agent 运行并管理 Session；前端是 Web UI 和 CLI。实际运行由 Substrate 负责，它管理 Agent 生命周期，包括挂起、恢复和快照。PostgreSQL 独立于正在运行的 Agent 持久化 Session、任务和对话历史。Agent 运行时由 Harness 抽象选择，这也是框架能够接入 ADK 之外运行时的原因。

使用约束

由于 Agent 就是 Kubernetes 资源，一个可用的 Kubernetes 集群是基础前提，Session 持久化则依赖 PostgreSQL。访问模型需要在 ModelConfig 中配置供应商；支持 OpenAI、Azure OpenAI、Anthropic、Google Vertex AI 和 Ollama，具体可用性取决于所选 Harness。项目声明仍在活跃开发中，API 和资源定义可能变化，路线图在项目看板中维护。许可证为 Apache-2.0。

HotRepo 点评

kagent 在 2026-11-07 的 Go 日榜上排到第 10 位，当天新增 8 颗 Star，当时总计 4,177 颗。这只是单次快照，不能据此判断趋势，但说明它在 Go 生态里获得了关注，而项目的核心价值其实在 Kubernetes 运维侧，并不局限于 Go 工具链。从技术上看，最值得注意的设计是声明式 Agent 资源与可插拔运行时的分离：团队可以把 Agent 定义保存在版本控制里，同时按需更换执行 Harness。