diff --git a/public/sitemap.xml b/public/sitemap.xml index 9fe9155c..943497e0 100644 --- a/public/sitemap.xml +++ b/public/sitemap.xml @@ -2,658 +2,686 @@ https://kagent.dev/agents - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/blog - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/community - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agents - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts/architecture - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts/tools - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-agents - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-byo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/crewai-byo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/discord-a2a - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/documentation - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/langchain-byo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/slack-a2a - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-mcp-tool - 2025-10-28 + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/getting-started/local-development + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/quickstart - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/system-prompts - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/tracing - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/introduction/installation - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/introduction - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/introduction/what-is-kagent - 2025-10-28 + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations/debug + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations/uninstall + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations/upgrade + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/api-ref - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-add-mcp - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-bug-report - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-build - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-dashboard - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-deploy - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-get - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-init - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-install - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-invoke - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-mcp - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-run - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-uninstall - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-version - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/faq - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/helm - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/release-notes - 2025-10-28 - weekly - 0.8 - - - - https://kagent.dev/docs/kagent/resources/troubleshooting - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/amazon-bedrock - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/anthropic - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/azure-openai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/byo-openai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/gemini - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/google-vertexai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/ollama - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/openai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/install-controller - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/deploy - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/server - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/develop/fastmcp-python - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/develop/mcp-go - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/develop - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/introduction - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/quickstart - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/api-ref - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-add-tool - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-build - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-deploy - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-init - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-install - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-run - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-secrets - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/secrets - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/enterprise - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/page.tsx - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/argo-rollouts-conversion-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/cilium-crd-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/helm-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/istio-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/k8s-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/kgateway-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/observability-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/promql-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/istio - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/kubernetes - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/prometheus - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/documentation - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/helm - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/argo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/grafana - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/other - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/cilium - 2025-10-28 + 2025-10-29 weekly 0.8 diff --git a/src/app/docs/kagent/concepts/tools/page.mdx b/src/app/docs/kagent/concepts/tools/page.mdx index 6730a8b1..46397f81 100644 --- a/src/app/docs/kagent/concepts/tools/page.mdx +++ b/src/app/docs/kagent/concepts/tools/page.mdx @@ -35,3 +35,11 @@ MCP stands for [Model Context Protocol](https://modelcontextprotocol.io/introduc ## HTTP Tools HTTP tools are another way to bring external tools into kagent. Simply put, given a URL and a schema, kagent will send the user query to the URL and return the response. Kagent has the ability to discovery HTTP tools from services running in the cluster, assuming they are OpenAPI Compliant. + +## Build your own tools with kmcp + +A subproject of kagent, kmcp provides a powerful CLI tool with built-in boilerplates to speed up the local development of MCP servers and MCP tools. Then, you can use the kmcp control plane to quickly spin up and deploy your MCP servers in your cloud-native environment, such as Kubernetes. + +By default, kmcp is installed with kagent. If you already installed kmcp separately, you can set `kmcp.enabled=false` in your `values.yaml` file or `--set` commands for both the `kagent` and `kagent-crds` charts. + +Planning to use your kmcp resources later with kagent and agentgateway? Add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway. diff --git a/src/app/docs/kagent/getting-started/local-development/page.mdx b/src/app/docs/kagent/getting-started/local-development/page.mdx index f5253992..e8205127 100644 --- a/src/app/docs/kagent/getting-started/local-development/page.mdx +++ b/src/app/docs/kagent/getting-started/local-development/page.mdx @@ -66,18 +66,23 @@ Before you run the agent, you must set the OpenAI API key as an environment vari export OPENAI_API_KEY= ``` +Then, let's change into the project directory. If you skip this step, just remember to add the project directory in each `kagent` command later, like `kagent build myagent`. + +```shell +cd myagent +``` + Let's build the agent: ```shell -kagent build myagent +kagent build ``` >Note the agent is automatically tagged with the `localhost:5001` registry, so make sure your Kubernetes cluster later on is configured to use this registry or push the image to a remote registry. -Now you can run the agent locally and test it out by running the following command from the `myagent` project directory: +Now you can run the agent locally and test it out by running the following command with the `myagent` project directory: ```shell -cd myagent kagent run ``` @@ -102,6 +107,11 @@ This command adds an entry to the `kagent.yaml` file and creates a new directory Whenever you add a new MCP server to the agent, the `docker-compose.yaml` file is updated to include the new MCP server. For example, after adding the above MCP server, the entry for it in the `docker-compose.yaml` file will look like this: +```bash +cat docker-compose.yaml +``` + +Example output: ```yaml server-everything: image: localhost:5001/myagent-server-everything:latest @@ -112,15 +122,39 @@ Whenever you add a new MCP server to the agent, the `docker-compose.yaml` file i - "3000" ``` -By default, all tools from the MCP server will be automatically available and added to the agent. You can also filter the tools by name or by using a predicate. For example, to only add the `add` tool, you can modify the `agent.py` file like this: +By default, all tools from the MCP server will be automatically available and added to the agent. You can also filter the tools by name or by using a predicate. + +The `mcp_tools.py` file is automatically generated when you add an MCP server that has the `get_mcp_tools` function. +The generated `agent.py` file already includes the import statement: ```python -mcp_tools = get_mcp_tools(server_filters={"server-everything": ["add"]}) +from .mcp_tools import get_mcp_tools ``` -This will only include the `add` tool from the `server-everything` MCP server. Let's rebuild the project using `kagent build` and then run the agent again using `kagent run`: +Open the `agent.py` file and find the line where `mcp_tools` is defined (usually near the bottom of the file) to filter specific tools. + +For example, to only add the `add` tool from the `server-everything` MCP server: +* Replace this line: + ```python + mcp_tools = get_mcp_tools() + ``` + +* with this line: + + ```python + mcp_tools = get_mcp_tools(server_filters={"server-everything": ["add"]}) + ``` + +This filter only includes the `add` tool from the `server-everything` MCP server. + +After updating your code, rebuild and run the project with + +``` +kagent build && kagent run +``` +Then repeat your question to check that the agent has access to the `add` tool. ```console You: what can you do? diff --git a/src/app/docs/kagent/getting-started/quickstart/page.mdx b/src/app/docs/kagent/getting-started/quickstart/page.mdx index 74903ea8..97bfb4b6 100644 --- a/src/app/docs/kagent/getting-started/quickstart/page.mdx +++ b/src/app/docs/kagent/getting-started/quickstart/page.mdx @@ -38,7 +38,7 @@ To run the AI agents you'll also need an [OpenAI](https://openai.com) API key. Y curl https://raw.githubusercontent.com/kagent-dev/kagent/refs/heads/main/scripts/get-kagent | bash ``` -3. Install kagent to the cluster by using the CLI. +3. Install kagent to the cluster by using the CLI. By default, kagent installs a demo profile with agents and MCP tools preloaded for you. If you don't want these default agents, include the `--profile minimal` flag. ```bash kagent install diff --git a/src/app/docs/kagent/introduction/installation/page.mdx b/src/app/docs/kagent/introduction/installation/page.mdx index 162c3d99..348c63eb 100644 --- a/src/app/docs/kagent/introduction/installation/page.mdx +++ b/src/app/docs/kagent/introduction/installation/page.mdx @@ -35,7 +35,7 @@ Install kagent by using the kagent CLI or Helm. curl https://raw.githubusercontent.com/kagent-dev/kagent/refs/heads/main/scripts/get-kagent | bash ``` -3. Install kagent to the cluster by using the CLI. +3. Install kagent to the cluster by using the CLI. By default, kagent installs a demo profile with agents and MCP tools preloaded for you. If you don't want these default agents, include the `--profile minimal` flag. ```bash kagent install @@ -58,16 +58,18 @@ Another way to install kagent is using Helm. --create-namespace ``` +2. Optionally prepare a Helm values file or `--set` flags to use for your installation. For example, you might set up your default LLM provider, or configure resource requests and limits or disable the default agents. For options, refer to the [Helm reference docs](/docs/kagent/resources/helm). +
-2. Set the `OPENAI_API_KEY` environment variable: +3. Set the `OPENAI_API_KEY` environment variable: ```bash export OPENAI_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -78,13 +80,13 @@ Another way to install kagent is using Helm.
-2. Set the `ANTHROPIC_API_KEY` environment variable: +3. Set the `ANTHROPIC_API_KEY` environment variable: ```bash export ANTHROPIC_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -95,13 +97,13 @@ Another way to install kagent is using Helm.
-2. Set the `OPENAI_API_KEY` environment variable: +3. Set the `OPENAI_API_KEY` environment variable: ```bash export OPENAI_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -113,13 +115,13 @@ Another way to install kagent is using Helm.
-2. Set the `GEMINI_API_KEY` environment variable: +3. Set the `GEMINI_API_KEY` environment variable: ```bash export GEMINI_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -131,7 +133,7 @@ Another way to install kagent is using Helm.
-2. Install the kagent Helm chart: +3. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ diff --git a/src/app/docs/kagent/resources/release-notes/page.mdx b/src/app/docs/kagent/resources/release-notes/page.mdx index 9a8cbbbf..85a70868 100644 --- a/src/app/docs/kagent/resources/release-notes/page.mdx +++ b/src/app/docs/kagent/resources/release-notes/page.mdx @@ -16,12 +16,16 @@ export const metadata = { The kagent documentation shows information only for the latest release. If you run an older version, review the release notes to understand the main changes from version to version. +For more details on the changes between versions, review the [kagent GitHub releases](https://github.com/kagent-dev/kagent/releases). + # v0.7 Review the main changes from kagent version 0.6 to v0.7, then continue reading for more detailed information. * kmcp is installed by default when you install kagent -* New! Develop agents locally without a Kubernetes cluster +* New feature to develop agents locally without a Kubernetes cluster +* New `kgateway.dev/discovery` label +* Installation profiles ## kmcp installed by default @@ -57,6 +61,20 @@ Develop and test agents locally on your machine without needing a Kubernetes clu For more information, see the [local development](/docs/kagent/getting-started/local-development) guide. +## Discovery label + +Now, you can add a discovery label to MCPServer kmcp resources. By default, discovery is enabled. + +If you plan to use your kmcp resources later with kagent and agentgateway, add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway. + +## Installation profiles + +By default, kagent installs a `demo` profile with agents and MCP tools preloaded for you. If you don't want these default agents, you can disable them with the `minimal` profile. + +For the CLI: `kagent install --profile minimal` + +For Helm installations: Individually disable the default agents with Helm values or `--set` flags, such as `--set agents.argo-rollouts-agent.enabled=false`. You can also use Helm to update the resource limits and requests for each agent. + # v0.6 Review the main changes from kagent version 0.5 to v0.6, then continue reading for more detailed information. diff --git a/src/app/docs/kmcp/deploy/server/page.mdx b/src/app/docs/kmcp/deploy/server/page.mdx index ca2db935..a31a0076 100644 --- a/src/app/docs/kmcp/deploy/server/page.mdx +++ b/src/app/docs/kmcp/deploy/server/page.mdx @@ -99,7 +99,9 @@ The following example assumes that you created a [FastMCP](/docs/kmcp/develop/fa kmcp build --project-dir my-mcp-server -t my-mcp-server:latest --kind-load-cluster kind ``` -2. Deploy your MCP server. Choose between the kmcp CLI or manually creating an MCPServer resource. +2. Deploy your MCP server. Choose between the kmcp CLI or manually creating an MCPServer resource. + + > **Note**: Planning to use your kmcp resources later with kagent and agentgateway? Add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway.