SuperAPI AI 工具集

monte-carlo-analyze-root-cause

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:当用户提到 Monte Carlo 告警、事故或异常,询问表为何过期、行数为何下降,或需要排查数据质量、新鲜度、Schema、管道(Airflow、dbt、Databricks)失败时启用。不适用于创建监控、变更前影响评估、存储成本分析或无具体事故的管道性能排查。

主要能力:通过 Monte Carlo MCP 工具获取告警详情、表元数据、表级与字段级血缘、新鲜度与大小历史、查询历史与 SQL 变更、ETL 问题与作业、GitHub PR、作业性能及统一变更时间线;可选调用 alert_assessment 做约两分钟分诊,或启动 Troubleshooting Agent(TSA)异步分析。

使用方式:工具必须经本插件内置服务器调用,全限定名为 mcp__plugin_mc-agent-toolkit_monte-carlo-mcp__<tool>,不要路由到单独配置的 monte-carlo-mcp。参考文件用 Read 工具读取,如 references/<type>-investigation.md、data-exploration.md、intake-no-incident.md、common-root-causes.md。流程为:理解问题(有事故 ID 用 get_alerts,无 ID 走 intake 流程)、有事故 UUID 时并行启动 TSA、映射血缘影响范围、按问题类型查对应 playbook、检查上游、必要时用数据库 MCP 做数据剖析、检查代码变更、最后综合呈现根因、证据链、影响、修复与预防建议。

限制:需配置并认证 Monte Carlo MCP;数据库 MCP 与 GitHub MCP 为可选,缺失时无法直接查询数据或查 PR。run_troubleshooting_agent 需事故 UUID,默认异步且幂等,force_rerun=True 会产生计费运行;alert_assessment 与 TSA 消耗 Monte Carlo 积分。不得编造数据,不得向用户暴露 MCON、UUID 等内部标识,用户明确要求跳过 TSA 时应遵守。