| name | exception-analysis |
| description | 异常分析核心功能。当用户需要分析线上故障、排查错误原因时使用此技能。 |
此技能提供完整的异常分析能力，基于 Plan-Execute-React 模式。
在以下情况调用此技能：
# 分析问题
curl -X POST http://localhost:8080/api/analysis/analyze \
-H "Content-Type: application/json" \
-d '{
"appId": "app-001",
"alarmDescription": "用户登录失败率突然升高",
"alarmUrl": "https://monitor.example.com/alarm/123",
"alarmTime": "2024-01-15T10:30:00"
}'
# 健康检查
curl http://localhost:8080/api/analysis/health
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appId | String | 是 | 应用ID |
| alarmDescription | String | 是 | 告警描述 |
| alarmUrl | String | 否 | 告警链接 |
| alarmTime | DateTime | 否 | 告警时间 |
{
"analysisId": "ANALYSIS-1234567890",
"appId": "app-001",
"alarmDescription": "用户登录失败率突然升高",
"analysisTime": "2024-01-15T10:35:00",
"rootCause": {
"type": "高错误率",
"description": "当前错误率超过阈值",
"confidence": "85%"
},
"evidences": [
{
"source": "发布记录",
"content": "最近发布版本: 1.2.3",
"relevance": "高"
}
],
"suggestions": ["检查服务日志", "查看失败请求"]
}
| 类型 | 说明 | 置信度 |
|---|---|---|
| 高错误率 | 错误率超过10%阈值 | 85% |
| CPU过载 | CPU使用率超过80% | 80% |
| 内存不足 | 内存使用率超过85% | 75% |
| 发布问题 | 告警时间与发布时间接近 | 70% |
| 认证问题 | 涉及登录认证功能 | 65% |
需要配置 DeepSeek API Key：
DEEPSEEK_API_KEY=your-keyapplication.yml 中的 spring.ai.openai.api-key此技能支持生成项目变更文档，记录系统优化和功能变更。
变更文档命名格式：{模块名}-更新说明-{日期}.md
例如：exception-analysis-更新说明-2026-05-05.md
变更文档应包含以下内容：
提供设计系统的标准规范，包括设计原则、视觉风格、组件库等。Invoke when designing new features or components for the application.
MCP 工具创建器。当用户需要为异常分析系统添加新的 MCP 工具时使用此技能。
计划执行器。当用户需要自定义分析计划或执行特定分析步骤时使用此技能。
为项目创建 MCP（Model Context Protocol）工具。当用户想要添加新的 MCP 工具或集成外部 MCP 服务时使用此技能。
为多模型支持创建新的 AI 模型提供商。当用户想要添加对新的 AI 模型（OpenAI、Claude 等）的支持时使用此技能。
集成 Spring AI 聊天功能。当用户想要与 AI 模型对话、创建聊天端点或处理 AI 对话流程时使用此技能。