查看劳动力参与管理请求

适用于：Dynamics 365 Customer Service

注释

  • 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
  • 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
  • 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。

当你想在聊天中查看员工参与管理（WEM）请求——请假、换班和换班时，可以使用此功能而不离开对话。

它的作用是什么

助手会显示一系列符合你筛选条件的WEM请求。 它涵盖了所有三种请求类型——休假、换班和换班。 您可以按以下条件进行筛选：

  • 请求类型（休假、换班、换班竞标）。 只列出该类型;要求“所有请求”以查看所有类型。
  • 你自己的请求或团队的可访问请求。
  • 日期范围，以及该范围是针对请求的窗口还是创建的日期。
  • 请求状态（草稿、审核中、取消、批准、拒绝、待批准、接受、已履行、过期）。
  • 结果计数。

默认情况下，它会显示你可访问的所有请求，涵盖 所有日期和状态，涵盖各种类型。 添加类型、时间范围、状态或“我的请求”以缩小范围。 结果会显示在聊天中的互动列表中。

试试像这样的提示

  • 显示我所有待处理的请求（每种类型）。
  • 等待请假申请。
  • 我团队的开放班次调换。
  • 我这个月的班次竞标。
  • 显示我团队在八月的批准请求。

你在聊天中会看到的内容

助手作为聊天应用组件显示交互式请求列表。 该列表显示匹配请求，并包含姓名、代理、请求类型、状态和创建日期等关键细节。

有用的提示

  • 默认情况下，你会看到所有可访问的请求;说“我的请求”，这样可以缩小范围，只表达你自己的请求。
  • 添加时间范围，如“本周”、“下周”或“八月内”，以筛选所需日期，或输入“最近两周创建”以按提交日期筛选。
  • 添加状态词（如待定、批准或拒绝）以缩小列表;省略它以查看所有状态。

Tip

列表显示后，选择一行打开完整请求表单，或对显示的请求提出后续问题。

接下来会发生什么

列表出现后，你可以继续使用以下提示：

  • 打开第一个请求。
  • 只显示待批准。
  • 把这些给我的团队看吧。
  • 而是显示已批准的请求。

这会改变数据吗？

不，列表请求不会改变数据。

请求列表为只读。 从列表中选择请求会以表单视图打开其记录;列表本身不会修改数据。

你可以通过聊天应用组件做些什么

在聊天的请求列表中，你可以：

  • 扫描并查看匹配请求，并以可排序的网格进行审核。
  • 选择请求以打开其完整表单视图。
  • 继续在聊天中使用后续提示处理请求。

先决条件

该工具可在Dynamics 365 CX MCP服务器——劳动力参与管理中使用。 详情请参见本页顶部的可用性说明。 必须启用员工参与管理，且登录用户必须拥有 WEM 请求的读取权限。

工具摘要

资产 价值
面向用户的名称 查看劳动力参与管理请求
内部工具名称 list_wem_requests
Purpose 按请求类型、范围、状态和日期筛选员工参与管理请求（请假、班次调换、班次竞标），并以互动式网格式的聊天应用体验呈现

工具行为

列出当前Dataverse msdyn_wemrequest 的行。 当 requestType 省略时，工具返回 所有 请求类型（time-off、shift-swap、shift-bid）;提供后，会筛选到指定的类型。 当都没有 from 提供 和 时 to ，工具会应用无日期过滤器（所有日期），省 status 略时则无状态过滤（所有活跃状态）。 否则默认为 dateBasis: requested （提供日期范围的窗口字段过滤——不是默认日期范围）、 团队范围 （呼叫者可访问的所有请求）以及最多25个结果。 对于 scope: self，查询会过滤指向已登录用户（所有者）的行;对于默认 scope: team，它依赖 Dataverse 和 WEM 的安全，只返回调用者能读取的行。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

请求类型

输入 Description 必需
requestType 数 time_off组 ， shift_swap， ， shift_bid。 省略包含所有类型（例如，“显示所有请求”）;例如， ['time_off'] 只用于暂停时间，换 ['shift_swap'] 位。 否

Scope

输入 Description 必需
scope self 或 team。 默认 team——你能接触到的一切。 中立的“显示请求”返回所有可访问的请求;只有“我的 请求”会缩小到 self （你拥有的请求）。 否

Status

输入 Description 必需
status 数draft组 ， in_review， canceled， pending_approvalrejectedacceptedapprovedfulfilled， ， ， 。 expired 省略所有状态。 否

日期范围

输入 Description 必需
from、to 包含ISO 8601日期时间。 省略两者，以便应用无日期筛选（所有日期）;另一侧是一个开放的单一界限过滤器。 否
dateBasis requested 通过请求窗口筛选; created 通过提交请求的时间进行筛选。 默认值为 requested. 否

结果限制

输入 Description 必需
top 整数最大返回请求数。 默认是25，上限200。 否

响应与用户界面行为

该工具渲染一个交互式的聊天应用请求网格。

该 MCP 工具由 MCP 应用支持。

响应类型

交互式网格（列表视图）

网格显示姓名、代理、请求类型、状态和创建日期。 用户可以选择一行来打开请求的表单视图。

路由注释

用于 list_wem_requests ：

  • 我的请假申请、开放的班次调动、我的班次竞标（通过 requestType）。
  • 显示我所有的请求，以及团队待处理请求（→所有类型都省 requestType 略）。
  • 基于状态或日期的WEM请求过滤。

当提示要求提供案例、账户或其他非WEM记录时，不要使用 list_wem_requests 。

工具 关系
实体网格记录视图 选择行会在实体网格表单视图中打开请求记录。

数据变异分类

只读。

该列表不会改变数据;打开请求时，会以表单视图显示其记录。

  • 上次更新时间为