SuperAPI AI 工具集

convex-insights

智能体与模型

查看项目

更新于 10-15 21:51

技能介绍

用途:把对运行中 Convex 部署的运维提问(什么在报错、部署后什么开始失败、某次调用为何失败)转化为范围明确、带证据的查询,输出可人工核验的答案。它是官方 Convex MCP 只读工具(logs、insights、functionSpec、status)的纪律化封装。

主要能力与三种视图:failures 视图用 logs --history <n> --jsonl,客户端过滤出失败项,按函数和错误信息分组,返回计数与每组首个堆栈;health 视图用 insights(仅云环境 dev/prod 且需用户认证),查看 72 小时读限制与 OCC 事件,排序呈现但不负责性能修复;trace 视图同样拉取日志窗口后本地过滤到单个 requestId/函数,读完整执行链路。此外可用 status 对比失败起始时间与部署版本,辅助判断部署因果关系。

使用方式:先 GUARD,确认并声明正在读哪个部署,全程只读,绝不为洞察任务开启生产变更标志;再用 functionSpec 发现真实函数名与状态,不猜标识符。注意工具限制:logs 只接受 --history <n>(数量而非时间窗),另有 --success、--jsonl、--prod、--deployment,没有服务端的状态/函数/requestId/时间过滤;insights 没有函数过滤。因此需拉取有界近期窗口并在客户端过滤,窗口大时做聚合计数而非倾倒日志行。每个问题只选一种视图,不做推测性的大量调用。

回答格式:一句话结论、证据(计数加一条代表性堆栈或日志行),并在可能时由代理构造 dashboard.convex.dev 的部署日志/函数视图深链接供人工核验;不得以原始日志堆转储作为答案。

限制与边界:该技能只做观测,不修代码——性能/成本根因作为指针发现交 convex-advisor,代码缺陷交 convex-reviewer/convex-authz,前瞻性监控交 monitor/sentinel,发现通过 findings 总线输出。资料未提供具体收费、价格与安装命令信息。