116 lines
2.4 KiB
Markdown
116 lines
2.4 KiB
Markdown
## 继续 - 意图规则使用指南补充内容
|
|
|
|
### 4.2 创建意图规则 - 响应示例
|
|
|
|
```json
|
|
{
|
|
"id": "550e8400-e29b-41d4-a716-446655440000",
|
|
"name": "转人工意图",
|
|
"keywords": ["人工", "客服", "投诉", "找人"],
|
|
"patterns": ["转.*人工", "找.*客服", "我要.*投诉"],
|
|
"priority": 200,
|
|
"response_type": "transfer",
|
|
"target_kb_ids": [],
|
|
"flow_id": null,
|
|
"fixed_reply": null,
|
|
"transfer_message": "正在为您转接人工客服，请稍候...",
|
|
"is_enabled": true,
|
|
"hit_count": 0,
|
|
"created_at": "2026-02-27T12:00:00Z",
|
|
"updated_at": "2026-02-27T12:00:00Z"
|
|
}
|
|
```
|
|
|
|
### 4.3 查询意图规则列表
|
|
|
|
**接口**: `GET /admin/intent-rules`
|
|
|
|
**查询参数**:
|
|
- `response_type` (可选): 按响应类型筛选
|
|
- `is_enabled` (可选): 按启用状态筛选
|
|
|
|
**请求示例**:
|
|
```bash
|
|
curl -X GET http://ai-service:8080/admin/intent-rules \
|
|
-H "X-API-Key: your_api_key" \
|
|
-H "X-Tenant-Id: szmp@ash@2026"
|
|
```
|
|
|
|
### 4.4 更新意图规则
|
|
|
|
**接口**: `PUT /admin/intent-rules/{rule_id}`
|
|
|
|
### 4.5 删除意图规则
|
|
|
|
**接口**: `DELETE /admin/intent-rules/{rule_id}`
|
|
|
|
---
|
|
|
|
## 5. 实际使用场景
|
|
|
|
### 5.1 常见问题快速回复
|
|
|
|
使用 fixed 类型直接返回预设回复，跳过 LLM 调用，响应速度快且成本低。
|
|
|
|
### 5.2 专业领域定向检索
|
|
|
|
使用 rag 类型将问题路由到特定知识库，提高检索精准度。
|
|
|
|
### 5.3 复杂流程引导
|
|
|
|
使用 flow 类型启动多轮对话流程，自动收集用户信息。
|
|
|
|
### 5.4 敏感问题转人工
|
|
|
|
使用 transfer 类型直接转接人工客服。
|
|
|
|
---
|
|
|
|
## 6. 缓存机制
|
|
|
|
- **缓存位置**: 内存缓存
|
|
- **缓存键**: tenant_id
|
|
- **TTL**: 60 秒
|
|
- **失效时机**: 创建/更新/删除规则时立即清除
|
|
|
|
---
|
|
|
|
## 7. 最佳实践
|
|
|
|
### 7.1 关键词设计
|
|
|
|
- 长度: 2-6 个字
|
|
- 使用完整词组
|
|
- 避免太短或太长
|
|
|
|
### 7.2 优先级设计
|
|
|
|
- 200+: 紧急/敏感问题
|
|
- 100-199: 重要业务流程
|
|
- 50-99: 常规咨询
|
|
- 0-49: 通用兜底规则
|
|
|
|
---
|
|
|
|
## 8. 故障排查
|
|
|
|
### 8.1 规则未生效
|
|
|
|
检查: 规则是否启用、缓存是否过期、优先级是否正确
|
|
|
|
### 8.2 误匹配问题
|
|
|
|
优化关键词和正则表达式，调整优先级
|
|
|
|
---
|
|
|
|
## 9. 总结
|
|
|
|
意图规则提供智能路由功能，支持四种响应类型，具有高性能缓存和租户隔离特性。
|
|
|
|
---
|
|
|
|
**文档版本**: v1.0
|
|
**生成时间**: 2026-02-27
|
|
**维护状态**: ✅ 活跃维护
|