此节点会监听所选 KNX Ultimate 网关上的所有 KNX 电报，生成流量统计、检测异常，并可选调用 LLM。

输出

  1. 摘要/统计（msg.payload 为 JSON）
  2. 异常（msg.payload 为 JSON）
  3. AI 助手（msg.payload 为文本，包含 msg.summary）

命令（输入）

发送 msg.topic：

  • summary（或空）：立即输出摘要
  • reset：清空内部历史与计数器
  • ask：向已配置的 LLM 提问

ask 的问题建议放在 msg.prompt，也可放在 msg.payload（字符串）。

配置字段

以下是编辑器里用户可见的全部字段名称。

通用

  • Gateway：作为电报来源的 KNX Ultimate 网关/配置节点。
  • Name：节点名称与仪表板标题。
  • Topic：节点输出使用的基础 topic。
  • Open KNX AI Web 按钮：打开网页仪表板（/knxUltimateAI/sidebar/page）。

Capture

  • Capture GroupValue_Write：抓取 Write 电报。
  • Capture GroupValue_Response：抓取 Response 电报。
  • Capture GroupValue_Read：抓取 Read 电报。

Analysis

  • Analysis window (seconds)：摘要/速率统计主窗口。
  • History window (seconds)：内部历史保留窗口。
  • Max stored events：内存中保留的最大电报数量。
  • Auto emit summary (seconds, 0=off)：周期性输出摘要间隔。
  • Top list size：摘要中 top 组地址/来源数量。
  • Detect simple patterns (A -> B)：启用组地址转移/模式检测。
  • Pattern max lag (ms)：模式关联允许的最大时间差。
  • Pattern min occurrences：报告模式前的最小出现次数。

Anomalies

  • Rate window (seconds)：异常速率检查滑动窗口。
  • Max overall telegrams/sec (0=off)：全总线 telegram/s 阈值。
  • Max telegrams/sec per GA (0=off)：单组地址 telegram/s 阈值。
  • Flap window (seconds)：抖动/快速变化检测窗口。
  • Max changes per GA in window (0=off)：窗口内允许的最大变化次数。

LLM Assistant

  • Enable LLM assistant：启用 Ask/chat 功能。
  • Provider：LLM 后端（OpenAI-compatible 或 Ollama）。
  • Endpoint URL：chat/completions 接口 URL。
  • API key：API Key（本地 Ollama 可不填）。
  • Model：模型 ID/名称。
  • System prompt：KNX 分析全局系统提示词。
  • Temperature：采样温度。
  • Max tokens：最大生成 token 数。
  • Timeout (ms)：LLM 请求 HTTP 超时。
  • Recent events included：提示词中包含的最近事件数量上限。
  • Include raw payload hex：在提示词中包含原始十六进制 payload。
  • Include Node-RED KNX node inventory：在提示词中包含 flow 清单。
  • Max flow nodes included：flow 清单中最多包含的节点数。
  • Include documentation snippets (help/README/examples)：在提示词中包含文档片段。
  • Docs language：文档片段优先语言。
  • Max docs snippets：文档片段最大条数。
  • Max docs chars：文档片段最大总字符数。
  • Refresh 按钮：请求 provider 并加载可用模型 ID。

安全说明

启用 LLM 后，KNX 流量上下文可能发送到所配置的 endpoint。若需严格本地化，请使用本地 provider。