注意
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
使用此功能查看您对服务代理的个人布局偏好。
它的作用是什么
助手会列出你保存的所有个人布局偏好。 个人偏好允许你自定义网格、表单和时间线的呈现方式，而不会影响其他用户。
每个偏好设置条目显示范围、名称、布局补丁数量以及最后修改的时间。
试试像这样的提示
- 显示我保存的偏好设置。
- 我有哪些个人定制？
- 列出我的布局偏好。
- 展示我自定义的机箱网格设置。
你在聊天中会看到的内容
助手会显示你所有个人偏好的文本摘要，包括实体、范围和每个补丁数量。
有用的提示
- 个人偏好仅覆盖组织层级和个人资料层级的账户配置。
- 你的偏好会在会话和设备上保持不变。
- 使用该工具审核您的定制后再重置。
接下来会发生什么
- 保存一个新偏好设置，用于添加或更新个人布局。
- 删除我对案例网格的偏好，以移除特定的自定义选项。
- 展示组织层面的配置，看看默认布局是什么。
这会改变数据吗？
不，这不会改变数据。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 列出我的偏好 |
| 内部工具名称 | list_user_prefs |
| Purpose | 列出当前用户的所有个人布局偏好 |
工具行为
列出当前用户的所有个人布局偏好。 显示每个保存偏好的范围、名称、补丁数量和最后修改日期。 个人偏好在对话和设备中持续存在，使用户能够自定义自己的客服体验而不影响他人。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
实体过滤器
| 输入 | Description | 必需 |
|---|---|---|
entityLogicalName |
entityLogicalName （字符串，可选）。 提供后，只返回该实体的偏好。 省略列出所有个人偏好。 |
否 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回用户个人偏好的结构化列表，包括其作用域键、名称、音色数量和最后修改时间戳。
路由注释
在以下情况下使用 list_user_prefs：
- 用户询问自己保存的偏好或个人定制。
- 用户会说“我的偏好”、“我的布局”或“我的自定义”。
- 你需要在用户偏好删除操作前显示作用域键。
不要在以下情况下使用 list_user_prefs ：
- 用户询问组织层面的配置。 改用
list_agent_configs。 - 用户询问配置文件级别的配置。 请改用
list_agent_configs和scope: "profile"。 - 该用户是管理员，询问所有用户的偏好设置（不支持;每个用户只看到自己的偏好）。
相关工具
| 工具 | 关系 |
|---|---|
save_user_prefs |
省去了个人布局偏好 |
delete_user_prefs |
通过作用波键移除个人布局偏好 |
list_agent_configs |
列出组织级配置（管理员视图） |
browse_agent_config_options |
探索配置选项的互动指南 |
数据变异分类
只读。