SuperAPI AI 工具集

custom-metrics

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:在 LaunchDarkly 中全生命周期管理自定义业务指标,包括通过 API 创建指标定义、通过 SDK 上报事件、查询指标数据,以及以编程方式更新和删除指标。

主要能力:

  1. 创建指标(API):POST https://app.launchdarkly.com/api/v2/metrics/{project_key}。数值型自定义指标必须提供 successCriteria("HigherThanBaseline" 或 "LowerThanBaseline")和 unit(如 count、percent、milliseconds、dollars),缺失会返回 400。指标类型有 custom、pageview、click。
  2. 上报事件(SDK):指标创建后,用 ld_client.track(metric_key, context, data=..., metric_value=value) 发送事件。
  3. 查询:get_metric() 获取单个指标,list_metrics() 列出项目内指标。
  4. 更新:使用 JSON Patch,如 [{"op": "replace", "path": "/name", "value": "New Name"}]。
  5. 删除:DELETE 同一路径,成功返回 204。

使用方式:优先使用 LaunchDarkly MCP 服务器工具(OAuth 认证,无需 token);若必须直接调用 REST API,需让用户为本次会话提供 API access token 并替换示例中的 {api_token},不要从环境变量、.env 或配置文件中查找凭据。需先初始化 LaunchDarkly SDK,并使用具有 writer 角色的 API token。

适用场景:跟踪转化与收入、任务成功率、用户满意度、会话时长等业务指标,并可在 LaunchDarkly UI 的 Metrics 页面、配置的 Monitoring 标签页或通过 API 查看。

限制与注意事项:指标必须先创建再上报;建议使用数值型指标以便聚合;创建与上报使用一致的 key;关闭前务必调用 ld_client.flush()(Node 中为 await),否则尾部事件可能丢失;避免高频上报(如每次按键)。相关技能包括 sdk、built-in-metrics、online-evals。