数据源无法自动关联导致异常检测误报或漏检时，需配置data_link_rules.yaml声明关联字段、启用ACP协议注入关联上下文、挂载自定义LinkResolver技能模块、修改modal.py启用分布式关联计算。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Hermes Agent 进行异常检测任务时，发现数据源之间无法自动建立语义或时序关联，导致 Anomaly 模块输出误报率升高或漏检，则可能是由于数据关联规则未正确配置或未适配 Anomaly 集成上下文。以下是解决此问题的步骤：
一、配置 data_link_rules.yaml 显式声明关联字段
该方法通过 YAML 文件定义跨数据源的主键/时间戳/业务标识映射关系，使 Anomaly 模块在特征对齐阶段能准确执行 join 与滑动窗口同步。Hermes Agent 在加载 tools/anomaly/ 时会优先读取此规则文件，覆盖默认的启发式匹配逻辑。
1、进入 Hermes Agent 项目根目录，定位至 tools/anomaly/config/ 子路径。
2、检查是否存在 data_link_rules.yaml；若不存在，创建该文件。
3、在文件中按规范编写关联规则，例如：
sources:
- name: "prometheus_metrics"
key_field: "instance_id"
time_field: "timestamp"
- name: "log_events"
key_field: "host"
time_field: "event_time"
link:
join_on: ["instance_id", "host"]
time_tolerance_ms: 5000
二、启用 ACP 协议 session/prompt 扩展参数注入关联上下文
该方法利用 Hermes Agent 的 ACP 协议标准接口，在发起 Anomaly 分析请求时，将动态关联规则作为 prompt 元数据透传至后端执行器，绕过静态配置限制，适用于多租户或临时分析场景。
1、构造符合 ACP 规范的 JSON 请求体，确保包含 "x-hermes-link-context" 自定义 header。
2、在 request body 的 session/prompt 字段中嵌入 link_rules 对象，结构如下：
{"prompt": "detect anomalies in CPU usage",
"metadata": {"x-hermes-link-context": {"primary_key_map": {"prometheus": "instance_id", "loki": "hostname"}, "temporal_align": "strict"}}}
3、通过 StdioAcpTransport 或 SignalR 通道提交该请求，HermesGrain 将解析并激活运行时关联策略。
三、挂载自定义 LinkResolver 技能模块
该方法通过扩展 Hermes Agent 的 skills/ 目录，注册一个可热重载的 Python 技能类，实现非结构化日志、指标、追踪三元组之间的模糊语义关联，适用于 service mesh 场景下 span_id 与 metric label 不完全一致的情况。
1、在 skills/anomaly/link_resolver/ 下新建 resolver.py，继承 BaseLinkResolver 并实现 match() 方法。
2、在同目录下添加 SKILL.md，声明技能元信息及触发条件，例如：
trigger: "when trace_id appears in logs but not in metrics"
3、执行 hermes skill install --path skills/anomaly/link_resolver 完成注册，Anomaly 模块将在 next run 中自动加载该解析器。
四、修改 environments/modal.py 启用分布式关联计算
该方法针对超大规模时序数据（如每秒百万级指标点），将原本单机内存内完成的关联逻辑卸载至 Modal 无服务器环境，利用其弹性 GPU 实例加速笛卡尔积过滤与相似性哈希计算。
1、打开 environments/modal.py，定位至 ModalAnomalyExecutor 类。
2、在 execute_link_phase() 方法中，替换原生 Pandas merge 调用为 modal.Function.lookup("anomaly-linker", "run") 远程调用。
3、确保 Modal App 已部署对应函数，并在 ~/.hermes/config.yaml 中启用 distributed_linking: true 开关。
