kagent - olga-mir/playground GitHub Wiki

kagent

Kagent is an open-source programming framework that brings the power of agentic AI to cloud-native environments. Kagent enables AI agents to run directly in Kubernetes clusters

https://kagent.dev/docs/introduction/what-is-kagent

Installation

Helm ApplicationSet config for kagent-crds and kagent: https://github.com/olga-mir/playground/blob/main/platform/config/helm-applications/kagent-crds.yaml

kagent comes with a set of pre-built agents, armed with a number of Builtin tools. The demo includes agents and tools built on top of this framework and these manifests can be found at ai/kagent/config. These manifests are deployed as ApplicationSets:

project: ai
syncWave: "2"
name: kagent-config
path: ai/kagent/config
namespace: kagent

Basic usage

Example using kagent Agent kgateway-agent, which comes pre-configured with default installation.

demo-kagent-img1

Adding Tools

% k explain --recursive agent.spec.tools                                                                                                                                                                                                                                                   
...
  agent <Object>
    ref <string>
  builtin       <Object>
    config      <Object>
    name        <string>
  mcpServer     <Object>
    toolNames   <[]string>
    toolServer  <string>
  type  <string>

Working example of an Agent with MCP and Agent connected (full manifest):

  tools:
  - type: McpServer
    mcpServer:
      toolServer: mcp-website-fetcher
      toolNames: ["fetch"]
  - type: Agent
    agent:
      ref: k8s-agent
Screenshot 2025-06-25 at 9 34 51 pm

But when the connected agent can't solve the task the calling agent silently ignores and does nothing:

Screenshot 2025-06-25 at 9 37 46 pm
⚠️ **GitHub.com Fallback** ⚠️