with one click
diagnostics
系统诊断工具,包括健康检查、日志分析、代理诊断、MCP 诊断
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
系统诊断工具,包括健康检查、日志分析、代理诊断、MCP 诊断
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
多模态服务指南,包括图片生成、视频生成、语音合成、音乐生成的配置与使用
系统概述,介绍 Protocol Proxy 的定位、核心能力和典型使用场景
供应商管理指南,包括创建供应商、配置 API Key、密钥轮换
监控与日志指南,包括用量统计、请求日志、系统日志查看
智控助手使用指南,包括对话、技能管理、斜杠命令、快捷键
MCP 服务配置指南,包括添加、连接、排查 MCP 服务器
| name | diagnostics |
| description | 系统诊断工具,包括健康检查、日志分析、代理诊断、MCP 诊断 |
| trigger | 用户询问系统状态、健康检查、是否有异常、分析日志、查找错误、排查问题、代理连接失败、转发异常、响应慢、请求超时、代理不通、最近有什么报错、MCP 连接失败、MCP 工具不可用、子任务失败、子智能体异常 |
根据用户问题选择对应的诊断流程执行。如果用户未指定具体问题,先执行「健康检查」获取全局状态,再根据发现的异常深入分析。
当用户询问系统状态、整体运行情况时执行。
check_health 获取系统基本状态(版本、运行时长、代理计数)get_proxies 获取所有代理状态get_providers 获取所有供应商及其密钥健康状态get_key_health 获取密钥详细健康数据| 代理 | 端口 | 状态 | 供应商 | 问题 |
|---|---|---|---|---|
| ... | ... | 运行中/已停止/异常 | ... | ... |
| 供应商 | 状态 | 正常 Key 数 | 问题 Key |
|---|---|---|---|
| ... | healthy/partial/unhealthy | X/Y | 列出异常 Key 及原因 |
| 严重程度 | 问题 | 建议 |
|---|---|---|
| 高/中/低 | ... | ... |
当用户询问日志错误、报错排查、问题趋势时执行。
get_system_logs(limit=50)获取系统日志get_recent_requests(limit=30)获取请求记录,可用 status: 'failure' 或 status: '429' 过滤异常请求错误识别:筛选 ERROR 日志和非 2xx 请求,提取错误模式 频率分析:同类错误出现次数、是否集中在某时间段、是否有递增趋势 关联分析:错误是否集中在某个代理/供应商/模型,限流是否集中在某个 Key
| 错误类型 | 出现次数 | 影响范围 | 首次/最近出现 |
|---|---|---|---|
| ... | ... | 代理X/供应商Y | ... |
| 时间 | 代理 | 模型 | 状态 | 延迟 | 问题 |
|---|---|---|---|---|---|
| ... | ... | ... | 4xx/5xx | ...ms | ... |
当用户报告某个代理连接失败、转发异常、响应慢时执行。
get_proxies 获取代理列表,确认目标代理get_proxy 获取该代理详细配置get_provider 获取关联供应商详情get_key_health 获取该供应商密钥状态get_recent_requests(limit=20, proxyId=目标代理ID)筛选该代理的请求记录代理状态:是否运行中?端口是否监听?启动日志有无报错?
供应商连通:供应商是否存在?API 地址可访问?有无正常密钥?
密钥健康:有无 healthy Key?是否全部限流?有无失效 Key?
请求链路:状态码分布?平均延迟?有无超时/连接拒绝?
路由策略:策略是否合理?providerPool 中的供应商是否可用?
客户端连通:如需进一步验证,可调用 test_client_connection(proxyId)向代理发送测试请求,确认端到端连通性
| 检查项 | 状态 | 详情 |
|---|---|---|
| 代理运行 | 正常/异常 | ... |
| 供应商连通 | 正常/异常 | ... |
| 密钥健康 | 正常/异常 | X/Y 个 Key 可用 |
| 请求链路 | 正常/异常 | 成功率 X%,平均延迟 Xms |
| 路由策略 | 正常/异常 | ... |
| 优先级 | 操作 | 说明 |
|---|---|---|
| 高/中/低 | ... | ... |
当用户报告 MCP 连接失败、工具不可用、无法调用 MCP 功能时执行。
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 连接失败 | 包名错误 | 确认正确的包名:@upstash/context7-mcp、@modelcontextprotocol/server-sequential-thinking、open-websearch、stagehand-mcp |
| 连接失败 | 端口被占用 | 设置环境变量 MODE=stdio 禁用 HTTP 服务器(推荐),或更改 PORT |
| 连接关闭 | 状态异常 | 删除该 MCP 配置,重新添加并连接 |
| 工具不可用 | MCP 未连接 | 检查 MCP 服务状态是否为「已连接」 |
get_mcp_servers 获取所有 MCP 服务状态| 服务 | 状态 | 工具数 | 问题 |
|---|---|---|---|
| ... | 已连接/未连接/失败 | X | ... |
| 检查项 | 状态 | 详情 |
|---|---|---|
| MCP 配置 | 正常/异常 | 包名: X,环境变量: X |
| 连接状态 | 正常/异常 | ... |
| 工具可用性 | 正常/异常 | 已连接工具数: X |
| 优先级 | 操作 | 说明 |
|---|---|---|
| 高/中/低 | ... | ... |
当用户报告子任务失败、子代理超时、委派任务异常时执行。
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 任务超时 | 子代理执行时间超过限制 | 增大「设置」→「子智能体」→「超时时间」 |
| 任务失败 | 子代理调用了被阻止的工具 | 检查「阻止工具」和「拒绝工具」配置 |
| 工具被拒绝 | 子代理尝试了 auto-deny 工具 | 正常行为,子代理会换其他方式完成 |
| 命令被禁止 | 子代理执行了 forbidden 级别的命令 | 使用 test_exec_policy 检查策略,必要时调整用户规则 |
| 命令需确认 | 子代理执行了 prompt 级别的命令 | 子代理会自动批准并记录日志,可在系统日志中审查 |
| 子代理无响应 | LLM 服务不可用或代理未运行 | 检查后端代理是否运行中 |
| 沙盒写入失败 | 子代理尝试写入沙盒外路径 | 正常行为,沙盒隔离保护系统安全 |
| 上下文溢出 | 子代理对话轮次过多 | 减少「最大轮次」或简化子任务目标 |
list_tasks(status=failed)获取失败的任务列表get_task 获取失败任务的详细信息(含 error 字段)get_system_logs 搜索 [delegate] 和 [exec-policy] 相关日志get_exec_policy 查看当前策略概览,get_exec_policy_rules 查看完整规则test_exec_policy 测试具体命令,使用 add_exec_policy_rule 调整规则| 任务 ID | 目标 | 状态 | 耗时 | 问题 |
|---|---|---|---|---|
| ... | ... | completed/failed/running | Xs | ... |
| 检查项 | 状态 | 详情 |
|---|---|---|
| 后端代理 | 正常/异常 | ... |
| 子智能体配置 | 正常/异常 | 并发X,轮次X,超时Xs |
| 工具权限 | 正常/异常 | 阻止: X,拒绝: X |
| 执行策略 | 正常/异常 | allow X, prompt X, forbidden X |
| 沙盒环境 | 正常/异常 | ... |
| 优先级 | 操作 | 说明 |
|---|---|---|
| 高/中/低 | ... | ... |