注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想查看组织或个人资料层面哪些工具是可见、隐藏或恢复的时,可以使用此功能。
它的作用是什么
该工具列出所选示波器的当前工具可见性设置。 它返回工具目录、已解析的隐藏集以及为组织或配置文件存储的原始可见性补丁。
试试像这样的提示
- 哪些工具是隐藏的?
- 为该组织展示工具可见性。
- 列表工具的可视化功能。
- 哪些工具被禁用了?
- 给我看看当前的工具选择。
你在聊天中会看到的内容
助手返回可见性状态的文本摘要,包括范围、工具名称以及当前隐藏或恢复状态。
有用的提示
- 用于
level: organization审查全组织的可见性。 - 用于
level: profile检查特定配置文件,并包含profileId。 - 该工具为只读。 用
save_tool_selection来做修改。
接下来会发生什么
- 隐藏该个人资料的邮件工具。
- 恢复隐藏工具。
- 将工具可见性重置为默认状态。
这会改变数据吗?
不,这不会改变数据。
它只读取当前的可见性配置。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 列表工具的可视化 |
| 内部工具名称 | list_tool_selection |
| Purpose | 列出所选组织或配置文件范围的当前工具可视化设置 |
工具行为
列出所选组织或配置文件范围的当前工具可见性设置。 返回完整的工具目录、已解析的隐藏集以及当前保存的原始可见性补丁。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不適用。 |
idempotentHint |
未设置 | 不適用。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
级别
| 输入 | Description | 必需 |
|---|---|---|
level、organization、profile |
level (organization 或 profile,必修)。 选择检查全组织或配置文件级可见性。 |
是的 |
配置文件 ID
| 输入 | Description | 必需 |
|---|---|---|
profileId |
profileId (UUID字符串,可选)。 当 level 是 profile 时为必需项。 |
多种多样 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回描述当前可见性状态的结构化文本,包括范围、工具名称以及隐藏或恢复状态。
路由注释
在以下情况下使用 list_tool_selection:
- 你需要确认哪些工具是隐藏的或可见的。
- 你要在更换前检查能见度。
- 你需要对刀具选择设置进行只读审核。
不要在以下情况下使用 list_tool_selection :
- 你已经知道自己想要做的具体改变。 改用
save_tool_selection。
相关工具
| 工具 | 关系 |
|---|---|
save_tool_selection |
节省可见性覆盖 |
delete_tool_selection |
清除可见性覆盖 |
browse_agent_config_options |
发现相关配置选项 |
数据变异分类
只读。
该工具只读取当前的可见性配置。