一、适用场景
智能问数场景使用MCP服务示意图
二、MCP 工具说明
在指标 MCP 服务中,封装了3个工具,用语义检索匹配的指标/维度,以及根据匹配的指标维度等信息查询指标计算结果。各个工具介绍如下:
| 工具 | 工具介绍 |
| SearchMetric | 指标定义检索接口,可根据入参中的关键字语义检索最匹配的指标和对应的分析维度,如果有多个匹配的指标,检索结果返回后可由 Agent 或用户判断哪个或哪几个是目标查询指标。 |
| QueryMetricData | 指标数据查询接口,可根据 SearchMetric 接口返回的指标和维度,以及用户问题中的指标查询条件,查询最终指标计算结果。 |
| QueryMetricDataBySemQL | 查询 SemQL 指标数据的结果,具体 SemQL 的语法请参见 SemQL 语法。该工具的作用与 QueryMetricData 接口相同,只是请求方式有差异,实际使用中,二选一即可。 |
三、MCP 服务调用说明
| 内容 | 介绍 |
| 服务URL | https://api-{{地域}}.wedata.cloud.tencent.com/api/mcp/v1/metric注意:每个WeData地域对应同一个请求URL,请求中的地域需填写当前开通 WeData 所在地域。示例:https://api-ap-guangzhou.wedata.cloud.tencent.com/api/mcp/v1/metricWeData 支持的地域列表 请参见 公共参数 > 地域列表。 |
| 类型 | 可流式传输的HTTP(streamableHttp) |
| 请求头参数 | TENCENTCLOUD_SECRET_ID=点击去获取TENCENTCLOUD_SECRET_KEY=点击去获取TENCENTCLOUD_REGION=地域列表注意:1. 请求头参数中的 TENCENTCLOUD_SECRET_ID和TENCENTCLOUD_SECRET_KEY 分别取自腾讯云 UIN 账号下 API 密钥管理生成的对应的 SecretId 和 SecretKey 信息,参考下图。2. 该 UIN 需开通 WeData 权限,且申请了 MCP 服务需查询的目标范围指标调用权限,即 MCP 服务的指标查询范围,严格限定为该 UIN 已授权调用的指标。 |