SuperAPI AI 工具集

convex-monitor

部署与运维

查看项目

更新于 10-16 16:04

技能介绍

用途

convex-monitor 用于监控 Convex 应用,等待下一个需要响应的开发或生产环境错误或请求,并据此作出反应。它的核心目标是让代理阻塞等待下一个类型化事件,而不是通过轮询来消耗资源。

主要能力

该技能会竞速本地错误日志、部署订阅以及 Sentinel 生产错误记录,返回最先触发的事件,或者在没有事件时返回一个安静的心跳信号。事件模式是固定且带版本的,因此相同的触发条件会产生相同的类型化事件。

使用方式

调用 wait_for_event,传入参数 {project_dir, event_kinds, timeout_ms}。根据返回的事件类型执行对应操作:

  • kind=convex_error/next_error:解码并修复该错误。
  • kind=prod_error:进行分诊(参见 sentinel)并修复。
  • kind=feature_request:构建该功能请求。
  • kind=quiet:继续循环等待。

在缺少阻塞式 MCP 的运行环境(例如 Copilot cloud)中,该技能包会运行一个轮询循环,但使用相同的事件契约——行为一致,只是机制不同。

适用场景

适用于需要持续监控 Convex 应用、及时响应开发或生产环境错误以及功能请求的场景。

限制

规则要求优先使用阻塞式工具,仅在阻塞式 MCP 较弱的环境下回退到轮询循环。生产事件(kind=prod_error)需要已部署的云应用以及 Sentinel 支持。