适用于:Dynamics 365 Customer Service
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想直接在聊天中查看特定员工参与管理(WEM)请求的完整细节时,可以使用此功能。
它的作用是什么
助理会为一个WEM请求打开一张详细卡片。 它支持三种 WEM 请求类型,配有类型相应的标签和每种字段:
- 请假申请——请假类型,无论是整天、休假的开始和结束、工作时间和备注。
- 班次竞标请求——请求的状态、日期和审核信息。
- 换班请求——请求的状态、日期和审核信息。
通常你可以通过从WEM请求列表中选择一行来到达它。
试试像这样的提示
- 打开第一个请求。
- 请出示8月24日的休假申请。
- 查看本次换班。
- 打开选中的投标请求。
你在聊天中会看到的内容
助手会作为聊天应用组件显示互动请求卡。 卡片显示请求的详细信息和头部信息,如提交日期、最后更新时间、请求状态和所有者。
有用的提示
- 开启请求最简单的方法是选择WEM请求列表中的一行。
- 该表单是请求的聚焦视图,匹配其类型(休假、班次竞标或换班)——WEM 请求没有活动时间线,因此不显示活动时间线。
- 如果想先看到不同的请求,可以说类似“展示我本周的请假请求”。
Tip
请求表出现后,你可以提出后续问题,或返回列表打开另一个请求。
接下来会发生什么
申请表出现后,你可以继续使用以下提示:
- 回到名单上。
- 展示我正在批准的休假批准。
- 打开下一个请求。
这会改变数据吗?
不,查看请求不会改变数据。
请求表单是请求详情的只读视图。
你可以通过聊天应用组件做些什么
在聊天中的申请表中,你可以:
- 查看请求的详细信息,并根据其类型——请假请求的休假时间窗口、状态、日期,并审查投标或交换的信息。
- 查看请求状态和所有者等头信息。
- 继续在聊天中使用后续提示。
先决条件
该工具可在Dynamics 365 CX MCP服务器——劳动力参与管理中使用。 详情请参见本页顶部的可用性说明。 必须启用员工参与管理,且登录用户必须拥有 WEM 请求的读取权限。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 查看劳动力参与管理请求 |
| 内部工具名称 | get_wem_request_details |
| Purpose | 打开单一劳动力参与管理请求的完整视图(请假、班次竞标或班次交换) |
工具行为
打开单个Dataverse msdyn_wemrequest 记录的完整详细视图。 您可以通过 recordId (其GUID)或( requestName 其确切名称)来识别记录;当 recordId 省略时,工具会通过名称查找记录。 如果名字匹配多个请求,工具会以卡片列表显示匹配请求——这样你可以选择要打开的请求(它绝不猜);如果名字不匹配,则报告未找到请求。 一旦识别出一条记录,工具会读取请求类型,并生成一张只读的详细卡片,带有类型对应的标签和核心请求事实——如暂停请求的时间窗口,以及竞标或交换时可用的请求事实(状态、日期、审查信息)。 WEM请求没有活动,因此不会显示时间线。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用(只读工具)。 |
idempotentHint |
未设置 | 不适用(只读工具)。 |
openWorldHint |
未设置 | 使用默认值(查询Dataverse)。 |
输入概念
记录标识符
至少提供以下一项。 你可以同时提供:如果两者都存在,则 recordId 优先,只有 requestName 在省略时 recordId 才使用。 (例如,只要有行就从该行传递recordIdlist_wem_requests。)
| Input | 说明 | Required |
|---|---|---|
recordId |
WEM 请求 GUID 打开。 精准;只要有供应,就会获胜。 | 否* |
requestName |
具体的请求名称(msdyn_name例如,“周末代课交换”)。 用于在省略时解析记录 recordId 。 当名称匹配多个请求时,匹配请求会以卡片列表显示,方便你选择要打开的那一张;这里不支持基于代理的查找(用于 list_wem_requests 查找代理的请求)。 |
否* |
* 至少要求一项 recordId 或 requestName 。
响应与用户界面行为
该工具会生成互动式的聊天应用请求卡。
该 MCP 工具由 MCP 应用支持。
响应类型
交互式卡片(详细视图)
卡片显示请求的详细信息和头字段,匹配到请求类型。
路由注释
用于 get_wem_request_details :
- 打开此请求,显示休假请求,查看此班次调动,打开投标请求。
- 从WEM请求列表中钻入特定行。
不要在提示提示要求列出或浏览请求时使用 get_wem_request_details “route to list_wem_requests ”。
相关工具
| 工具 | 关系 |
|---|---|
list_wem_requests |
列出WEM请求;点击一行打开 |
数据变异分类
只读。
表单视图不会改变数据。