## 继续 - 意图规则使用指南补充内容

### 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
**维护状态**: ✅ 活跃维护
