For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Find solutions to common issues and troubleshooting tips for kagent.

Troubleshoot and debug issues with your kagent installation.

My agent doesn’t seem to be working

If your agent is not showing up even though you applied the manifest, it’s likely because the agent has been rejected by the engine. This error should be reported on the status of the agent.

Run the following command to get the status of the agent:

kubectl get agent -n kagent [agent-name] -o yaml

This should give you the reason why the agent was rejected.

If it’s not there, you can try to get the logs of the agent:

kubectl logs -n kagent deployment/kagent-controller
kubectl logs -n kagent deployment/kagent-ui

You can also set the logging level to DEBUG to get more detailed logs from the agent pod. To do that, edit the agent resource and add the LOG_LEVEL environment variable to the deployment field:

spec:
  declarative:
    deployment:
      env:
      - name: LOG_LEVEL
        value: debug
..

You can also ask for help in the community or log an issue on GitHub. You can create a bug report using the kagent CLI by running kagent bug-report. Before attaching files to your bug report, make sure they don’t contain any sensitive information!