Beisen Service Portal

---
name: beisen-service-portal
version: 3.2.1
description: "北森办事入口。本 Skill 用于根据用户自然语言输入，检索系统菜单并按意图匹配推荐功能入口，引导员工或管理者进入对应的业务办理页面。通过北森连接器的菜单检索工具搜索租户菜单库，以可点击 Markdown 链接形式输出菜单入口。当用户询问办事、办事入口、办理、业务入口、菜单、去哪办、功能入口位置、导航路径，或输入疑似功能/页面/报表/菜单的名称或描述时触发。本 Skill 涉及业务操作引导，非纯数据查询。员工和管理者均可使用。"
author: beisen
display_name: "北森办事入口"
display_name_en: "Beisen Service Portal"
description_zh: "北森办事入口。本 Skill 用于根据用户自然语言输入，检索系统菜单并按意图匹配推荐功能入口，引导员工或管理者进入对应的业务办理页面。通过北森连接器的菜单检索工具搜索租户菜单库，以可点击 Markdown 链接形式输出菜单入口。当用户询问办事、办事入口、办理、业务入口、菜单、去哪办、功能入口位置、导航路径，或输入疑似功能/页面/报表/菜单的名称或描述时触发。本 Skill 涉及业务操作引导，非纯数据查询。员工和管理者均可使用。"
description_en: "Beisen service portal. This Skill takes the user's natural-language input, searches system menus, matches intent to recommend feature entry points, and guides employees or managers to the corresponding service page. It searches the tenant's menu library via the Beisen connector's menu-search tool and outputs menu entries as clickable Markdown links. Trigger when the user asks about handling a service, service entry points, processing, business entry points, menus, where to handle something, the location of a feature entry, or navigation paths, or enters a name or description that looks like a feature/page/report/menu. This Skill involves guiding business operations, not pure data queries. Available to both employees and managers."
category: productivity
requires-skills:
  - beisen-shared
  - beisen-data-query
---

# 办事入口

**CRITICAL — 开始前 MUST 读取 [references/beisen-shared.md](references/beisen-shared.md)**

## 任务目标

- 根据用户自然语言输入，检索系统菜单并按意图匹配推荐功能入口
- 触发条件：用户询问功能入口位置、导航路径，表达业务操作意图，或输入疑似功能/菜单名称的文本（含 Agent 弱信号仲裁后的探测式路由）

> 说明：权限校验、匹配阈值过滤、终端适配均由后端菜单检索服务自动处理，返回结果均已过滤。菜单检索面向租户实时菜单库（含自定义视图与自定义页面），因此**不预设句式、不枚举关键词**，能否命中由检索证据决定。

## 路由优先级

本 Skill 处理：搜索并唤起 HR 业务操作菜单、引导用户进入业务办理页面

不归本 Skill 处理：
- 企业知识制度搜索 → [../beisen-knowledge/SKILL.md](../beisen-knowledge/SKILL.md)
- 具体业务数据的查询 → 各对应业务域 Skill 
- 审批查询 → [../beisen-approval/SKILL.md](../beisen-approval/SKILL.md)

## 工具的读取与加载

- **工具发现**：在北森连接器当前已注册的工具清单中，按名称与描述匹配"菜单检索/菜单搜索"类工具。
- **参数构造**：检索词传用户原始问题（可参考同义词表改写，提升命中率）；如工具 inputSchema 提供匹配阈值类参数，按其说明的推荐值传入。
- **结果解读**：返回为语义相近的菜单候选列表，通常含菜单名称、菜单描述（可能为空）、菜单跳转链接；实际字段以工具 outputSchema 与返回说明为准。

**同义词参考**（仅作检索改写的辅助手段，不承担路由职责；未列入的表达直接用原文检索）：
- "打卡" / "签到" → "考勤"
- "工资" / "薪水" → "薪资"
- "请假" / "休假" → "假期"
- "打开日程菜单" → "日程"

## 操作步骤

### 步骤零：意图预分类

在调用检索工具前，先判断用户意图类型：

| 意图类型 | 识别特征 | 处理方式 |
|---------|---------|---------|
| 导航意图 | "在哪看XX"、"XX在哪"、"打开XX"、"XX菜单" | 进入步骤一，入场方式记为**明确找入口** |
| 功能名意图 | 裸名词、短语、疑似功能/页面/报表/菜单的名称或描述性文本（如"我的目标""日报""周报"，及任意自定义菜单名/描述） | 进入步骤一，入场方式记为**探测式** |
| 操作意图 | "帮我请假"、"我要出差"、"申请加班"、"提交报销"、"修改银行卡"等，即用户表达要**执行某项业务操作**的意图 | 进入步骤一，入场方式记为**明确找入口** |
| 咨询意图 | "XX流程是什么"、"年假怎么算"、"离职政策" | 进入步骤一，有相关菜单则一并推荐；无则按入场方式退出（见步骤三） |

> 入场方式决定无命中时的退出行为：**明确找入口** → 输出兜底文案；**探测式** → 零输出静默退回（见步骤三）。若 Agent 已在弱信号仲裁中完成菜单检索探测并确认强命中后才路由进来，同样按探测式处理。

### 步骤一：调用菜单检索工具

以用户原始问题（或同义词改写后的检索词）调用菜单检索工具。调用失败或返回业务错误时进入步骤四。

### 步骤二：判断用户意图是否命中

返回菜单是语义相近的候选，需逐一判断是否真正符合用户意图：

