kagent: K8s 原生 AI Agent 框架

What is kagent

kagent 是一个 CNCF 项目，提供了一个 Kubernetes 原生框架用于构建、部署和管理 AI agent。它把 K8s 变成 agentic AI 工作负载的编排层——用声明式 CRD 描述 agent，controller 自动部署 runtime，用户通过 CLI/Web UI/API 与 agent 交互。

• Go（controller/CLI/ADK）、Python（agent runtime）、TypeScript（UI）
• Apache 2.0，最新 v0.10.0-beta6
• CNCF sandbox 阶段

支持的 LLM Provider：OpenAI、Anthropic、AWS Bedrock、Gemini、Ollama、Azure OpenAI、SAP AI Core

支持的 Agent 框架：Google ADK、LangGraph、CrewAI、OpenAI Agents SDK

核心概念

架构

flowchart TB
    subgraph User["User"]
        CLI["kagent CLI (TUI)"]
        WEB["Web UI (Next.js)"]
        KUBECTL["kubectl / Helm"]
    end

    subgraph Control["Control Plane (Go)"]
        CTRL["Controller Manager"]
        HTTP["HTTP Server (:8083)"]
        A2A["A2A Handler Mux"]
        AGT["Agent Controller"]
        TR["ADK API Translator"]
    end

    subgraph Runtime["Agent Runtimes"]
        PY["Python ADK\n(Google ADK-based)"]
        GO["Go ADK"]
        BYO["BYO Container\n(:8080, A2A)"]
    end

    subgraph Tools["Tool Ecosystem"]
        MCP["MCP Servers\n(istio, k8s, helm,\nprometheus, grafana...)"]
        REMOTE["Remote MCP\n(HTTP/SSE)"]
    end

    KUBECTL --> K8S_API[("K8s API")]
    CLI --> HTTP
    WEB --> HTTP
    K8S_API --> CTRL
    AGT --> TR
    TR --> PY
    TR --> GO
    A2A --> Runtime
    PY --> MCP
    PY --> REMOTE
    GO --> MCP

三层设计：

核心组件

Agent Controller（最重要）

Agent Controller 是整个系统的核心——它把 Agent CRD 翻译为 K8s 原生资源：

Agent CRD ──→ Agent Controller ──→ Deployment + Service + Secret + ConfigMap
                (ADK API Translator)

翻译过程：

1. 读取 Agent CRD —— 获取 system prompt、工具列表、ModelConfig 引用
2. ADK Translator 构建 manifest（Python/Go 两种 runtime）
3. 注入 ModelConfig 的环境变量和 API key（从 Secret 读取）
4. 为每个 MCP 工具注入地址和认证信息
5. 创建 Deployment（带 readiness probe）+ Service
6. 注册到 A2A Handler Mux，使该 agent 可通过 A2A 协议被其他 agent 发现和调用

A2A Handler Mux

基于 K8s Informer 的 agent 注册和 A2A 请求路由：

• 通过 Informer 实时监听 Agent CRD 的创建/更新/删除
• 每个 agent 注册时协商协议版本（A2A v0.3.0 / v1.0）
• 收到 A2A 请求时，根据 agent 名称路由到对应的 agent Pod
• 支持 agent-to-agent 通信——一个 agent 可以作为另一个 agent 的“工具“

ADK API Translator

CRD → 运行时 manifest 的翻译层：

// 简化的翻译流程
func BuildManifest(agent Agent) Manifest {
    m := Manifest{}
    m.Deployment = buildDeployment(agent.Spec.Runtime, agent.Spec.ModelConfig)
    m.ConfigMap = buildConfigMap(agent.Spec.SystemPrompt, agent.Spec.Tools)
    m.Secret = buildSecret(agent.Spec.ModelConfig.APIKeyRef)
    m.Service = buildService(agent.Name, 8080)
    // 为 agent card 生成 A2A 能力声明
    m.AgentCard = buildAgentCard(agent.Spec.Skills, agent.Spec.Tools)
    return m
}

Python ADK Runtime

基于 Google ADK 的 agent 运行环境：

• 接收 controller 生成的 manifest
• 通过 ADK 框架调用 LLM（LiteLLM 作为统一接口）
• 内嵌 MCP client 连接工具服务器
• 通过 A2A executor 暴露 agent-to-agent 接口

MCP 工具生态

kagent 预置了丰富的 MCP server 用于 K8s 运维场景：

用户体验

声明式创建 Agent

apiVersion: kagent.dev/v1alpha2
kind: Agent
metadata:
  name: k8s-troubleshooter
spec:
  modelConfig:
    provider: anthropic
    model: claude-sonnet-4-6
  systemPrompt: |
    You are a Kubernetes troubleshooting expert. You have access to
    kubectl, helm, and prometheus tools to diagnose cluster issues.
  tools:
    - k8s-mcp-server
    - helm-mcp-server
    - prometheus-mcp-server

CLI（TUI 交互式聊天）

# 列出所有 agent
kagent agent list

# 与 agent 对话（TUI 界面）
kagent agent chat k8s-troubleshooter

# 管理 MCP server
kagent mcp list
kagent mcp install prometheus

Web UI

Next.js 构建的 Web 界面，提供 agent 的创建、管理、对话的可视化操作。

与其他项目的关系

参考

• kagent GitHub
• kagent Documentation