61 lines
1.8 KiB
Markdown
61 lines
1.8 KiB
Markdown
|
---
|
|||
|
|
name: intent_hint
|
|||
|
|
description: 轻量意图识别与路由建议工具，为策略路由提供软信号
|
|||
|
|
triggers:
|
|||
|
|
- 用户意图不明确或存在歧义
|
|||
|
|
- 需要给 policy_router 提供软路由信号
|
|||
|
|
- 用户表达复杂，可能涉及多个意图
|
|||
|
|
- 需要判断应该进入哪种处理模式
|
|||
|
|
anti_triggers:
|
|||
|
|
- 已经明确进入固定模式/流程模式
|
|||
|
|
- 已有确定的意图结果
|
|||
|
|
- 用户问题简单明确，无需意图分析
|
|||
|
|
- 已完成意图识别且上下文未变化
|
|||
|
|
tools:
|
|||
|
|
- intent_hint
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 使用指南
|
|||
|
|
|
|||
|
|
### 何时使用
|
|||
|
|
当用户意图不明确、需要给 policy_router 提供软路由信号时使用。
|
|||
|
|
|
|||
|
|
### 何时不使用
|
|||
|
|
当已经明确进入固定模式/流程模式，或已有确定意图结果时不重复调用。
|
|||
|
|
|
|||
|
|
### 参数说明
|
|||
|
|
|
|||
|
|
| 参数 | 类型 | 必填 | 说明 |
|
|||
|
|
|-----|------|-----|------|
|
|||
|
|
| message | string | 是 | 用户输入原文 |
|
|||
|
|
| tenant_id | string | 是 | 租户 ID（系统自动注入） |
|
|||
|
|
| history | array | 否 | 会话历史（可选） |
|
|||
|
|
| top_n | integer | 否 | 返回建议数量（可选） |
|
|||
|
|
| context | object | 否 | 上下文字段（仅 routing_signal 字段会被消费） |
|
|||
|
|
|
|||
|
|
### 示例调用
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"message": "我想退款，但是也想先咨询下怎么处理",
|
|||
|
|
"top_n": 3,
|
|||
|
|
"context": {"order_status": "delivered", "channel": "web"}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 结果解释
|
|||
|
|
|
|||
|
|
关注输出中的以下字段：
|
|||
|
|
- `intent`: 识别出的意图
|
|||
|
|
- `confidence`: 置信度
|
|||
|
|
- `suggested_mode`: 建议的处理模式
|
|||
|
|
|
|||
|
|
**重要**: 该工具只提供建议，不做最终决策。
|
|||
|
|
|
|||
|
|
### 注意事项
|
|||
|
|
|
|||
|
|
1. tenant_id 由系统自动注入，模型不要填写
|
|||
|
|
2. context 中只有 routing_signal 角色的字段会被消费
|
|||
|
|
3. 该工具是轻量级的，不会执行复杂推理
|
|||
|
|
4. 结果应作为参考，最终决策由 policy_router 做出
|