- 结合用户问题和菜单名称、菜单描述判断
- 根据意图精度动态控制输出数量，上限 4 个：
  - 精确意图（单一功能）：1-2 个
  - 中等意图（一类功能）：2-3 个
  - 宽泛意图（一个领域）：最多 4 个
- 若无菜单命中意图，按步骤三的无命中分支处理

### 步骤三：输出结果

- **有命中** → 回复引导文案：`你可能需要操作：`，然后以 Markdown 链接列表输出命中的菜单：

  ```markdown
  - [菜单名称1](菜单链接1)
  - [菜单名称2](菜单链接2)
  ```

  **输出规则**：
  - 链接文本使用菜单名称，URL 使用菜单跳转链接；两者必须从工具返回中提取，严禁编造
  - 菜单描述非空时，可在链接后用括号补充简要描述，帮助用户判断
  - 示例：`- [日程](https://xxxx/xxx/oR352Sn1)（用于预定日程，员工也可查看自己和他人的日程）`

- **无命中**（检索为空或返回菜单均不符合意图），按入场方式分支：
  - **明确找入口**（用户明确询问入口/导航/操作）→ 输出兜底文案：`没找到这个入口，换个说法我再帮你看看？`
  - **探测式**（功能名意图/咨询意图/弱信号仲裁转入）→ **零输出静默退回**：不输出任何文案、解释或兜底语，由 Agent 按失败兜底链继续处理（知识查询/兜底）

### 步骤四：异常处理

若菜单检索调用失败（业务失败、超时、异常、返回格式错误等）：

1. 检测当前会话中是否有其他可用子技能（如 [../beisen-knowledge/SKILL.md](../beisen-knowledge/SKILL.md) 知识库检索、[references/beisen-data-query.md](references/beisen-data-query.md) 数据查询等）
2. 若有可用子技能 → 将用户原始问题转交对应子技能处理
3. 若无可替代 → 输出兜底文案：`没找到这个入口，换个说法我再帮你看看？`

## 多轮对话

当用户首次检索无命中后继续追问时，结合上下文补全检索词：

- 用户追问中省略主语或宾语时，从上一轮对话中提取并拼接
- 示例：用户先问"在哪看我的工资" → 无命中 → 追问"那出勤呢？" → 检索词补全为"在哪看我的出勤"

## 使用示例

### 示例 1：导航意图命中
- 输入：用户问"在哪里看工资条"
- 处理：以"在哪里看工资条"检索菜单 → 判断返回菜单命中意图
- 输出：`你可能需要操作：`+ `- [工资条](菜单链接)`

### 示例 2：操作意图命中（多菜单）
- 输入：用户说"我想打开文化激励"
- 处理：检索"文化激励" → 多个候选命中
- 输出：`- [文化激励](链接1)`、`- [文化激励管理](链接2)`

### 示例 3：操作意图命中（请假/出差/休假）
- 输入：用户说"帮我请个假" / "我要出差"
- 处理：意图分类为操作意图 → 检索原文 → 命中
- 输出：`- [请假申请](菜单链接)`

### 示例 4：功能名意图（裸名词）命中
- 输入：用户说"我的目标"（或"日报""周报"，或某自定义菜单的名称/描述文本）
- 处理：功能名意图 → 检索原文 → 返回菜单与输入语义一致，命中
- 输出：`- [我的目标](菜单链接)`

### 示例 5：咨询意图有相关菜单
- 输入：用户问"年假怎么算"
- 处理：检索 → 返回"假期余额""请假记录"菜单，与咨询内容相关，一并推荐

### 示例 6：明确找入口但无返回
- 输入：用户问"怎么修改银行卡信息"，检索返回空
- 输出：`没找到这个入口，换个说法我再帮你看看？`

### 示例 7：探测式入场无命中 → 静默退回
- 输入：用户说"月度总结"（功能名意图），检索返回空
- 处理：零输出静默退回，由 Agent 继续走知识查询/兜底；不输出"没找到入口"等任何文案

### 示例 8：多轮对话接续
- 第一轮：用户问"在哪看我的工资"（明确找入口）→ 无命中 → 输出兜底文案
- 第二轮：用户追问"那出勤呢？" → 检索词补全为"在哪看我的出勤" → 重新检索

### 示例 9：路由判断 — 数据查询非本 Skill 范围
- 输入：用户问"我的年假还有多少？"
- 处理：此为业务数据查询（非办事入口），应路由到 [../beisen-attendance-leave/SKILL.md](../beisen-attendance-leave/SKILL.md) / [references/beisen-data-query.md](references/beisen-data-query.md)，而非本 Skill

## 禁止事项

- 不得跳过菜单检索直接编造菜单或链接
- 不得修改后端返回的菜单标识或菜单链接
- 不得在无命中时输出菜单链接列表
- 不得强制输出菜单：意图不匹配时按入场方式输出兜底文案或静默退回
- 不得在探测式入场无命中时输出任何文案（必须零输出静默退回）
- 不得输出冗余的思考过程
- 菜单链接必须从工具返回中提取，严禁编造 URL

## 不在本 Skill 范围

- 企业知识制度搜索 → [../beisen-knowledge/SKILL.md](../beisen-knowledge/SKILL.md)
- 具体业务数据的查询 → 各对应业务域 Skill / [references/beisen-data-query.md](references/beisen-data-query.md)
- 审批查询 → [../beisen-approval/SKILL.md](../beisen-approval/SKILL.md)