注意
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,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 |
移除组织级或配置文件级配置 |
数据变异分类
写作(破坏性)。
永久移除当前用户的个人布局偏好。 不会影响其他用户或组织/配置文件配置。 助理在执行前会先确认。