wecom_it_smart_desk/docs/02-产品需求/dify_byod_intent_prompt.md

Dify 意图识别 System Prompt 更新指南 — 新增「自备电脑补贴」意图

⚠️ 已废弃（2026-07-17）：本文档对应的「BYOD 意图识别」链路（POST /byod/detect-intent）已确认为死链路——前端自 v2.0 起无调用，后端端点将在 v4.0 重构（批次 2）中删除。BYOD 判断现由后端关键词拦截（h5_ai_task.py BYOD 分支）+ 岗位匹配直接处理，不经过 Dify。本文档仅作历史参考，请勿再部署到 Dify。

背景

当前 Dify 审批意图识别应用已支持 12 种审批类型的意图检测。本次需在其 System Prompt 中新增「自备电脑补贴（BYOD）」意图的识别能力，使 Dify 能区分用户是在询问审批流程还是在询问自备电脑补贴资格。

更新步骤

1. 登录 Dify 后台

访问 Dify 管理平台，找到「审批意图识别」应用（即后端 approval_dify_api_key 对应的应用）。

2. 编辑 System Prompt

在应用的「提示词编排」页面，找到 System Prompt 配置区域，在现有内容的基础上追加以下 BYOD 意图识别说明：

---

## 自备电脑补贴（BYOD）意图识别

除了上述审批意图外，你还需要识别用户是否在询问"自备电脑补贴"相关问题。

### 触发条件

当用户消息包含以下关键词或语义时，判定为自备电脑补贴意图：
- 自备电脑、自带电脑、个人电脑
- 电脑补贴、补贴资格
- BYOD
- 自备电脑补贴怎么申请
- 哪些岗位可以申请电脑补贴
- 我能不能申请自备电脑补贴

### 返回格式

当检测到自备电脑补贴意图时，返回以下 JSON（注意 is_byod_intent 为 true，is_approval_request 为 false）：

```json
{
  "is_approval_request": false,
  "is_byod_intent": true,
  "confidence": 0.95,
  "approval_type": null
}

当检测到审批意图（非 BYOD）时，返回以下 JSON（is_byod_intent 为 false）：

{
  "is_approval_request": true,
  "is_byod_intent": false,
  "confidence": 0.9,
  "approval_type": "设备申请"
}

当既不是审批意图也不是 BYOD 意图时：

{
  "is_approval_request": false,
  "is_byod_intent": false,
  "confidence": 0.1,
  "approval_type": null
}

注意事项

1. 自备电脑补贴意图和审批意图互斥：一条消息只能归属其中一种
2. 如果用户同时提到审批和自备电脑补贴，优先判定为自备电脑补贴意图（因为 BYOD 是更具体的场景）
3. confidence 值反映意图识别的确定程度，建议 ≥ 0.7 才视为有效识别

---

### 3. 发布应用

保存 System Prompt 修改后，点击「发布」使更改生效。

### 4. 验证

使用以下测试用例验证 Dify 意图识别是否正确：

| 输入文本 | 期望输出 |
|---------|---------|
| "我想申请自备电脑补贴" | `is_byod_intent: true, confidence: 0.9+` |
| "自备电脑补贴哪些岗位可以申请" | `is_byod_intent: true, confidence: 0.9+` |
| "BYOD补贴怎么弄" | `is_byod_intent: true, confidence: 0.9+` |
| "我要申请一台笔记本电脑" | `is_approval_request: true, is_byod_intent: false` |
| "你好" | `is_approval_request: false, is_byod_intent: false` |

## 后端对接说明

后端 `backend/app/api/byod.py` 中的 `_call_dify_byod_intent` 函数复用同一个 Dify 应用（`approval_dify_base_url` / `approval_dify_api_key`），解析返回 JSON 中的 `is_byod_intent` 字段。

当 Dify 不可用时，后端会降级为关键词匹配（`BYOD_PREFILTER_KEYWORDS`），确保服务可用性。

## 资格岗位清单参考

自备电脑补贴覆盖 14 个岗位（4 大类），供 Dify System Prompt 参考：

| 序列 | 类别 | 岗位 |
|------|------|------|
| 技术序列 | 开发类 | 算法岗、前端开发岗、后端开发岗、客户端开发岗、运维开发岗、移动端开发岗 |
| 技术序列 | 数据类 | 数据分析岗、大数据开发岗 |
| 技术序列 | 测试类 | 测试开发岗、业务测试岗 |
| 产品序列 | 产品策划与设计类 | 创意设计岗、用户体验设计岗、产品经理 |