为自托管 KMonitor 设置 KMonitor Agent

在您的自托管实例上配置 KMonitor Agent。获取 OpenRouter API 密钥，选择模型并公开代理服务，以便您可以从编码代理或 Slack 调试您的应用程序。

使用本指南进行设置KMonitor Agent在自托管实例上，因此您可以从编码代理（通过 MCP）或从 Slack 调试您的应用。

代理作为独立的 agent 服务运行，默认通过 OpenRouter 调用语言模型。也可以通过 LLM_BASE_URL 指定兼容 OpenAI 接口的自建网关，包括管理自有 API Key 池的网关。您需要提供网关 API Key，并选择代理使用的模型。

获取 OpenRouter API 密钥

创建一个帐户开放路由器.ai.
将积分添加到您的帐户制作人员页。 OpenRouter 按令牌对代理的使用量进行计费，因此帐户需要有正余额才能让代理回答问题。
创建一个 API 密钥按键页并复制它。您将其设置为LLM_AGENT_KEY.
或者，为文档页面上的 Ask AI 聊天创建第二个密钥。您将其设置为LLM_DOCS_CHAT_KEY。给这个密钥一个信用限额，这样来自公共文档页面的流量就不能花费代理的信用。跳过它以关闭文档聊天。

选择型号

该代理使用两种模型：

小型号 (LLM_AGENT_MODEL_SMALL) 处理轻松的工作：总结长时间的对话并找出 Slack 问题与哪个应用程序有关。它不调用工具，因此任何有能力的聊天模型都可以工作。选择一个快速、便宜的。
中型 (LLM_AGENT_MODEL_MEDIUM）通过调用 KMonitor 的工具来回答问题，因此必须支持工具（函数）调用。选择一个更强大的模型，因为这是大多数答案质量的来源。

两种模型都应具有至少 64k 个令牌的上下文窗口，以便它们可以舒适地进行长时间对话。

您可以对两者使用相同的模型，只要它支持工具调用即可。浏览可用型号：openrouter.ai/模型，确认媒介模型列出工具（函数）调用支持，并使用模型的API id，例如deepseek/deepseek-v4-pro.

LLM_AGENT_MODEL_LARGE已接受以实现向前兼容性，但尚未使用。您可以将其留空。

配置新安装

在安装过程中，配置向导会提示输入代理设置。在代理LLM证书和模型出现提示后，粘贴您的 API 密钥以及小型和中型型号 ID。向导写道AGENT_ENABLED=false，因此一旦安装完成，请按照中所述打开代理开启代理.

向导还要求KMonitor Agent服务URL，例如https://measure-agent.yourcompany.com。这是公共地址编码代理用来到达 MCP 端点的。看使代理可通过 MCP 访问.

针对现有安装进行配置

如果您的实例已在运行并且您想要启用或更改代理，请手动更新环境变量。

代理凭证。打开self-host/.env文件并添加以下环境变量。设置从 OpenRouter 获取的凭据和模型，并设置AGENT_ENABLED=true打开代理。

AGENT_ENABLED=true
LLM_BASE_URL=https://your-llm-gateway.example.com/v1 # 可选，默认使用 OpenRouter
LLM_AGENT_KEY=your-llm-api-key                   # 按实际配置修改
LLM_AGENT_MODEL_SMALL=deepseek/deepseek-v4-pro   # change this
LLM_AGENT_MODEL_MEDIUM=deepseek/deepseek-v4-pro  # change this
LLM_DOCS_CHAT_KEY=your-docs-chat-api-key         # optional, turns on the docs Ask AI chat

设置 LLM_BASE_URL 后，模型 ID 和 API Key 必须符合该网关的要求；URL 末尾可以带 /。留空时使用默认地址 https://openrouter.ai/api/v1。

关闭。运行以下命令关闭所有服务。

sudo docker compose -f compose.yml -f compose.prod.yml --profile migrate down

启动。最后，运行install.sh使配置生效的脚本。
```
sudo ./install.sh
```

开启代理

代理默认关闭。仅当AGENT_ENABLED设置为true在self-host/.env;具有任何其他值，或缺少变量，Slack 问题和 MCPask_question工具会收到一条简短的通知，表示客服人员不可用，而不是答复。其他 MCP 工具无需代理即可直接读取数据，因此它们可以继续工作。

要打开代理，请设置变量并重新启动服务，如上所述。

AGENT_ENABLED=true

将其设置回false并重新启动以使代理停止服务而不删除其配置。

使代理可通过 MCP 访问

要通过 MCP 使用来自编码代理的代理，agent服务（端口8084）需要公共领域。这使用与仪表板、API 相同的反向代理和 DNS 设置，并在自托管指南.

为代理域添加反向代理条目。对于 Caddy，请将以下内容添加到您的~/Caddyfile.

measure-agent.yourcompany.com {
	reverse_proxy http://localhost:8084
}

重新加载代理，然后添加指向的 DNS A 记录measure-agent.yourcompany.com在虚拟机的外部 IP 上，与其他子域的操作方式相同。

MCP 端点可在以下位置使用：https://measure-agent.yourcompany.com/mcp。请参阅MCP Server连接编码代理指南。

使用 Slack 中的代理不需要额外的域：Slack 将事件传递到 API 服务，代理在内部使用它们。将其设置为Slack集成指南.

设置 KMonitor Agent