Skip to content

增强管理端供应商健康诊断与错误提示 #16

Description

@ruibaby

背景

当前供应商详情页已有连通性检查和基础状态展示,但诊断信息偏少。用户看到“异常”后,仍然需要自行判断问题来自 API Key、Base URL、代理、模型列表接口、具体模型调用,还是供应商返回错误。

AI Foundation 作为底座插件,一旦供应商异常,下游功能也会受影响。管理端需要把“异常”进一步拆成可行动的信息。

目标

增强供应商健康诊断,让管理端能清楚展示检查结果、失败原因和建议动作。

建议能力

  • 展示最近一次检查的结果、时间和错误摘要
  • 区分基础网络连通性、认证、模型发现接口、聊天接口、Embedding 接口等检查项
  • 对常见错误给出可操作提示,例如 API Key 无效、Base URL 不可达、代理不可用、接口不支持
  • 在供应商列表和详情中都能快速看出异常来源
  • 保留原始错误摘要,便于开发者排查

建议交互

  • 供应商列表展示健康状态和简短错误摘要
  • 供应商详情展示分项诊断结果
  • 连通性检查完成后直接刷新状态,并展示本次检查结果
  • 状态异常时,在关联模型列表上方提示可能影响模型调用

后端/API 建议

  • 扩展 AiProvider.status 或新增诊断响应结构,避免只依赖单个 phase/message
  • 连通性检查接口返回结构化结果,同时更新资源状态
  • 与 AiModel 状态/健康检查设计保持一致,避免重复字段和概念漂移
  • 错误信息需要脱敏,不能泄漏 Secret 或 API Key

非目标

  • 不要求实现后台定时健康检查
  • 不要求覆盖每个供应商的全部专有错误码
  • 不要求做告警通知

验收标准

  • 连通性检查失败时,详情页能展示明确失败原因
  • 管理员可以区分配置错误、认证错误、网络错误和接口能力不支持
  • 供应商列表能提示存在异常供应商,并可进入详情查看诊断信息
  • 错误信息不会泄漏敏感凭据

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions