ai-robot-core/intent-rule-usage-appendix.md at feature/prompt-unification-and-logging

2.4 KiB

Raw Permalink Blame History

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

4.2 创建意图规则 - 响应示例

{
  "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 (可选): 按启用状态筛选

请求示例:

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

2.4 KiB Raw Permalink Blame History