删除我的偏好

注意

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

使用此功能移除个人布局偏好,恢复为组织或个人资料的默认设置。

它的作用是什么

助手通过其范围键移除你的一个个人布局偏好。 移除后,受影响的网格、表单或时间线会恢复为配置文件级配置(如果存在)、组织级配置或系统默认配置。 此举需确认。

试试像这样的提示

  • 移除我个人的箱子网格布局。
  • 重置了我保存的案件表格偏好。
  • 忘了我在时间线上的自定义。
  • 删除我对案件的偏好。

你在聊天中会看到的内容

助理在移除偏好前会先确认。 确认后,它会显示被移除的偏好。

有用的提示

  • 首先查看 list_user_prefs 你的活跃偏好设置及其范围键。
  • 移除是永久性的。 删除后,优先权无法恢复。
  • 只有你的个人偏好会受到影响。 组织级和配置文件级配置保持不变。

接下来会发生什么

  • 请显示我的偏好以验证删除情况。
  • 保存一个新偏好,创建替代的自定义。
  • 组织层面的配置是什么?看看你会退回什么。

这会改变数据吗?

是的,这可能会改变数据。

先决条件

该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 删除我的偏好
内部工具名称 delete_user_prefs
Purpose 通过作用波键移除个人布局偏好

工具行为

通过范围键消除个人布局偏好。 当用户请求删除自己保存的布局、重置个人偏好或忘记之前保存的自定义时,可以使用。 需要明确确认以防止意外删除。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具会修改数据。
destructiveHint true 该工具会永久移除偏好数据。
idempotentHint true 删除已移除的瞄准镜不会有额外影响。
openWorldHint 未设置 使用默认值。

输入概念

范围说明

输入 Description 必需
scope scope (字符串,必填)。 用于移除的示范键(例如, grid:incident:*)。 用 list_user_prefs 来查找现有的范围键。 是的

确认

输入 Description 必需
confirm、true confirm (字面意思 true,必修)。 必须明确设置为 以 true 确认删除。 是的

响应与用户界面行为

响应类型

仅文本

没有渲染任何交互组件。 返回确认偏好已被移除,或如果找不到范围键则返回错误。

路由注释

在以下情况下使用 delete_user_prefs:

  • 用户请求删除或重置个人偏好。
  • 用户说“忘了我的”、“重置我的”、“删除我的偏好”。
  • 如果用户没有指定作用域键,务必先呼叫 list_user_prefs 。

不要在以下情况下使用 delete_user_prefs :

  • 用户想移除组织层面的配置。 改用 delete_agent_config。
  • 用户希望移除配置文件级别的配置。 请改用delete_agent_config和scope: "profile"。
  • 用户想修改(而不是删除)某个偏好。 改用 save_user_prefs。
工具 关系
list_user_prefs 列出现有偏好以识别作用域键
save_user_prefs 创建或更新个人偏好
delete_agent_config 移除组织级或配置文件级配置

数据变异分类

写作(破坏性)。

永久移除当前用户的个人布局偏好。 不会影响其他用户或组织/配置文件配置。 助理在执行前会先确认。