注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
利用此功能保存个人布局偏好，自定义服务代理显示信息的方式。
它的作用是什么
助理会为你的账户保存个人布局偏好。 这让你可以自定义网格、表单或时间线的显示方式，而不会影响其他用户。 你的偏好会在对话和设备中持续存在。
个人偏好在配置栈中优先级最高，覆盖组织层和配置文件层的配置。
试试像这样的提示
- 记住我的箱子网格布局。
- 把这个当作我的偏好。
- 总是先给我看优先级栏。
- 保存我个人的案件表格布局。
- 设置我偏好的时间线筛选条件。
你在聊天中会看到的内容
助手会确认保存的个人偏好，包括实体、配置类型和变更摘要。
有用的提示
- 你的个人偏好优先于组织层级和个人资料层级的配置。
- 偏好设置会在所有会话和设备上持续存在。
- 在添加新偏好前，请先
list_user_prefs查看当前偏好。
接下来会发生什么
- 显示我的偏好以验证保存了什么。
- 删除我对案例网格的偏好，以移除自定义功能。
- 我可以配置什么？探索可用的选项。
这会改变数据吗？
是的，这可能会改变数据。
保存偏好设置会在Dataverse中写入或更新你的个人偏好记录。
只有你自己的偏好记录会受到影响。 它不会改变共享的组织层级或其他用户的设置。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 保存我的偏好 |
| 内部工具名称 | save_user_prefs |
| Purpose | 为当前用户保留个人布局偏好 |
工具行为
这样可以为当前用户保留个人布局偏好。 跨对话和设备持续存在，允许每个用户自定义自己的代理体验，而不影响其他用户或组织层级配置。 当用户说“记住这个”或“按我的偏好保存”时使用。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
创建或更新偏好设置，无需删除现有数据。 |
idempotentHint |
true |
同样的偏好保存二次，结果是一样的。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
目标实体
| 输入 | Description | 必需 |
|---|---|---|
entityLogicalName |
entityLogicalName （字符串，必填）。 要配置的实体（例如， incident， account）。 |
是的 |
覆盖类型
| 输入 | Description | 必需 |
|---|---|---|
overrideType |
overrideType （字符串，必填）。 配置示波器前缀：resolution， grid， form， form-sectionform-select， form-type， ， timeline， ， lookup， 。 picklist |
是的 |
目标 ID
| 输入 | Description | 必需 |
|---|---|---|
targetId、* |
targetId （字符串，默认为 *）。 一种特定的视图或表单 GUID，或者 * 适用于整个实体的。 |
否 |
修补程序
| 输入 | Description | 必需 |
|---|---|---|
patches |
patches （数组，必填）。 由 区分 type的有序补丁对象数组。 |
是的 |
显示名称
| 输入 | Description | 必需 |
|---|---|---|
name |
name （字符串，可选）。 这个偏好用的是人类易读的名字。 |
否 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 回应确认范围和有效优先权摘要。 回答还包括 propagationDelayMinutes——预估保存优先权生效的时间。
路由注释
在以下情况下使用 save_user_prefs：
- 用户会要求“为我保存”、“作为我的偏好”或“记住这个”。
- 定制是个人化的，不会影响其他用户。
- 用户没有组织管理员权限，但想要个人布局调整。
不要在以下情况下使用 save_user_prefs ：
- 用户是管理员，负责保存全组织的配置。 改用
save_agent_config。 - 用户指定配置文件。 请改用
save_agent_config和scope: "profile"。 - 用户正在探索各种选项。 先用
browse_agent_config_options。
相关工具
| 工具 | 关系 |
|---|---|
list_user_prefs |
列出现有的个人偏好 |
delete_user_prefs |
消除个人偏好 |
save_agent_config |
保存组织层级配置（仅管理员） |
browse_agent_config_options |
互动指南，帮助你发现可以配置的内容 |
数据变异分类
写。
仅为当前用户创建或更新个人布局偏好。 不会影响其他用户。