---
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 做出